Skip to content

SDK de navegador

Un cliente JavaScript tipado para AACsearch. Búsqueda simple, multi-search federada, facetas — menos de 50 ms p99.

Búsqueda desde el navegador

Paquete NPM. Tipos TypeScript. Funciona en React, Vue, Svelte, Astro o JS puro. Sin proxy backend requerido.

Tipos TypeScript completos

Autocompletado en cada método. Sin adivinar las formas de respuesta. Los tipos vienen con el paquete — no se necesita @types/.

Búsqueda simple

search(indexSlug, query, options) → resultados tipados. Facetas, filtros, orden, paginación — todo en el objeto options.

Multi-search (federada)

multiSearch([...queries]) → array de resultados tipados. Una sola petición HTTP, ejecución paralela, facetas independientes.

Soporte de scoped tokens

Inicializa con un scoped token de corta duración desde tu servidor. El SDK lo adjunta automáticamente a cada petición.

Manejo de errores tipado

Objetos de error tipados con slug (search_failed, quota_exceeded, rate_limited). Captura y gestiona de forma programática.

Menos de 5 KB comprimido

Build ESM con tree-shaking. Solo los métodos que importas se incluyen en el bundle. Sin dependencias en tiempo de ejecución.

Comenzar en 3 pasos

Agrega AACsearch a tu sitio web con unas pocas líneas de JavaScript.

  1. 1

    Paso 1

    Instala el paquete

    Instala el Browser SDK de AACsearch desde npm. npm install @aacsearch/browser-sdk

  2. 2

    Paso 2

    Inicializa el cliente

    Crea un cliente con tu token de alcance limitado. import { AACSearchClient } from '@aacsearch/browser-sdk'; const client = new AACSearchClient({ token: 'ss_scoped_...' });

  3. 3

    Paso 3

    Ejecuta una búsqueda

    Llama a search() desde tu código frontend. const results = await client.search({ q: 'zapatos', limit: 10 }); console.log(results.hits);

Preguntas frecuentes

Lanza el Search OS en una tarde

Crea un índice, añade documentos y conecta la búsqueda desde tu app. El plan gratuito cubre un prototipo — los datos se mantienen al actualizar.