IGNIS

Appearance

Changelog - 2026-07-08 ​

New Feature Breaking Change

In one line. The Typesense connector now supports vector/semantic and hybrid search, federated and union multi-search across collections, and declarative synonyms. All of it is reachable through one unified search({ mode }) method.

The problem it solves ​

The Typesense connector shipped on 2026-07-05 with keyword search only. Vector search, cross-collection queries, and synonyms had no typed path - each meant dropping to the raw Typesense client.

search() now models all of them through one discriminated method:

typescript
await articleRepository.search({
  mode: 'semantic',
  vectorField: 'embedding',
  queryText: 'wireless earbuds',
});

What changed ​

  • Unified search({ mode }). One repository method discriminated by mode: keyword (full-text), semantic (vector), hybrid (blended), and raw (native passthrough). It replaces many specialized methods with a single, typed, OpenAPI-generated schema.
  • Vector fields, both embedding modes. field.vector('embedding', ...) in the collection DSL. Supply dimensions + distance for client-provided vectors, or embed: { from, model } to have Typesense generate the vector at index time. No external embedding pipeline is required.
  • Cross-collection multiSearch. dataSource.multiSearch({ searches, union?, commonParams?, options? }) runs federated by default - side-by-side results per collection. Pass union: true to merge into one ranked set instead.
  • Declarative synonyms. synonyms: [{ id, synonyms, root? }] on defineSearchCollection, provisioned automatically at configure(). Multi-way synonyms (no root) make every listed term interchangeable. One-way synonyms (root set) expand a root query to its synonyms.
  • defineSearchController factory. Generates a POST /search and POST /multi-search endpoint from a repository, mirroring the existing CRUD controller factory. Each endpoint is customizable, or can be disabled.
  • Capabilities model. getCapabilities() now reports search: { vector, multi, union, synonyms }. Calling code can use it to probe what the connected engine supports at runtime.
  • Extended search parameters. Faceting, highlighting, grouping, and result-tuning fields are now accepted as optional camelCase fields on every non-raw mode. IGNIS maps them to Typesense's snake_case wire names automatically.
  • Raw escape hatches, everywhere. Use search({ mode: 'raw', params }) for native single-collection params, getConnector().multiSearch(...) for native multi-search, and getClient() for the underlying Typesense client.
  • Any engine feature the typed API doesn't model is still reachable this way.

Who is affected ​

  • Anyone using Typesense search. Vector/semantic search, multi-search, synonyms, and the controller factory are all new and opt-in - no action needed to keep existing keyword search working.
  • Anyone who adopted the raw search({ params }) passthrough introduced on 2026-07-05. The call now requires mode: 'raw' - see Breaking changes below.
  • Everyone else. No action needed.

Breaking changes ​

1. Raw search now requires mode: 'raw' ​

search() is a single method discriminated by a required mode field. A bare search({ params }) call - the shape introduced on 2026-07-05 - no longer type-checks.

Before

typescript
const result = await articleRepository.search({ params: { q: 'typescript', query_by: ['title'] } });

After

typescript
const result = await articleRepository.search({ mode: 'raw', params: { q: 'typescript', query_by: ['title'] } });

Details ​

  • No engine lock-in in the base layer. All new verbs sit on neutral contracts (ISearchConnector, ISearchQueryDialect, the search() mode union) with engine-agnostic shapes. A second search engine can slot in later without touching src/base.
  • Vector search and prefix matching don't mix. semantic and hybrid default to prefix: false, since prefix matching is meaningless for vector search. Remote embedders (OpenAI, Google, ...) reject it outright. Callers can still override via the prefix field.
  • Synonyms use the v30+ global synonym-sets model - one Typesense synonym set per collection, linked at configure(). Runtime management is available via the connector (upsertSynonymSet / getSynonymSet / listSynonymSets / deleteSynonymSet / linkSynonymSets).
  • No sync guarantees. No retry, circuit-breaker, or change-data-capture is built into the framework - keeping the database and the search index in sync remains caller policy.

See also ​