Early release — APIs are stabilizing but may still change between minor versions.
A search proxy framework for Typesense with caching, rate limiting, a BullMQ ingestion queue, and headless React components.
npx @tsproxy/cli init
docker compose up -d
npx tsproxy dev| Package | Description |
|---|---|
@tsproxy/cli |
CLI — init, dev, start, migrate, seed, health |
@tsproxy/api |
HonoJS proxy server with search, ingest, caching, rate limiting |
@tsproxy/js |
InstantSearch-compatible searchClient adapter |
@tsproxy/react |
Headless React components with BaseUI-style overrides |
- Search proxy — InstantSearch-compatible multi-search endpoint
- LRU cache — configurable TTL, error-aware (never caches failures)
- Rate limiting — per-IP, configurable per endpoint
- Ingestion queue — BullMQ (Redis) with in-memory fallback
- Computed fields — transform documents during ingestion
- Headless React components — every sub-element overridable via
overridesprop - SSR —
getServerState+InstantSearchSSRProviderfor server-rendered search - URL sync — search state syncs to URL params
- Multilingual — locale-aware collection routing
- CLI —
tsproxy init,tsproxy dev,tsproxy migrate,tsproxy seed - Config file —
tsproxy.config.tswithdefineConfig
pnpm install
docker compose up -d
pnpm seed
pnpm devMIT