@nhtio/adk 1.20260604.0 → 1.20260607.0

package/batteries/vector/arangodb.mjs

@@ -0,0 +1,255 @@
+import { s as isInstanceOf } from "../../tool_registry-D1pSSlsd.mjs";
+import "../../guards.mjs";
+import { evaluateFilter } from "./filters.mjs";
+import { E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED } from "./exceptions.mjs";
+import { BaseVectorStore } from "./contract.mjs";
+import { validateRecords } from "./validation.mjs";
+//#region src/batteries/vector/arangodb/index.ts
+/**
+* @module @nhtio/adk/batteries/vector/arangodb
+*
+* ArangoDB adapter (experimental vector index, 3.12.4+). Each collection is an ArangoDB
+* document collection keyed by `_key`; a `vector` index on `vec` enables KNN via
+* `APPROX_NEAR_COSINE` / `APPROX_NEAR_L2`. Metadata is a JSON string attribute filtered with
+* the neutral filter tree's JS reference evaluator for exact cross-adapter parity.
+*
+* Driver: `arangojs` (pure JS). Requires the server started with
+* `--experimental-vector-index=true`. All values are passed as AQL bind parameters.
+*/
+var getArango = async () => {
+	try {
+		return await import("arangojs");
+	} catch {
+		throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(["arangojs"]);
+	}
+};
+var ArangoDBVectorStore = class extends BaseVectorStore {
+	capabilities = {
+		transactions: false,
+		namedVectors: false,
+		rename: false,
+		rawSql: false,
+		builtInEncoding: false,
+		consistency: {
+			configurable: false,
+			default: "strong",
+			modes: ["strong"]
+		}
+	};
+	#db = null;
+	#aql = null;
+	#dims = /* @__PURE__ */ new Map();
+	#indexed = /* @__PURE__ */ new Set();
+	get #opts() {
+		return this.options;
+	}
+	static isAvailable() {
+		return typeof process !== "undefined";
+	}
+	isAvailable() {
+		return typeof process !== "undefined";
+	}
+	async connect() {
+		if (this.#db) return;
+		const arango = await getArango();
+		this.#aql = arango.aql;
+		const c = this.#opts.connection;
+		const dbName = c.database ?? "vector";
+		try {
+			const auth = c.username ? {
+				username: c.username,
+				password: c.password ?? ""
+			} : void 0;
+			const sys = new arango.Database({
+				url: c.url,
+				auth
+			});
+			if (!await sys.listDatabases().then((dbs) => dbs.includes(dbName))) await sys.createDatabase(dbName);
+			this.#db = new arango.Database({
+				url: c.url,
+				databaseName: dbName,
+				auth
+			});
+		} catch (err) {
+			throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)]);
+		}
+	}
+	async close() {
+		this.#db = null;
+		this.#aql = null;
+	}
+	async #ensure() {
+		if (!this.#db) await this.connect();
+		return this.#db;
+	}
+	async createCollection(spec, ifNotExists) {
+		const db = await this.#ensure();
+		this.#dims.set(spec.collection, spec.vector.dimensions);
+		try {
+			const col = db.collection(spec.collection);
+			if (await col.exists() && !ifNotExists) {
+				await col.drop();
+				this.#indexed.delete(spec.collection);
+			}
+			if (!await col.exists()) {
+				await col.create();
+				this.#indexed.delete(spec.collection);
+			}
+		} catch (err) {
+			throw new E_VECTOR_STORE_COLLECTION_FAILED(["createCollection", String(err)]);
+		}
+	}
+	async #ensureVectorIndex(collection) {
+		if (this.#indexed.has(collection)) return;
+		const col = (await this.#ensure()).collection(collection);
+		const metric = this.#opts.metric ?? "cosine";
+		const dim = this.#dims.get(collection) ?? this.#opts.dimensions;
+		if (dim === void 0) return;
+		try {
+			await col.ensureIndex({
+				type: "vector",
+				fields: ["vec"],
+				params: {
+					metric: metric === "euclidean" ? "l2" : "cosine",
+					dimension: dim,
+					nLists: this.#opts.connection.nLists ?? 1
+				}
+			});
+			this.#indexed.add(collection);
+		} catch {}
+	}
+	async dropCollection(collection, ifExists) {
+		const db = await this.#ensure();
+		try {
+			const col = db.collection(collection);
+			if (await col.exists()) await col.drop();
+			else if (!ifExists) throw new Error("collection not found: " + collection);
+			this.#dims.delete(collection);
+		} catch (err) {
+			throw new E_VECTOR_STORE_COLLECTION_FAILED(["dropCollection", String(err)]);
+		}
+	}
+	async hasCollection(collection) {
+		const db = await this.#ensure();
+		try {
+			return await db.collection(collection).exists();
+		} catch {
+			return false;
+		}
+	}
+	async renameCollection(_from, _to) {
+		throw new E_VECTOR_STORE_UNSUPPORTED_OPERATION(["renameCollection", "arangodb"]);
+	}
+	async executeUpsert(plan) {
+		if (plan.records.length === 0) return;
+		validateRecords(plan.records);
+		const db = await this.#ensure();
+		const expected = this.#opts.dimensions ?? this.#dims.get(plan.collection);
+		try {
+			const col = db.collection(plan.collection);
+			for (const r of plan.records) {
+				let vector = r.vector;
+				if (!vector && r.document) {
+					const [v] = await this.encode([r.document], "document");
+					vector = v;
+				}
+				if (!vector) throw new E_VECTOR_STORE_UPSERT_FAILED(["Record missing vector and document"]);
+				if (expected !== void 0 && vector.length !== expected) throw new E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length]);
+				const doc = {
+					_key: r.id,
+					vec: vector,
+					document: r.document ?? "",
+					metadata: r.metadata ? JSON.stringify(r.metadata) : "{}"
+				};
+				await col.save(doc, { overwriteMode: "replace" });
+			}
+			await this.#ensureVectorIndex(plan.collection);
+		} catch (err) {
+			if (isInstanceOf(err, "E_VECTOR_STORE_DIMENSION_MISMATCH", E_VECTOR_STORE_DIMENSION_MISMATCH) || isInstanceOf(err, "E_VECTOR_STORE_UPSERT_FAILED", E_VECTOR_STORE_UPSERT_FAILED)) throw err;
+			throw new E_VECTOR_STORE_UPSERT_FAILED([String(err)]);
+		}
+	}
+	async executeSearch(plan) {
+		const db = await this.#ensure();
+		const aql = this.#aql;
+		const metric = this.#opts.metric ?? "cosine";
+		let queryVector;
+		if (plan.near) {
+			if ("vector" in plan.near) queryVector = plan.near.vector;
+			else if ("serverText" in plan.near) {
+				const [v] = await this.encode([plan.near.serverText], "query");
+				queryVector = v;
+			} else if ("id" in plan.near) {
+				const col = db.collection(plan.collection);
+				try {
+					queryVector = (await col.document(plan.near.id)).vec;
+				} catch {
+					throw new E_VECTOR_STORE_SEARCH_FAILED(["Referenced id not found: " + plan.near.id]);
+				}
+			}
+		}
+		const offset = plan.offset ?? 0;
+		try {
+			let rows;
+			if (queryVector) {
+				const useL2 = metric === "euclidean";
+				const fn = useL2 ? "L2_DISTANCE" : "COSINE_SIMILARITY";
+				const dir = useL2 ? "ASC" : "DESC";
+				const k = plan.filter ? 1e5 : plan.topK + offset;
+				const query = `FOR d IN @@col LET __score = ${fn}(d.vec, @qv) SORT __score ${dir} LIMIT @k RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata, score: __score }`;
+				rows = await (await db.query(query, {
+					"@col": plan.collection,
+					"qv": queryVector,
+					k
+				})).all();
+				return (plan.filter ? rows.filter((row) => evaluateFilter(plan.filter, this.#parseMeta(row.metadata))) : rows).slice(offset, offset + plan.topK).map((row) => this.#project(row, plan, true));
+			} else {
+				rows = await (await db.query(aql`FOR d IN ${db.collection(plan.collection)} RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata }`)).all();
+				return (plan.filter ? rows.filter((row) => evaluateFilter(plan.filter, this.#parseMeta(row.metadata))) : rows).slice(offset, offset + plan.topK).map((row) => this.#project(row, plan, false));
+			}
+		} catch (err) {
+			throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)]);
+		}
+	}
+	#parseMeta(val) {
+		if (typeof val === "string") try {
+			return JSON.parse(val);
+		} catch {
+			return {};
+		}
+		if (val && typeof val === "object") return val;
+		return {};
+	}
+	#project(row, plan, isKnn) {
+		const proj = plan.projection;
+		const out = {};
+		if (proj.id) out.id = row.id;
+		if (proj.vector && Array.isArray(row.vec)) out.vector = row.vec.map(Number);
+		if (proj.document) out.document = row.document ?? void 0;
+		if (proj.metadata) out.metadata = this.#parseMeta(row.metadata);
+		if (isKnn && row.score !== void 0 && row.score !== null) out.score = (this.#opts.metric ?? "cosine") === "euclidean" ? 1 / (1 + Number(row.score)) : Number(row.score);
+		return out;
+	}
+	async executeDelete(plan) {
+		const db = await this.#ensure();
+		const aql = this.#aql;
+		try {
+			const col = db.collection(plan.collection);
+			if (plan.ids && plan.ids.length > 0) await col.removeAll(plan.ids).catch(async () => {
+				for (const id of plan.ids) await col.remove(id).catch(() => void 0);
+			});
+			else if (plan.filter) {
+				const targets = (await (await db.query(aql`FOR d IN ${col} RETURN { id: d._key, metadata: d.metadata }`)).all()).filter((row) => evaluateFilter(plan.filter, this.#parseMeta(row.metadata))).map((row) => row.id);
+				if (targets.length > 0) await col.removeAll(targets).catch(async () => {
+					for (const id of targets) await col.remove(id).catch(() => void 0);
+				});
+			} else await col.truncate();
+		} catch (err) {
+			throw new E_VECTOR_STORE_DELETE_FAILED([String(err)]);
+		}
+	}
+};
+//#endregion
+export { ArangoDBVectorStore };
+
+//# sourceMappingURL=arangodb.mjs.map

package/batteries/vector/arangodb.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"arangodb.mjs","names":["#opts","#db","#aql","#ensure","#dims","#indexed","#ensureVectorIndex","#parseMeta","#project"],"sources":["../../../src/batteries/vector/arangodb/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/arangodb\n *\n * ArangoDB adapter (experimental vector index, 3.12.4+). Each collection is an ArangoDB\n * document collection keyed by `_key`; a `vector` index on `vec` enables KNN via\n * `APPROX_NEAR_COSINE` / `APPROX_NEAR_L2`. Metadata is a JSON string attribute filtered with\n * the neutral filter tree's JS reference evaluator for exact cross-adapter parity.\n *\n * Driver: `arangojs` (pure JS). Requires the server started with\n * `--experimental-vector-index=true`. All values are passed as AQL bind parameters.\n */\n\nimport { evaluateFilter } from '../filters'\nimport { BaseVectorStore } from '../contract'\nimport { validateRecords } from '../validation'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport {\n  E_VECTOR_STORE_DRIVER_UNAVAILABLE,\n  E_VECTOR_STORE_CONNECTION_FAILED,\n  E_VECTOR_STORE_COLLECTION_FAILED,\n  E_VECTOR_STORE_UPSERT_FAILED,\n  E_VECTOR_STORE_SEARCH_FAILED,\n  E_VECTOR_STORE_DELETE_FAILED,\n  E_VECTOR_STORE_DIMENSION_MISMATCH,\n  E_VECTOR_STORE_UNSUPPORTED_OPERATION,\n} from '../exceptions'\nimport type { SearchPlan, UpsertPlan, DeletePlan, CollectionSpec } from '../plan'\nimport type {\n  VectorMatch,\n  VectorStoreCapabilities,\n  BaseVectorStoreOptions,\n  VectorMetadata,\n} from '../types'\n\nexport interface ArangoDBVectorStoreOptions extends BaseVectorStoreOptions {\n  connection: {\n    url: string\n    username?: string\n    password?: string\n    database?: string\n    nLists?: number\n  }\n}\n\nconst getArango = async () => {\n  try {\n    const mod = await import('arangojs')\n    return mod\n  } catch {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['arangojs'])\n  }\n}\n\nexport class ArangoDBVectorStore extends BaseVectorStore {\n  readonly capabilities: VectorStoreCapabilities = {\n    transactions: false,\n    namedVectors: false,\n    rename: false,\n    rawSql: false,\n    builtInEncoding: false,\n    // Document writes are synchronous (visible on resolve). The option is a no-op.\n    consistency: { configurable: false, default: 'strong', modes: ['strong'] },\n  }\n\n  #db: any | null = null\n  #aql: any | null = null\n  #dims: Map<string, number> = new Map()\n  // ArangoDB's IVF vector index can't be created on an empty collection (\"not ready\") and\n  // needs nLists <= doc count. We therefore create the index lazily after the first upsert.\n  #indexed: Set<string> = new Set()\n\n  get #opts(): ArangoDBVectorStoreOptions {\n    return this.options as ArangoDBVectorStoreOptions\n  }\n\n  static isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n  isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  async connect(): Promise<void> {\n    if (this.#db) return\n    const arango = await getArango()\n    this.#aql = arango.aql\n    const c = this.#opts.connection\n    const dbName = c.database ?? 'vector'\n    try {\n      const auth = c.username ? { username: c.username, password: c.password ?? '' } : undefined\n      const sys = new arango.Database({ url: c.url, auth })\n      const exists = await sys.listDatabases().then((dbs: string[]) => dbs.includes(dbName))\n      if (!exists) {\n        await sys.createDatabase(dbName)\n      }\n      this.#db = new arango.Database({ url: c.url, databaseName: dbName, auth })\n    } catch (err) {\n      throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)])\n    }\n  }\n\n  async close(): Promise<void> {\n    this.#db = null\n    this.#aql = null\n  }\n\n  async #ensure(): Promise<any> {\n    if (!this.#db) await this.connect()\n    return this.#db!\n  }\n\n  async createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void> {\n    const db = await this.#ensure()\n    this.#dims.set(spec.collection, spec.vector.dimensions)\n    try {\n      const col = db.collection(spec.collection)\n      const exists = await col.exists()\n      if (exists && !ifNotExists) {\n        await col.drop()\n        this.#indexed.delete(spec.collection)\n      }\n      if (!(await col.exists())) {\n        await col.create()\n        this.#indexed.delete(spec.collection)\n      }\n      // The vector index is created lazily on first upsert (see #ensureVectorIndex): ArangoDB\n      // rejects creating it on an empty collection (\"vector index not ready\").\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['createCollection', String(err)])\n    }\n  }\n\n  // Create the IVF vector index once the collection has data (idempotent per collection).\n  async #ensureVectorIndex(collection: string): Promise<void> {\n    if (this.#indexed.has(collection)) return\n    const db = await this.#ensure()\n    const col = db.collection(collection)\n    const metric = this.#opts.metric ?? 'cosine'\n    const dim = this.#dims.get(collection) ?? this.#opts.dimensions\n    if (dim === undefined) return\n    try {\n      await col.ensureIndex({\n        type: 'vector',\n        fields: ['vec'],\n        params: {\n          metric: metric === 'euclidean' ? 'l2' : 'cosine',\n          dimension: dim,\n          nLists: this.#opts.connection.nLists ?? 1,\n        },\n      })\n      this.#indexed.add(collection)\n    } catch {\n      // If it still isn't ready (too few docs), leave it; executeSearch falls back to a\n      // brute-force AQL scan so correctness holds regardless of the index.\n    }\n  }\n\n  async dropCollection(collection: string, ifExists: boolean): Promise<void> {\n    const db = await this.#ensure()\n    try {\n      const col = db.collection(collection)\n      if (await col.exists()) {\n        await col.drop()\n      } else if (!ifExists) {\n        throw new Error('collection not found: ' + collection)\n      }\n      this.#dims.delete(collection)\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['dropCollection', String(err)])\n    }\n  }\n\n  async hasCollection(collection: string): Promise<boolean> {\n    const db = await this.#ensure()\n    try {\n      return await db.collection(collection).exists()\n    } catch {\n      return false\n    }\n  }\n\n  async renameCollection(_from: string, _to: string): Promise<void> {\n    throw new E_VECTOR_STORE_UNSUPPORTED_OPERATION(['renameCollection', 'arangodb'])\n  }\n\n  async executeUpsert(plan: UpsertPlan): Promise<void> {\n    if (plan.records.length === 0) return\n    validateRecords(plan.records)\n    const db = await this.#ensure()\n    const expected = this.#opts.dimensions ?? this.#dims.get(plan.collection)\n    try {\n      const col = db.collection(plan.collection)\n      for (const r of plan.records) {\n        let vector = r.vector\n        if (!vector && r.document) {\n          const [v] = await this.encode([r.document], 'document')\n          vector = v\n        }\n        if (!vector) {\n          throw new E_VECTOR_STORE_UPSERT_FAILED(['Record missing vector and document'])\n        }\n        if (expected !== undefined && vector.length !== expected) {\n          throw new E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length])\n        }\n        const doc = {\n          _key: r.id,\n          vec: vector,\n          document: r.document ?? '',\n          metadata: r.metadata ? JSON.stringify(r.metadata) : '{}',\n        }\n        await col.save(doc, { overwriteMode: 'replace' })\n      }\n      // Now that the collection has data, ensure the IVF vector index exists.\n      await this.#ensureVectorIndex(plan.collection)\n    } catch (err) {\n      if (\n        isInstanceOf(err, 'E_VECTOR_STORE_DIMENSION_MISMATCH', E_VECTOR_STORE_DIMENSION_MISMATCH) ||\n        isInstanceOf(err, 'E_VECTOR_STORE_UPSERT_FAILED', E_VECTOR_STORE_UPSERT_FAILED)\n      ) {\n        throw err\n      }\n      throw new E_VECTOR_STORE_UPSERT_FAILED([String(err)])\n    }\n  }\n\n  async executeSearch(plan: SearchPlan): Promise<VectorMatch[]> {\n    const db = await this.#ensure()\n    const aql = this.#aql\n    const metric = this.#opts.metric ?? 'cosine'\n    let queryVector: number[] | undefined\n    if (plan.near) {\n      if ('vector' in plan.near) {\n        queryVector = plan.near.vector\n      } else if ('serverText' in plan.near) {\n        const [v] = await this.encode([plan.near.serverText], 'query')\n        queryVector = v\n      } else if ('id' in plan.near) {\n        const col = db.collection(plan.collection)\n        try {\n          const doc = await col.document(plan.near.id)\n          queryVector = doc.vec as number[]\n        } catch {\n          throw new E_VECTOR_STORE_SEARCH_FAILED(['Referenced id not found: ' + plan.near.id])\n        }\n      }\n    }\n\n    const offset = plan.offset ?? 0\n    try {\n      let rows: any[]\n      if (queryVector) {\n        // Use the exact AQL distance functions (COSINE_SIMILARITY / L2_DISTANCE) rather than the\n        // APPROX_NEAR_* index functions: they need no index, are always correct, and avoid\n        // ArangoDB's IVF \"not ready\" / nLists-vs-doc-count constraints. The IVF index is still\n        // created lazily on upsert for production-scale ANN; here correctness comes first.\n        const useL2 = metric === 'euclidean'\n        const fn = useL2 ? 'L2_DISTANCE' : 'COSINE_SIMILARITY'\n        const dir = useL2 ? 'ASC' : 'DESC'\n        const k = plan.filter ? 100000 : plan.topK + offset\n        const query =\n          `FOR d IN @@col ` +\n          `LET __score = ${fn}(d.vec, @qv) ` +\n          `SORT __score ${dir} LIMIT @k ` +\n          `RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata, score: __score }`\n        const cursor = await db.query(query, {\n          '@col': plan.collection,\n          'qv': queryVector,\n          k,\n        })\n        rows = await cursor.all()\n        const filtered = plan.filter\n          ? rows.filter((row) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          : rows\n        return filtered\n          .slice(offset, offset + plan.topK)\n          .map((row) => this.#project(row, plan, true))\n      } else {\n        const cursor = await db.query(\n          aql`FOR d IN ${db.collection(plan.collection)} RETURN { id: d._key, vec: d.vec, document: d.document, metadata: d.metadata }`\n        )\n        rows = await cursor.all()\n        const filtered = plan.filter\n          ? rows.filter((row) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          : rows\n        return filtered\n          .slice(offset, offset + plan.topK)\n          .map((row) => this.#project(row, plan, false))\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)])\n    }\n  }\n\n  #parseMeta(val: unknown): VectorMetadata {\n    if (typeof val === 'string') {\n      try {\n        return JSON.parse(val) as VectorMetadata\n      } catch {\n        return {}\n      }\n    }\n    if (val && typeof val === 'object') return val as VectorMetadata\n    return {}\n  }\n\n  #project(row: any, plan: SearchPlan, isKnn: boolean): VectorMatch {\n    const proj = plan.projection\n    const out: VectorMatch = {}\n    if (proj.id) out.id = row.id as string\n    if (proj.vector && Array.isArray(row.vec)) out.vector = (row.vec as number[]).map(Number)\n    if (proj.document) out.document = (row.document ?? undefined) as string | undefined\n    if (proj.metadata) out.metadata = this.#parseMeta(row.metadata)\n    if (isKnn && row.score !== undefined && row.score !== null) {\n      // APPROX_NEAR_COSINE returns cosine similarity in [0,1]; L2 returns a distance.\n      const m = this.#opts.metric ?? 'cosine'\n      out.score = m === 'euclidean' ? 1 / (1 + Number(row.score)) : Number(row.score)\n    }\n    return out\n  }\n\n  async executeDelete(plan: DeletePlan): Promise<void> {\n    const db = await this.#ensure()\n    const aql = this.#aql\n    try {\n      const col = db.collection(plan.collection)\n      if (plan.ids && plan.ids.length > 0) {\n        await col.removeAll(plan.ids).catch(async () => {\n          for (const id of plan.ids!) await col.remove(id).catch(() => undefined)\n        })\n      } else if (plan.filter) {\n        const cursor = await db.query(\n          aql`FOR d IN ${col} RETURN { id: d._key, metadata: d.metadata }`\n        )\n        const rows = await cursor.all()\n        const targets = rows\n          .filter((row: any) => evaluateFilter(plan.filter!, this.#parseMeta(row.metadata)))\n          .map((row: any) => row.id as string)\n        if (targets.length > 0) {\n          await col.removeAll(targets).catch(async () => {\n            for (const id of targets) await col.remove(id).catch(() => undefined)\n          })\n        }\n      } else {\n        await col.truncate()\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_DELETE_FAILED([String(err)])\n    }\n  }\n}\n"],"mappings":"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"}

package/batteries/vector/builder.cjs

@@ -0,0 +1,297 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Ble4zEEl.js");
+const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+//#region src/batteries/vector/builder.ts
+/**
+* Knex-style chainable query builder for the vector storage battery.
+*
+* @module @nhtio/adk/batteries/vector/builder
+*/
+var OP_ALIASES = {
+	"=": "eq",
+	"==": "eq",
+	"===": "eq",
+	"!=": "ne",
+	"<>": "ne",
+	"!==": "ne",
+	">": "gt",
+	">=": "gte",
+	"<": "lt",
+	"<=": "lte",
+	"eq": "eq",
+	"ne": "ne",
+	"gt": "gt",
+	"gte": "gte",
+	"lt": "lt",
+	"lte": "lte",
+	"in": "in",
+	"nin": "nin",
+	"exists": "exists",
+	"contains": "contains"
+};
+var normalizeOp = (op) => {
+	const norm = OP_ALIASES[op];
+	if (!norm) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(["builder", op]);
+	return norm;
+};
+/**
+* The where-clause surface of the query builder, factored out so a grouping callback can be handed
+* a builder that only exposes filter methods (not `near*`/`select`/`limit` or the terminals).
+*
+* Chained `.where()` ANDs; the first `.orWhere()` snapshots the accumulated AND-list into the first
+* branch of an OR (knex semantics). Any of the where-methods also accepts a {@link FilterCallback}
+* to open a nested group, letting AND and OR mix to any depth.
+*/
+var FilterBuilder = class FilterBuilder {
+	andConditions = [];
+	orBranches = [];
+	/** Build a nested group by running `cb` against a fresh {@link FilterBuilder}. */
+	runGroup(cb) {
+		const fb = new FilterBuilder();
+		cb(fb);
+		return fb.buildFilter();
+	}
+	where(a, b, c) {
+		if (typeof a === "function") {
+			const group = this.runGroup(a);
+			if (group !== void 0) this.andConditions.push(group);
+			return this;
+		}
+		if (typeof a === "object" && !Array.isArray(a)) {
+			for (const key of Object.keys(a)) this.andConditions.push({
+				field: key,
+				op: "eq",
+				value: a[key]
+			});
+			return this;
+		}
+		const field = a;
+		const value = b !== void 0 ? c !== void 0 ? c : b : b;
+		const op = c !== void 0 ? normalizeOp(b) : "eq";
+		this.andConditions.push({
+			field,
+			op,
+			value
+		});
+		return this;
+	}
+	andWhere(a, b, c) {
+		return this.where(a, b, c);
+	}
+	/**
+	* Open a new OR branch holding a single filter. The accumulated AND-list is contributed as the
+	* first OR-group by {@link buildFilter}, so each branch carries only its own condition(s) — that
+	* is what makes `where(A).where(B).orWhere(C)` resolve to `(A AND B) OR C`.
+	*/
+	#pushOrBranch(filter) {
+		this.orBranches.push([filter]);
+	}
+	orWhere(field, b, c) {
+		if (typeof field === "function") {
+			const group = this.runGroup(field);
+			if (group !== void 0) this.#pushOrBranch(group);
+			return this;
+		}
+		const value = c !== void 0 ? c : b;
+		const op = c !== void 0 ? normalizeOp(b) : "eq";
+		this.#pushOrBranch({
+			field,
+			op,
+			value
+		});
+		return this;
+	}
+	whereNot(field, value) {
+		if (typeof field === "function") {
+			const group = this.runGroup(field);
+			if (group !== void 0) this.andConditions.push({ not: group });
+			return this;
+		}
+		return this.where(field, "ne", value);
+	}
+	orWhereNot(field, value) {
+		if (typeof field === "function") {
+			const group = this.runGroup(field);
+			if (group !== void 0) this.#pushOrBranch({ not: group });
+			return this;
+		}
+		return this.orWhere(field, "ne", value);
+	}
+	whereIn(field, values) {
+		return this.where(field, "in", values);
+	}
+	whereNotIn(field, values) {
+		return this.where(field, "nin", values);
+	}
+	whereNull(field) {
+		return this.where(field, "exists", false);
+	}
+	whereExists(field) {
+		return this.where(field, "exists", true);
+	}
+	whereRaw(sqlOrObj, bindings) {
+		if (typeof sqlOrObj === "object") this.andConditions.push({
+			$dialect: sqlOrObj.$dialect,
+			$raw: sqlOrObj.$raw,
+			$bindings: sqlOrObj.$bindings ?? []
+		});
+		else this.andConditions.push({
+			$dialect: "sql",
+			$raw: sqlOrObj,
+			$bindings: bindings ?? []
+		});
+		return this;
+	}
+	buildFilter() {
+		if (this.andConditions.length === 0 && this.orBranches.length === 0) return;
+		if (this.orBranches.length > 0) {
+			const orGroups = [];
+			if (this.andConditions.length > 0) orGroups.push(this.andConditions);
+			for (const branch of this.orBranches) if (branch.length > 0) orGroups.push(branch);
+			if (orGroups.length === 1) return { and: orGroups[0] };
+			return { or: orGroups.map((conds) => ({ and: conds })) };
+		}
+		return { and: this.andConditions };
+	}
+	extractIdsFromFilter() {
+		const ids = [];
+		const only = this.andConditions.length === 1 ? this.andConditions[0] : void 0;
+		if (only && require_batteries_vector_filters.isFilterCondition(only) && only.field === "id" && only.op === "in" && Array.isArray(only.value)) ids.push(...only.value);
+		return ids;
+	}
+};
+var VectorQueryBuilder = class extends FilterBuilder {
+	#sink;
+	#collection;
+	#near;
+	#projection = {
+		id: false,
+		vector: false,
+		document: false,
+		metadata: false
+	};
+	#topK;
+	#offset = 0;
+	#selectCalled = false;
+	#consistency;
+	constructor(sink, collection, defaultTopK) {
+		super();
+		this.#sink = sink;
+		this.#collection = collection;
+		this.#topK = defaultTopK;
+	}
+	nearVector(vector) {
+		if (this.#near !== void 0) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_QUERY_CONFLICT(["a near* clause was already set"]);
+		this.#near = { vector };
+		return this;
+	}
+	nearText(text) {
+		if (this.#near !== void 0) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_QUERY_CONFLICT(["a near* clause was already set"]);
+		this.#near = { serverText: text };
+		return this;
+	}
+	nearId(id) {
+		if (this.#near !== void 0) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_QUERY_CONFLICT(["a near* clause was already set"]);
+		this.#near = { id };
+		return this;
+	}
+	select(...args) {
+		this.#selectCalled = true;
+		for (const arg of args) if (typeof arg === "string") {
+			if (arg === "*") this.#projection = {
+				id: true,
+				vector: {},
+				document: {},
+				metadata: {}
+			};
+			else if (arg === "id") this.#projection.id = true;
+			else if (arg === "vector") this.#projection.vector = {};
+			else if (arg === "document") this.#projection.document = {};
+			else if (arg === "metadata") this.#projection.metadata = {};
+		} else if (Array.isArray(arg)) {
+			const [field, config] = arg;
+			if (field === "vector") this.#projection.vector = config;
+			else if (field === "document") this.#projection.document = config;
+			else if (field === "metadata") this.#projection.metadata = config;
+			else if (field === "id") this.#projection.id = true;
+		} else if (typeof arg === "object") {
+			for (const key of Object.keys(arg)) if (key === "vector") this.#projection.vector = arg[key];
+			else if (key === "document") this.#projection.document = arg[key];
+			else if (key === "metadata") this.#projection.metadata = arg[key];
+			else if (key === "id") this.#projection.id = true;
+		}
+		return this;
+	}
+	limit(n) {
+		this.#topK = n;
+		return this;
+	}
+	offset(n) {
+		this.#offset = n;
+		return this;
+	}
+	/**
+	* Per-operation read-after-write override for the terminal `.upsert()` / `.delete()`.
+	* Universal across adapters: strongly-consistent backends ignore it (no-op), so a chain
+	* written for an eventually-consistent backend keeps working verbatim when the adapter is
+	* swapped. Precedence: this > the store's `consistency` option > the adapter's declared
+	* `capabilities.consistency.default`. See {@link VectorConsistency}.
+	*/
+	consistency(mode) {
+		this.#consistency = mode;
+		return this;
+	}
+	then(onfulfilled, onrejected) {
+		return this.#run().then(onfulfilled, onrejected);
+	}
+	async #run() {
+		if (!this.#selectCalled) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_PROJECTION_REQUIRED();
+		const filter = this.buildFilter();
+		const plan = {
+			collection: this.#collection,
+			near: this.#near,
+			filter,
+			topK: this.#topK,
+			offset: this.#offset,
+			projection: this.#projection
+		};
+		this.#validateRawFilters(plan.filter);
+		return await this.#sink.executeSearch(plan);
+	}
+	async upsert(records) {
+		const plan = {
+			collection: this.#collection,
+			records,
+			consistency: this.#consistency
+		};
+		await this.#sink.executeUpsert(plan);
+	}
+	async delete() {
+		const ids = this.extractIdsFromFilter();
+		const filter = this.buildFilter();
+		const plan = {
+			collection: this.#collection,
+			ids: ids.length > 0 ? ids : void 0,
+			filter: filter && Object.keys(filter).length > 0 ? filter : void 0,
+			consistency: this.#consistency
+		};
+		await this.#sink.executeDelete(plan);
+	}
+	#validateRawFilters(filter) {
+		if (!filter) return;
+		if (require_batteries_vector_filters.isRawFilter(filter)) {
+			const placeholders = (filter.$raw.match(/\?/g) || []).length;
+			if (placeholders !== filter.$bindings?.length) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_RAW_BINDING_MISMATCH([placeholders, filter.$bindings?.length ?? 0]);
+			return;
+		}
+		if ("and" in filter && filter.and) for (const f of filter.and) this.#validateRawFilters(f);
+		if ("or" in filter && filter.or) for (const f of filter.or) this.#validateRawFilters(f);
+		if ("not" in filter && filter.not) this.#validateRawFilters(filter.not);
+	}
+};
+//#endregion
+exports.FilterBuilder = FilterBuilder;
+exports.VectorQueryBuilder = VectorQueryBuilder;
+
+//# sourceMappingURL=builder.cjs.map

