@ambicuity/kindx 0.1.0

package/dist/runtime.d.ts

@@ -0,0 +1,33 @@
+/**
+ * runtime.ts - Cross-runtime SQLite compatibility layer
+ *
+ * Provides a unified Database export that works under both Bun (bun:sqlite)
+ * and Node.js (better-sqlite3). The APIs are nearly identical — the main
+ * difference is the import path.
+ */
+export declare const isBun: boolean;
+/**
+ * Open a SQLite database. Works with both bun:sqlite and better-sqlite3.
+ */
+export declare function openDatabase(path: string): Database;
+/**
+ * Common subset of the Database interface used throughout QMD.
+ */
+export interface Database {
+    exec(sql: string): void;
+    prepare(sql: string): Statement;
+    loadExtension(path: string): void;
+    close(): void;
+}
+export interface Statement {
+    run(...params: any[]): {
+        changes: number;
+        lastInsertRowid: number | bigint;
+    };
+    get(...params: any[]): any;
+    all(...params: any[]): any[];
+}
+/**
+ * Load the sqlite-vec extension into a database.
+ */
+export declare function loadSqliteVec(db: Database): void;

package/dist/runtime.js

@@ -0,0 +1,34 @@
+/**
+ * runtime.ts - Cross-runtime SQLite compatibility layer
+ *
+ * Provides a unified Database export that works under both Bun (bun:sqlite)
+ * and Node.js (better-sqlite3). The APIs are nearly identical — the main
+ * difference is the import path.
+ */
+export const isBun = typeof globalThis.Bun !== "undefined";
+let _Database;
+let _sqliteVecLoad;
+if (isBun) {
+    // Dynamic string prevents tsc from resolving bun:sqlite on Node.js builds
+    const bunSqlite = "bun:" + "sqlite";
+    _Database = (await import(/* @vite-ignore */ bunSqlite)).Database;
+    const { getLoadablePath } = await import("sqlite-vec");
+    _sqliteVecLoad = (db) => db.loadExtension(getLoadablePath());
+}
+else {
+    _Database = (await import("better-sqlite3")).default;
+    const sqliteVec = await import("sqlite-vec");
+    _sqliteVecLoad = (db) => sqliteVec.load(db);
+}
+/**
+ * Open a SQLite database. Works with both bun:sqlite and better-sqlite3.
+ */
+export function openDatabase(path) {
+    return new _Database(path);
+}
+/**
+ * Load the sqlite-vec extension into a database.
+ */
+export function loadSqliteVec(db) {
+    _sqliteVecLoad(db);
+}

package/package.json

@@ -0,0 +1,90 @@
+{
+  "name": "@ambicuity/kindx",
+  "version": "0.1.0",
+  "description": "KINDX - On-device hybrid search engine for markdown documents with BM25, vector embeddings, and LLM reranking",
+  "type": "module",
+  "bin": {
+    "kindx": "dist/kindx.js"
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "prepare": "[ -d .git ] && ./tooling/install-hooks.sh || true",
+    "build": "tsc -p tsconfig.build.json && printf '#!/usr/bin/env node\n' | cat - dist/kindx.js > dist/kindx.tmp && mv dist/kindx.tmp dist/kindx.js && chmod +x dist/kindx.js",
+    "test": "vitest run --reporter=verbose specs/",
+    "kindx": "tsx engine/kindx.ts",
+    "index": "tsx engine/kindx.ts index",
+    "vector": "tsx engine/kindx.ts vector",
+    "search": "tsx engine/kindx.ts search",
+    "vsearch": "tsx engine/kindx.ts vsearch",
+    "rerank": "tsx engine/kindx.ts rerank",
+    "inspector": "npx @modelcontextprotocol/inspector tsx engine/kindx.ts mcp",
+    "release": "./tooling/release.sh"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambicuity/KINDX.git"
+  },
+  "homepage": "https://github.com/ambicuity/KINDX#readme",
+  "bugs": {
+    "url": "https://github.com/ambicuity/KINDX/issues"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.1",
+    "better-sqlite3": "^11.0.0",
+    "fast-glob": "^3.3.0",
+    "node-llama-cpp": "^3.17.1",
+    "picomatch": "^4.0.0",
+    "sqlite-vec": "^0.1.7-alpha.2",
+    "yaml": "^2.8.2",
+    "zod": "^4.2.1"
+  },
+  "optionalDependencies": {
+    "sqlite-vec-darwin-arm64": "^0.1.7-alpha.2",
+    "sqlite-vec-darwin-x64": "^0.1.7-alpha.2",
+    "sqlite-vec-linux-arm64": "^0.1.7-alpha.2",
+    "sqlite-vec-linux-x64": "^0.1.7-alpha.2",
+    "sqlite-vec-windows-x64": "^0.1.7-alpha.2"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^25.3.5",
+    "@types/picomatch": "^4.0.2",
+    "@types/yaml": "^1.9.6",
+    "tsx": "^4.0.0",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "keywords": [
+    "markdown",
+    "search",
+    "fts",
+    "full-text-search",
+    "vector",
+    "semantic-search",
+    "sqlite",
+    "bm25",
+    "embeddings",
+    "rag",
+    "mcp",
+    "reranking",
+    "knowledge-base",
+    "local-ai",
+    "llm",
+    "on-device",
+    "document-search"
+  ],
+  "author": "Ritesh Rana <contact@riteshrana.engineer>",
+  "license": "MIT"
+}