feat: deprecate search() function and update version to 2.0.2

Author: sbrsv

README.md

@@ -33,7 +33,7 @@
 - 🔁 **Query expansion** — improve recall for vague searches
 - 🤝 **Find similar items** — easy recommendation / related content
 - 🌐 **Fully offline** via [`@xenova/transformers`](https://github.com/xenova/transformers.js) (WASM/Node) — no cloud, no API keys needed
-- ☁ **Optional OpenAI embeddings** — switch to `text-embedding-3-small` or others with one line of config
+- ☁ **Optional OpenAI embeddings** — `text-embedding-3-small` or others with one line of config
 - 🖥 **CLI-ready architecture** — easily wrap into command-line tools or scripts
 
 ---

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-embed-search",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "type": "module",
   "description": "Smart. Simple. Local. AI-powered semantic search in TypeScript using transformer embeddings. No cloud, no API keys — 100% offline.",
   "author": "Peter Sibirtsev <sibirtsev.peter@gmail.com>",

src/core/engine.ts

@@ -98,7 +98,16 @@ export async function loadEmbeds(filePath: string): Promise<void> {
     }
 }
 
+let warnedSearchDeprecated = false;
+
 export function search(query: string, maxItems = 5) {
+    if (!warnedSearchDeprecated) {
+        console.warn(
+            '[ai-embed-search] `search()` is deprecated. Use `searchV2()` for better results (cosine | softmax | mmr, filters).'
+        );
+        warnedSearchDeprecated = true;
+    }
+
     let filterFn: (result: SearchResult) => boolean = () => true;
 
     const runSearch = async (): Promise<SearchResult[]> => {