package/batteries/vector/builder.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.cjs","names":["#pushOrBranch","#sink","#collection","#topK","#near","#selectCalled","#projection","#offset","#consistency","#run","#validateRawFilters"],"sources":["../../../src/batteries/vector/builder.ts"],"sourcesContent":["/**\n * Knex-style chainable query builder for the vector storage battery.\n *\n * @module @nhtio/adk/batteries/vector/builder\n */\n\nimport { isRawFilter, isFilterCondition } from './filters'\nimport {\n  E_VECTOR_STORE_QUERY_CONFLICT,\n  E_VECTOR_STORE_PROJECTION_REQUIRED,\n  E_VECTOR_STORE_RAW_BINDING_MISMATCH,\n  E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR,\n} from './exceptions'\nimport type { VectorRecord, VectorMatch, VectorConsistency } from './types'\nimport type { SearchPlan, UpsertPlan, DeletePlan, Projection } from './plan'\nimport type { VectorFilter, FilterCondition, FilterOperator } from './filters'\n\nconst OP_ALIASES: Record<string, FilterOperator> = {\n  '=': 'eq',\n  '==': 'eq',\n  '===': 'eq',\n  '!=': 'ne',\n  '<>': 'ne',\n  '!==': 'ne',\n  '>': 'gt',\n  '>=': 'gte',\n  '<': 'lt',\n  '<=': 'lte',\n  'eq': 'eq',\n  'ne': 'ne',\n  'gt': 'gt',\n  'gte': 'gte',\n  'lt': 'lt',\n  'lte': 'lte',\n  'in': 'in',\n  'nin': 'nin',\n  'exists': 'exists',\n  'contains': 'contains',\n}\nconst normalizeOp = (op: string): FilterOperator => {\n  const norm = OP_ALIASES[op]\n  if (!norm) throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['builder', op])\n  return norm\n}\n\nexport interface PlanSink {\n  executeSearch(plan: SearchPlan): Promise<VectorMatch[]>\n  executeUpsert(plan: UpsertPlan): Promise<void>\n  executeDelete(plan: DeletePlan): Promise<void>\n}\n\nexport type SelectArg =\n  | string\n  | [string, Record<string, unknown>]\n  | Record<string, Record<string, unknown> | true>\n\n/**\n * A callback that receives a fresh filter-only builder, used to express a parenthesized group of\n * conditions — `A AND (B OR C)`, `NOT (…)`, and arbitrary nesting. The callback mutates the builder\n * in place (knex-style); its accumulated conditions become a single nested `VectorFilter`.\n *\n * @see {@link FilterBuilder.where}\n */\nexport type FilterCallback = (qb: FilterBuilder) => void\n\n/**\n * The where-clause surface of the query builder, factored out so a grouping callback can be handed\n * a builder that only exposes filter methods (not `near*`/`select`/`limit` or the terminals).\n *\n * Chained `.where()` ANDs; the first `.orWhere()` snapshots the accumulated AND-list into the first\n * branch of an OR (knex semantics). Any of the where-methods also accepts a {@link FilterCallback}\n * to open a nested group, letting AND and OR mix to any depth.\n */\nclass FilterBuilder {\n  protected andConditions: VectorFilter[] = []\n  protected orBranches: VectorFilter[][] = []\n\n  /** Build a nested group by running `cb` against a fresh {@link FilterBuilder}. */\n  protected runGroup(cb: FilterCallback): VectorFilter | undefined {\n    const fb = new FilterBuilder()\n    cb(fb)\n    return fb.buildFilter()\n  }\n\n  where(cb: FilterCallback): this\n  where(a: string, b?: unknown, c?: unknown): this\n  where(obj: Record<string, unknown>): this\n  where(a: string | Record<string, unknown> | FilterCallback, b?: unknown, c?: unknown): this {\n    if (typeof a === 'function') {\n      const group = this.runGroup(a)\n      if (group !== undefined) {\n        this.andConditions.push(group)\n      }\n      return this\n    }\n    if (typeof a === 'object' && !Array.isArray(a)) {\n      for (const key of Object.keys(a)) {\n        this.andConditions.push({\n          field: key,\n          op: 'eq',\n          value: a[key] as FilterCondition['value'],\n        })\n      }\n      return this\n    }\n    const field = a as string\n    const value = b !== undefined ? (c !== undefined ? c : b) : b\n    const op = c !== undefined ? normalizeOp(b as string) : 'eq'\n    this.andConditions.push({ field, op, value: value as FilterCondition['value'] })\n    return this\n  }\n\n  andWhere(cb: FilterCallback): this\n  andWhere(a: string, b?: unknown, c?: unknown): this\n  andWhere(obj: Record<string, unknown>): this\n  andWhere(a: string | Record<string, unknown> | FilterCallback, b?: unknown, c?: unknown): this {\n    return this.where(a as any, b, c)\n  }\n\n  /**\n   * Open a new OR branch holding a single filter. The accumulated AND-list is contributed as the\n   * first OR-group by {@link buildFilter}, so each branch carries only its own condition(s) — that\n   * is what makes `where(A).where(B).orWhere(C)` resolve to `(A AND B) OR C`.\n   */\n  #pushOrBranch(filter: VectorFilter): void {\n    this.orBranches.push([filter])\n  }\n\n  orWhere(cb: FilterCallback): this\n  orWhere(field: string, value: unknown): this\n  orWhere(field: string, op: FilterOperator, value: unknown): this\n  orWhere(field: string | FilterCallback, b?: unknown, c?: unknown): this {\n    if (typeof field === 'function') {\n      const group = this.runGroup(field)\n      if (group !== undefined) {\n        this.#pushOrBranch(group)\n      }\n      return this\n    }\n    const value = c !== undefined ? c : b\n    const op = c !== undefined ? normalizeOp(b as string) : 'eq'\n    this.#pushOrBranch({ field, op, value: value as FilterCondition['value'] })\n    return this\n  }\n\n  whereNot(cb: FilterCallback): this\n  whereNot(field: string, value: unknown): this\n  whereNot(field: string | FilterCallback, value?: unknown): this {\n    if (typeof field === 'function') {\n      const group = this.runGroup(field)\n      if (group !== undefined) {\n        this.andConditions.push({ not: group })\n      }\n      return this\n    }\n    return this.where(field, 'ne', value as FilterCondition['value'])\n  }\n\n  orWhereNot(cb: FilterCallback): this\n  orWhereNot(field: string, value: unknown): this\n  orWhereNot(field: string | FilterCallback, value?: unknown): this {\n    if (typeof field === 'function') {\n      const group = this.runGroup(field)\n      if (group !== undefined) {\n        this.#pushOrBranch({ not: group })\n      }\n      return this\n    }\n    return this.orWhere(field, 'ne', value)\n  }\n\n  whereIn(field: string, values: unknown[]): this {\n    return this.where(field, 'in', values as FilterCondition['value'])\n  }\n\n  whereNotIn(field: string, values: unknown[]): this {\n    return this.where(field, 'nin', values as FilterCondition['value'])\n  }\n\n  whereNull(field: string): this {\n    return this.where(field, 'exists', false as FilterCondition['value'])\n  }\n\n  whereExists(field: string): this {\n    return this.where(field, 'exists', true as FilterCondition['value'])\n  }\n\n  whereRaw(sql: string, bindings?: unknown[]): this\n  whereRaw(rawObj: { $dialect: string; $raw: unknown; $bindings?: unknown[] }): this\n  whereRaw(\n    sqlOrObj: string | { $dialect: string; $raw: unknown; $bindings?: unknown[] },\n    bindings?: unknown[]\n  ): this {\n    if (typeof sqlOrObj === 'object') {\n      this.andConditions.push({\n        $dialect: sqlOrObj.$dialect,\n        $raw: sqlOrObj.$raw,\n        $bindings: sqlOrObj.$bindings ?? [],\n      })\n    } else {\n      this.andConditions.push({ $dialect: 'sql', $raw: sqlOrObj, $bindings: bindings ?? [] })\n    }\n    return this\n  }\n\n  protected buildFilter(): VectorFilter | undefined {\n    if (this.andConditions.length === 0 && this.orBranches.length === 0) {\n      return undefined\n    }\n\n    if (this.orBranches.length > 0) {\n      const orGroups: VectorFilter[][] = []\n      if (this.andConditions.length > 0) {\n        orGroups.push(this.andConditions)\n      }\n      for (const branch of this.orBranches) {\n        if (branch.length > 0) {\n          orGroups.push(branch)\n        }\n      }\n      if (orGroups.length === 1) {\n        return { and: orGroups[0] }\n      }\n      return { or: orGroups.map((conds) => ({ and: conds })) }\n    }\n\n    return { and: this.andConditions }\n  }\n\n  protected extractIdsFromFilter(): string[] {\n    const ids: string[] = []\n    const only = this.andConditions.length === 1 ? this.andConditions[0] : undefined\n    if (\n      only &&\n      isFilterCondition(only) &&\n      only.field === 'id' &&\n      only.op === 'in' &&\n      Array.isArray(only.value)\n    ) {\n      ids.push(...(only.value as string[]))\n    }\n    return ids\n  }\n}\n\nclass VectorQueryBuilder extends FilterBuilder implements PromiseLike<VectorMatch[]> {\n  #sink: PlanSink\n  #collection: string\n  #near: { vector: number[] } | { serverText: string } | { id: string } | undefined\n  #projection: Projection = { id: false, vector: false, document: false, metadata: false }\n  #topK: number\n  #offset: number = 0\n  #selectCalled: boolean = false\n  #consistency: VectorConsistency | undefined\n\n  constructor(sink: PlanSink, collection: string, defaultTopK: number) {\n    super()\n    this.#sink = sink\n    this.#collection = collection\n    this.#topK = defaultTopK\n  }\n\n  nearVector(vector: number[]): this {\n    if (this.#near !== undefined) {\n      throw new E_VECTOR_STORE_QUERY_CONFLICT(['a near* clause was already set'])\n    }\n    this.#near = { vector }\n    return this\n  }\n\n  nearText(text: string): this {\n    if (this.#near !== undefined) {\n      throw new E_VECTOR_STORE_QUERY_CONFLICT(['a near* clause was already set'])\n    }\n    this.#near = { serverText: text }\n    return this\n  }\n\n  nearId(id: string): this {\n    if (this.#near !== undefined) {\n      throw new E_VECTOR_STORE_QUERY_CONFLICT(['a near* clause was already set'])\n    }\n    this.#near = { id }\n    return this\n  }\n\n  select(...args: SelectArg[]): this {\n    this.#selectCalled = true\n    for (const arg of args) {\n      if (typeof arg === 'string') {\n        if (arg === '*') {\n          this.#projection = { id: true, vector: {}, document: {}, metadata: {} }\n        } else {\n          if (arg === 'id') {\n            this.#projection.id = true\n          } else if (arg === 'vector') {\n            this.#projection.vector = {}\n          } else if (arg === 'document') {\n            this.#projection.document = {}\n          } else if (arg === 'metadata') {\n            this.#projection.metadata = {}\n          }\n        }\n      } else if (Array.isArray(arg)) {\n        const [field, config] = arg\n        if (field === 'vector') {\n          this.#projection.vector = config as { name?: string }\n        } else if (field === 'document') {\n          this.#projection.document = config as { field?: string }\n        } else if (field === 'metadata') {\n          this.#projection.metadata = config as { fields?: string[] }\n        } else if (field === 'id') {\n          this.#projection.id = true\n        }\n      } else if (typeof arg === 'object') {\n        for (const key of Object.keys(arg)) {\n          if (key === 'vector') {\n            this.#projection.vector = arg[key] as { name?: string }\n          } else if (key === 'document') {\n            this.#projection.document = arg[key] as { field?: string }\n          } else if (key === 'metadata') {\n            this.#projection.metadata = arg[key] as { fields?: string[] }\n          } else if (key === 'id') {\n            this.#projection.id = true\n          }\n        }\n      }\n    }\n    return this\n  }\n\n  limit(n: number): this {\n    this.#topK = n\n    return this\n  }\n\n  offset(n: number): this {\n    this.#offset = n\n    return this\n  }\n\n  /**\n   * Per-operation read-after-write override for the terminal `.upsert()` / `.delete()`.\n   * Universal across adapters: strongly-consistent backends ignore it (no-op), so a chain\n   * written for an eventually-consistent backend keeps working verbatim when the adapter is\n   * swapped. Precedence: this > the store's `consistency` option > the adapter's declared\n   * `capabilities.consistency.default`. See {@link VectorConsistency}.\n   */\n  consistency(mode: VectorConsistency): this {\n    this.#consistency = mode\n    return this\n  }\n\n  then<TR1 = VectorMatch[], TR2 = never>(\n    onfulfilled?: ((value: VectorMatch[]) => TR1 | PromiseLike<TR1>) | null,\n    onrejected?: ((reason: unknown) => TR2 | PromiseLike<TR2>) | null\n  ): PromiseLike<TR1 | TR2> {\n    return this.#run().then(onfulfilled as any, onrejected as any)\n  }\n\n  async #run(): Promise<VectorMatch[]> {\n    if (!this.#selectCalled) {\n      throw new E_VECTOR_STORE_PROJECTION_REQUIRED()\n    }\n\n    const filter = this.buildFilter()\n\n    const plan: SearchPlan = {\n      collection: this.#collection,\n      near: this.#near,\n      filter,\n      topK: this.#topK,\n      offset: this.#offset,\n      projection: this.#projection,\n    }\n\n    this.#validateRawFilters(plan.filter)\n\n    return await this.#sink.executeSearch(plan)\n  }\n\n  async upsert(records: VectorRecord[]): Promise<void> {\n    const plan: UpsertPlan = {\n      collection: this.#collection,\n      records,\n      consistency: this.#consistency,\n    }\n    await this.#sink.executeUpsert(plan)\n  }\n\n  async delete(): Promise<void> {\n    const ids = this.extractIdsFromFilter()\n    const filter = this.buildFilter()\n\n    const plan: DeletePlan = {\n      collection: this.#collection,\n      ids: ids.length > 0 ? ids : undefined,\n      filter: filter && Object.keys(filter).length > 0 ? filter : undefined,\n      consistency: this.#consistency,\n    }\n\n    await this.#sink.executeDelete(plan)\n  }\n\n  #validateRawFilters(filter: VectorFilter | undefined): void {\n    if (!filter) {\n      return\n    }\n\n    if (isRawFilter(filter)) {\n      const raw = filter.$raw as string\n      const placeholders = (raw.match(/\\?/g) || []).length\n      if (placeholders !== filter.$bindings?.length) {\n        throw new E_VECTOR_STORE_RAW_BINDING_MISMATCH([placeholders, filter.$bindings?.length ?? 0])\n      }\n      return\n    }\n\n    if ('and' in filter && filter.and) {\n      for (const f of filter.and) {\n        this.#validateRawFilters(f)\n      }\n    }\n\n    if ('or' in filter && filter.or) {\n      for (const f of filter.or) {\n        this.#validateRawFilters(f)\n      }\n    }\n\n    if ('not' in filter && filter.not) {\n      this.#validateRawFilters(filter.not)\n    }\n  }\n}\n\nexport { VectorQueryBuilder, FilterBuilder }\n"],"mappings":"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"}