Browser SDK
Типизированный JavaScript-клиент для AACsearch. Одиночный поиск, федеративный мульти-поиск, фасеты — p99 менее 50мс.
Поиск из браузера
NPM-пакет. TypeScript-типы. Работает в React, Vue, Svelte, Astro или чистом JS. Серверный прокси не нужен.
Полные TypeScript-типы
Автодополнение для каждого метода. Никаких догадок о форме ответов. Типы поставляются вместе с пакетом — @types/ не нужен.
Одиночный поиск
search(indexSlug, query, options) → типизированные результаты. Фасеты, фильтры, сортировка, пагинация — всё в объекте options.
Мульти-поиск (федеративный)
multiSearch([...queries]) → типизированный массив результатов. Один HTTP-запрос, параллельное выполнение, независимые фасеты.
Поддержка ограниченных токенов
Инициализируйте с краткосрочным ограниченным токеном с вашего сервера. SDK автоматически прикрепляет его к каждому запросу.
Типизированная обработка ошибок
Типизированные объекты ошибок со слагом (search_failed, quota_exceeded, rate_limited). Перехватывайте и обрабатывайте программно.
Менее 5КБ в сжатом виде
Сборка ESM с tree-shaking. В бандл попадают только импортируемые методы. Без зависимостей в рантайме.
Начать за 3 шага
Добавьте AACsearch на ваш сайт с помощью нескольких строк JavaScript.
- 1
Шаг 1
Установите пакет
Установите Browser SDK AACsearch из npm. npm install @aacsearch/browser-sdk
- 2
Шаг 2
Инициализируйте клиент
Создайте клиент с вашим scoped-токеном. import { AACSearchClient } from '@aacsearch/browser-sdk'; const client = new AACSearchClient({ token: 'ss_scoped_...' });
- 3
Шаг 3
Выполните поиск
Вызовите search() из вашего фронтенд-кода. const results = await client.search({ q: 'кроссовки', limit: 10 }); console.log(results.hits);
Часто задаваемые вопросы
Запустите Search OS за один вечер
Создайте индекс, добавьте документы и подключите поиск из приложения. Бесплатного тарифа достаточно для прототипа.