Orama full-text search over in-memory documents: working versions (tested 2026-10-15)

{
  "name": "orama-fulltext-search",
  "private": true,
  "type": "module",
  "scripts": {
    "test": "node --import tsx --test test/*.test.ts"
  },
  "dependencies": {
    "@orama/orama": "3.1.18"
  },
  "devDependencies": {
    "@types/node": "26.6.5",
    "tsx": "4.23.15"
  }
}

import { create, insert, search } from "@orama/orama";

export type Doc = { id: string; title: string; body: string };

export async function buildIndex(docs: Doc[]) {
  const db = await create({
    schema: {
      id: "string",
      title: "string",
      body: "string",
    } as const,
  });
  for (const doc of docs) await insert(db, doc);
  return db;
}

export async function find(db: Awaited<ReturnType<typeof buildIndex>>, term: string) {
  const result = await search(db, { term, properties: ["title", "body"] });
  return result.hits.map((h) => h.document as Doc);
}

import { test } from "node:test";
import assert from "node:assert/strict";
import { buildIndex, find } from "../src/search.ts";

test("indexes and finds by title term", async () => {
  const db = await buildIndex([
    { id: "1", title: "Alpine hiking boots", body: "Waterproof trail shoes" },
    { id: "2", title: "Kitchen blender", body: "High speed smoothie maker" },
  ]);
  const hits = await find(db, "hiking");
  assert.equal(hits.length, 1);
  assert.equal(hits[0].id, "1");
});

test("finds body matches", async () => {
  const db = await buildIndex([
    { id: "a", title: "Mixer", body: "smoothie maker for fruit" },
    { id: "b", title: "Saw", body: "wood cutting tool" },
  ]);
  const hits = await find(db, "smoothie");
  assert.equal(hits.length, 1);
  assert.equal(hits[0].id, "a");
});