@tsproxy/api

HonoJS proxy server for Typesense with caching, rate limiting, and a BullMQ ingestion queue.

This project is in early release — APIs are stabilizing.

Install

npm install @tsproxy/api

Usage

Create a tsproxy.config.ts:

import { defineConfig } from "@tsproxy/api";

export default defineConfig({
  typesense: {
    host: "localhost",
    port: 8108,
    apiKey: "your-api-key",
  },
  server: { port: 3000, apiKey: "your-ingest-secret" },
  cache: { ttl: 60, maxSize: 1000 },
  queue: { concurrency: 5, maxSize: 10000 },
  rateLimit: { search: 100, ingest: 30 },
  collections: {
    products: {
      fields: {
        name: { type: "string", searchable: true },
        price: { type: "float", sortable: true },
        category: { type: "string", facet: true },
      },
    },
  },
});

Endpoints

| Method | Path | Auth | Description | |--------|------|------|-------------| | POST | /api/search | No | InstantSearch-compatible multi-search | | GET | /api/health | No | Health check (Typesense + Redis) | | POST | /api/ingest/:collection/documents | Yes | Upsert document | | POST | /api/ingest/:collection/documents/import | Yes | Bulk import | | PATCH | /api/ingest/:collection/documents/:id | Yes | Partial update | | DELETE | /api/ingest/:collection/documents/:id | Yes | Delete document | | GET | /api/ingest/queue/status | Yes | Queue stats |

Features

• LRU cache with configurable TTL (error-aware — never caches failures)
• Per-IP rate limiting
• BullMQ queue (Redis) with in-memory fallback
• Computed fields during ingestion
• Multilingual collection routing
• Config file with defineConfig

Documentation

tsproxy.akshit.io

License

MIT