@nhtio/adk 1.20260604.0 → 1.20260607.0

package/batteries/vector/opensearch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"opensearch.mjs","names":["#opts","#client","#ensure","#dims","#body","#project"],"sources":["../../../src/batteries/vector/opensearch/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/opensearch\n *\n * One adapter for the Elasticsearch / OpenSearch family — they share the same kNN `_search`\n * data model. Each collection is an index with a `knn_vector` field; KNN search uses the\n * native `knn` query, and the neutral filter tree compiles to a bool-query `filter` over\n * `metadata.*` keyword/numeric sub-fields. The document and id live in `_source`.\n *\n * Driver: `@opensearch-project/opensearch` by default. To target Elasticsearch instead,\n * pass a compatible client instance via `options.connection.client` (the `@elastic/elasticsearch`\n * Client has the same `.indices`/`.index`/`.search`/`.deleteByQuery` surface used here).\n */\n\nimport { normalizeScore } from '../helpers'\nimport { BaseVectorStore } from '../contract'\nimport { validateRecords } from '../validation'\nimport { isInstanceOf } from '@nhtio/adk/guards'\nimport { isFilterCondition, isRawFilter, isFilterGroup } from '../filters'\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  E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR,\n} from '../exceptions'\nimport type { VectorFilter } from '../filters'\nimport type { SearchPlan, UpsertPlan, DeletePlan, CollectionSpec } from '../plan'\nimport type {\n  VectorMatch,\n  VectorStoreCapabilities,\n  BaseVectorStoreOptions,\n  VectorMetadata,\n  DistanceMetric,\n} from '../types'\n\nexport interface OpenSearchVectorStoreOptions extends BaseVectorStoreOptions {\n  connection?: {\n    node?: string\n    auth?: { username: string; password: string }\n    // A pre-built ES/OpenSearch-compatible client. Overrides `node` when provided.\n    client?: unknown\n  }\n}\n\nconst getOpenSearchClient = async () => {\n  try {\n    const mod = await import('@opensearch-project/opensearch')\n    return mod.Client\n  } catch {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['@opensearch-project/opensearch'])\n  }\n}\n\n// OpenSearch knn_vector space per metric.\nconst spaceType = (metric: DistanceMetric): string =>\n  metric === 'euclidean' ? 'l2' : metric === 'dot' ? 'innerproduct' : 'cosinesimil'\n\n/**\n * Compile the neutral filter tree to an OpenSearch bool-query clause over `metadata.*`.\n * String values use the `.keyword` sub-field for exact match; numbers use range/term.\n */\nexport const translateOpenSearchFilter = (\n  filter?: VectorFilter\n): Record<string, unknown> | undefined => {\n  if (!filter) return undefined\n  if (isRawFilter(filter)) {\n    if (filter.$dialect === 'opensearch' || filter.$dialect === 'elasticsearch') {\n      return filter.$raw as Record<string, unknown>\n    }\n    throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['opensearch', String(filter.$dialect)])\n  }\n  if (isFilterCondition(filter)) {\n    const { field, op, value } = filter\n    const f = `metadata.${field}`\n    const kw = `metadata.${field}.keyword`\n    const term = (v: unknown) =>\n      typeof v === 'number' || typeof v === 'boolean' ? { term: { [f]: v } } : { term: { [kw]: v } }\n    switch (op) {\n      case 'eq':\n        return term(value)\n      case 'ne':\n        return { bool: { must_not: [term(value)] } }\n      case 'gt':\n        return { range: { [f]: { gt: value } } }\n      case 'gte':\n        return { range: { [f]: { gte: value } } }\n      case 'lt':\n        return { range: { [f]: { lt: value } } }\n      case 'lte':\n        return { range: { [f]: { lte: value } } }\n      case 'in': {\n        const arr = Array.isArray(value) ? value : [value]\n        const allNum = arr.every((v) => typeof v === 'number' || typeof v === 'boolean')\n        return { terms: { [allNum ? f : kw]: arr } }\n      }\n      case 'nin': {\n        const arr = Array.isArray(value) ? value : [value]\n        const allNum = arr.every((v) => typeof v === 'number' || typeof v === 'boolean')\n        return { bool: { must_not: [{ terms: { [allNum ? f : kw]: arr } }] } }\n      }\n      case 'exists':\n        return { exists: { field: f } }\n      default:\n        throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['opensearch', op])\n    }\n  }\n  if (isFilterGroup(filter)) {\n    const { and, or, not } = filter\n    if (and) {\n      const must = and.map(translateOpenSearchFilter).filter(Boolean)\n      return { bool: { must } }\n    }\n    if (or) {\n      const should = or.map(translateOpenSearchFilter).filter(Boolean)\n      return { bool: { should, minimum_should_match: 1 } }\n    }\n    if (not) {\n      const inner = translateOpenSearchFilter(not)\n      return inner ? { bool: { must_not: [inner] } } : undefined\n    }\n  }\n  return undefined\n}\n\nexport class OpenSearchVectorStore extends BaseVectorStore {\n  readonly capabilities: VectorStoreCapabilities = {\n    transactions: false,\n    namedVectors: false,\n    rename: false,\n    rawSql: false,\n    builtInEncoding: false,\n    // Made strongly consistent by refreshing the index after every write (refresh: true /\n    // explicit _refresh), so a write is visible to the next search. The option is a no-op.\n    consistency: { configurable: false, default: 'strong', modes: ['strong'] },\n  }\n\n  #client: any | null = null\n  #dims: Map<string, number> = new Map()\n\n  get #opts(): OpenSearchVectorStoreOptions {\n    return this.options as OpenSearchVectorStoreOptions\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.#client) return\n    const c = this.#opts.connection || {}\n    if (c.client) {\n      this.#client = c.client\n      return\n    }\n    const Client = await getOpenSearchClient()\n    try {\n      this.#client = new Client({ node: c.node ?? 'http://localhost:9200', auth: c.auth })\n    } catch (err) {\n      throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)])\n    }\n  }\n\n  async close(): Promise<void> {\n    if (\n      this.#client &&\n      typeof this.#client.close === 'function' &&\n      !this.#opts.connection?.client\n    ) {\n      await this.#client.close()\n    }\n    this.#client = null\n  }\n\n  async #ensure(): Promise<any> {\n    if (!this.#client) await this.connect()\n    return this.#client!\n  }\n\n  // Unwrap the {body}/direct response shape across client versions.\n  #body(res: any): any {\n    return res && res.body !== undefined ? res.body : res\n  }\n\n  async createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void> {\n    const client = await this.#ensure()\n    this.#dims.set(spec.collection, spec.vector.dimensions)\n    if (ifNotExists && (await this.hasCollection(spec.collection))) return\n    try {\n      await client.indices.create({\n        index: spec.collection,\n        body: {\n          settings: { index: { knn: true } },\n          mappings: {\n            properties: {\n              vec: {\n                type: 'knn_vector',\n                dimension: spec.vector.dimensions,\n                method: {\n                  name: 'hnsw',\n                  space_type: spaceType(spec.vector.metric),\n                  engine: 'lucene',\n                },\n              },\n              document: { type: 'text' },\n              metadata: { type: 'object', enabled: true },\n            },\n          },\n        },\n      })\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['createCollection', String(err)])\n    }\n  }\n\n  async dropCollection(collection: string, ifExists: boolean): Promise<void> {\n    const client = await this.#ensure()\n    if (ifExists && !(await this.hasCollection(collection))) return\n    try {\n      await client.indices.delete({ index: collection })\n      this.#dims.delete(collection)\n    } catch (err) {\n      const msg = String(err)\n      if (ifExists && msg.includes('index_not_found')) return\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['dropCollection', msg])\n    }\n  }\n\n  async hasCollection(collection: string): Promise<boolean> {\n    const client = await this.#ensure()\n    try {\n      const res = await client.indices.exists({ index: collection })\n      const body = this.#body(res)\n      return body === true || body === 200 || res?.statusCode === 200\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', 'opensearch'])\n  }\n\n  async executeUpsert(plan: UpsertPlan): Promise<void> {\n    if (plan.records.length === 0) return\n    validateRecords(plan.records)\n    const client = await this.#ensure()\n    const expected = this.#opts.dimensions ?? this.#dims.get(plan.collection)\n    try {\n      const operations: any[] = []\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        operations.push({ index: { _index: plan.collection, _id: r.id } })\n        operations.push({ vec: vector, document: r.document ?? '', metadata: r.metadata ?? {} })\n      }\n      await client.bulk({ body: operations, refresh: true })\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 client = await this.#ensure()\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        try {\n          const res = await client.get({ index: plan.collection, id: plan.near.id })\n          queryVector = this.#body(res)?._source?.vec as number[]\n        } catch {\n          queryVector = undefined\n        }\n        if (!queryVector) {\n          throw new E_VECTOR_STORE_SEARCH_FAILED(['Referenced id not found: ' + plan.near.id])\n        }\n      }\n    }\n\n    const filter = translateOpenSearchFilter(plan.filter)\n    const size = plan.topK\n    const from = plan.offset ?? 0\n    try {\n      let body: any\n      if (queryVector) {\n        const knn: any = { vec: { vector: queryVector, k: size + from } }\n        if (filter) knn.vec.filter = filter\n        body = { size, from, query: { knn } }\n      } else {\n        body = { size, from, query: filter ?? { match_all: {} } }\n      }\n      const res = await client.search({ index: plan.collection, body })\n      const hits = this.#body(res)?.hits?.hits ?? []\n      return hits.map((hit: any) => this.#project(hit, plan, metric, !!queryVector))\n    } catch (err) {\n      throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)])\n    }\n  }\n\n  #project(hit: any, plan: SearchPlan, metric: string, isKnn: boolean): VectorMatch {\n    const proj = plan.projection\n    const src = hit._source ?? {}\n    const out: VectorMatch = {}\n    if (proj.id) out.id = hit._id as string\n    if (proj.vector && src.vec) out.vector = src.vec as number[]\n    if (proj.document) out.document = src.document as string | undefined\n    if (proj.metadata) out.metadata = (src.metadata ?? {}) as VectorMetadata\n    if (isKnn && typeof hit._score === 'number') {\n      // OpenSearch returns a similarity score (higher = closer); normalize defensively to [0,1].\n      out.score = normalizeScore(hit._score, metric as DistanceMetric, 'similarity')\n    }\n    return out\n  }\n\n  async executeDelete(plan: DeletePlan): Promise<void> {\n    const client = await this.#ensure()\n    try {\n      if (plan.ids && plan.ids.length > 0) {\n        const operations = plan.ids.map((id) => ({ delete: { _index: plan.collection, _id: id } }))\n        await client.bulk({ body: operations, refresh: true })\n      } else if (plan.filter) {\n        const filter = translateOpenSearchFilter(plan.filter)\n        await client.deleteByQuery({\n          index: plan.collection,\n          refresh: true,\n          body: { query: filter ?? { match_all: {} } },\n        })\n      } else {\n        await client.deleteByQuery({\n          index: plan.collection,\n          refresh: true,\n          body: { query: { match_all: {} } },\n        })\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/oracle23ai/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @module @nhtio/adk/batteries/vector/oracle23ai
+ *
+ * Oracle 23ai AI Vector Search adapter. Vectors live in a `VECTOR(dims, FLOAT32)` column
+ * written with `DB_TYPE_VECTOR` (oracledb thin mode, default) and read back as Float32Array.
+ * KNN search uses `VECTOR_DISTANCE(vec, :q, COSINE|EUCLIDEAN|DOT)` ordered ascending. Metadata
+ * is a CLOB containing a JSON string, filtered with the neutral evaluator for exact cross-adapter
+ * parity. Each collection maps to a table named `<tablePrefix><collection>` with double-quoted
+ * identifiers for safety.
+ *
+ * The connecting user must default to a non-SYSTEM tablespace (e.g. USERS) and have CREATE TABLE.
+ * Oracle 23ai provides strong consistency: commits are synchronous, so there is no settle-poll.
+ *
+ * Score contract: do NOT trust the raw VECTOR_DISTANCE as a [0,1] score. Instead, use SQL only to
+ * order candidates, then recompute the [0,1] similarity locally using the stored `vec` and the
+ * computeScore helper, ensuring the [0,1] contract regardless of metric semantics.
+ *
+ * Driver: `oracledb` (pure-JS thin mode, no Instant Client required).
+ */
+import { BaseVectorStore } from "../contract";
+import type { SearchPlan, UpsertPlan, DeletePlan, CollectionSpec } from "../plan";
+import type { VectorMatch, VectorStoreCapabilities, BaseVectorStoreOptions } from "../types";
+export interface Oracle23aiVectorStoreOptions extends BaseVectorStoreOptions {
+    connection: {
+        connectString: string;
+        user: string;
+        password: string;
+        tablePrefix?: string;
+    };
+}
+export declare class Oracle23aiVectorStore extends BaseVectorStore {
+    #private;
+    readonly capabilities: VectorStoreCapabilities;
+    static isAvailable(): boolean;
+    isAvailable(): boolean;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void>;
+    dropCollection(collection: string, ifExists: boolean): Promise<void>;
+    hasCollection(collection: string): Promise<boolean>;
+    renameCollection(_from: string, _to: string): Promise<void>;
+    executeUpsert(plan: UpsertPlan): Promise<void>;
+    executeSearch(plan: SearchPlan): Promise<VectorMatch[]>;
+    executeDelete(plan: DeletePlan): Promise<void>;
+}

package/batteries/vector/oracle23ai.cjs

@@ -0,0 +1,340 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Ble4zEEl.js");
+const require_tool_registry = require("../../tool_registry-DYUYqXvo.js");
+require("../../guards.cjs");
+const require_batteries_vector_filters = require("./filters.cjs");
+const require_batteries_vector_helpers = require("./helpers.cjs");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_contract = require("./contract.cjs");
+const require_batteries_vector_validation = require("./validation.cjs");
+//#region src/batteries/vector/oracle23ai/index.ts
+/**
+* @module @nhtio/adk/batteries/vector/oracle23ai
+*
+* Oracle 23ai AI Vector Search adapter. Vectors live in a `VECTOR(dims, FLOAT32)` column
+* written with `DB_TYPE_VECTOR` (oracledb thin mode, default) and read back as Float32Array.
+* KNN search uses `VECTOR_DISTANCE(vec, :q, COSINE|EUCLIDEAN|DOT)` ordered ascending. Metadata
+* is a CLOB containing a JSON string, filtered with the neutral evaluator for exact cross-adapter
+* parity. Each collection maps to a table named `<tablePrefix><collection>` with double-quoted
+* identifiers for safety.
+*
+* The connecting user must default to a non-SYSTEM tablespace (e.g. USERS) and have CREATE TABLE.
+* Oracle 23ai provides strong consistency: commits are synchronous, so there is no settle-poll.
+*
+* Score contract: do NOT trust the raw VECTOR_DISTANCE as a [0,1] score. Instead, use SQL only to
+* order candidates, then recompute the [0,1] similarity locally using the stored `vec` and the
+* computeScore helper, ensuring the [0,1] contract regardless of metric semantics.
+*
+* Driver: `oracledb` (pure-JS thin mode, no Instant Client required).
+*/
+var getOracle = async () => {
+	try {
+		const mod = await import(
+			/* @vite-ignore */
+			"oracledb"
+);
+		return mod.default ?? mod;
+	} catch {
+		throw new require_batteries_vector_exceptions.E_VECTOR_STORE_DRIVER_UNAVAILABLE(["oracledb"]);
+	}
+};
+var ident = (name) => "\"" + name.replace(/"/g, "\"\"") + "\"";
+var Oracle23aiVectorStore = class extends require_batteries_vector_contract.BaseVectorStore {
+	capabilities = {
+		transactions: false,
+		namedVectors: false,
+		rename: false,
+		rawSql: false,
+		builtInEncoding: false,
+		consistency: {
+			configurable: false,
+			default: "strong",
+			modes: ["strong"]
+		}
+	};
+	#oracledb = null;
+	#conn = null;
+	#dims = /* @__PURE__ */ new Map();
+	#metrics = /* @__PURE__ */ new Map();
+	get #opts() {
+		return this.options;
+	}
+	#table(collection) {
+		return (this.#opts.connection.tablePrefix ?? "") + collection;
+	}
+	static isAvailable() {
+		return typeof process !== "undefined";
+	}
+	isAvailable() {
+		return typeof process !== "undefined";
+	}
+	async connect() {
+		if (this.#conn) return;
+		this.#oracledb = await getOracle();
+		const c = this.#opts.connection;
+		try {
+			this.#conn = await this.#oracledb.getConnection({
+				user: c.user,
+				password: c.password,
+				connectString: c.connectString
+			});
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_CONNECTION_FAILED([String(err)]);
+		}
+	}
+	async close() {
+		if (this.#conn) {
+			await this.#conn.close();
+			this.#conn = null;
+			this.#oracledb = null;
+		}
+	}
+	#parseMeta(val) {
+		if (typeof val === "string") try {
+			return JSON.parse(val);
+		} catch {
+			return {};
+		}
+		if (val && typeof val === "object") return val;
+		return {};
+	}
+	async createCollection(spec, ifNotExists) {
+		const coll = spec.collection;
+		const dims = spec.vector.dimensions;
+		const metric = spec.vector.metric;
+		this.#dims.set(coll, dims);
+		this.#metrics.set(coll, metric);
+		const T = ident(this.#table(coll));
+		const tableName = this.#table(coll);
+		try {
+			if ((await this.#conn.execute(`SELECT 1 FROM user_tables WHERE table_name = :n`, [tableName], { outFormat: this.#oracledb.OUT_FORMAT_OBJECT })).rows.length > 0) {
+				if (ifNotExists) {
+					await this.#conn.execute(`DELETE FROM ${T}`);
+					await this.#conn.commit();
+					return;
+				}
+				await this.#conn.execute(`DROP TABLE ${T}`);
+			}
+			const sql = `CREATE TABLE ${T} (
+        id VARCHAR2(512) PRIMARY KEY,
+        vec VECTOR(${dims}, FLOAT32),
+        document CLOB,
+        metadata CLOB
+      )`;
+			await this.#conn.execute(sql);
+			await this.#conn.commit();
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED(["createCollection", String(err)]);
+		}
+	}
+	async dropCollection(collection, ifExists) {
+		const T = ident(this.#table(collection));
+		try {
+			await this.#conn.execute(`DROP TABLE ${T}`);
+			this.#dims.delete(collection);
+			this.#metrics.delete(collection);
+		} catch (err) {
+			if (err?.message && err.message.includes("ORA-00942")) {
+				if (ifExists) return;
+				throw new require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED(["dropCollection", "table does not exist"]);
+			}
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_COLLECTION_FAILED(["dropCollection", String(err)]);
+		}
+	}
+	async hasCollection(collection) {
+		const tableName = this.#table(collection);
+		return (await this.#conn.execute(`SELECT 1 FROM user_tables WHERE table_name = :n`, [tableName], { outFormat: this.#oracledb.OUT_FORMAT_OBJECT })).rows.length > 0;
+	}
+	async renameCollection(_from, _to) {
+		throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UNSUPPORTED_OPERATION(["renameCollection", "oracle23ai"]);
+	}
+	async executeUpsert(plan) {
+		if (plan.records.length === 0) return;
+		require_batteries_vector_validation.validateRecords(plan.records);
+		const expected = this.#opts.dimensions ?? this.#dims.get(plan.collection);
+		const T = ident(this.#table(plan.collection));
+		try {
+			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 require_batteries_vector_exceptions.E_VECTOR_STORE_UPSERT_FAILED(["Record missing vector and document"]);
+				if (expected !== void 0 && vector.length !== expected) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_DIMENSION_MISMATCH([expected, vector.length]);
+				const vecBind = {
+					type: this.#oracledb.DB_TYPE_VECTOR,
+					val: Float32Array.from(vector)
+				};
+				const doc = r.document ?? "";
+				const meta = r.metadata ? JSON.stringify(r.metadata) : "{}";
+				await this.#conn.execute(`MERGE INTO ${T} d
+           USING (SELECT :id AS id FROM dual) s
+           ON (d.id = s.id)
+           WHEN MATCHED THEN UPDATE SET vec = :vec, document = :doc, metadata = :meta
+           WHEN NOT MATCHED THEN INSERT (id, vec, document, metadata)
+             VALUES (:id, :vec, :doc, :meta)`, {
+					id: r.id,
+					vec: vecBind,
+					doc,
+					meta
+				}, { outFormat: this.#oracledb.OUT_FORMAT_OBJECT });
+			}
+			await this.#conn.commit();
+		} catch (err) {
+			if (require_tool_registry.isInstanceOf(err, "E_VECTOR_STORE_DIMENSION_MISMATCH", require_batteries_vector_exceptions.E_VECTOR_STORE_DIMENSION_MISMATCH) || require_tool_registry.isInstanceOf(err, "E_VECTOR_STORE_UPSERT_FAILED", require_batteries_vector_exceptions.E_VECTOR_STORE_UPSERT_FAILED)) throw err;
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_UPSERT_FAILED([String(err)]);
+		}
+	}
+	async executeSearch(plan) {
+		const coll = plan.collection;
+		const metric = this.#metrics.get(coll) ?? this.#opts.metric ?? "cosine";
+		const T = ident(this.#table(coll));
+		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 rows = await this.#conn.execute(`SELECT vec FROM ${T} WHERE id = :id`, [plan.near.id], {
+					outFormat: this.#oracledb.OUT_FORMAT_OBJECT,
+					fetchInfo: { VEC: { type: this.#oracledb.DB_TYPE_VECTOR } }
+				});
+				if (rows.rows.length === 0) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED(["Referenced id not found: " + plan.near.id]);
+				const arr = rows.rows[0].VEC;
+				queryVector = Array.from(arr);
+			}
+		}
+		const offset = plan.offset ?? 0;
+		try {
+			if (queryVector) {
+				const k = plan.filter ? 1e3 : plan.topK + offset;
+				const metricSql = metric === "cosine" ? "COSINE" : metric === "euclidean" ? "EUCLIDEAN" : metric === "dot" ? "DOT" : "COSINE";
+				const qBind = {
+					type: this.#oracledb.DB_TYPE_VECTOR,
+					val: Float32Array.from(queryVector)
+				};
+				const rows = await this.#conn.execute(`SELECT id, vec, document, metadata, VECTOR_DISTANCE(vec, :q, ${metricSql}) AS dist
+           FROM ${T}
+           ORDER BY dist
+           FETCH APPROX FIRST :k ROWS ONLY`, {
+					q: qBind,
+					k
+				}, {
+					outFormat: this.#oracledb.OUT_FORMAT_OBJECT,
+					fetchInfo: {
+						DOCUMENT: { type: this.#oracledb.STRING },
+						METADATA: { type: this.#oracledb.STRING }
+					}
+				});
+				const result = [];
+				for (const row of rows.rows) {
+					const meta = this.#parseMeta(row.METADATA);
+					if (plan.filter && !require_batteries_vector_filters.evaluateFilter(plan.filter, meta)) continue;
+					const score = computeScore(Array.from(row.VEC), queryVector, metric);
+					result.push(this.#project(row, plan, score));
+				}
+				return result.slice(offset, offset + plan.topK);
+			} else {
+				const rows = await this.#conn.execute(`SELECT id, vec, document, metadata FROM ${T} FETCH FIRST :cap ROWS ONLY`, [1e3], {
+					outFormat: this.#oracledb.OUT_FORMAT_OBJECT,
+					fetchInfo: {
+						DOCUMENT: { type: this.#oracledb.STRING },
+						METADATA: { type: this.#oracledb.STRING }
+					}
+				});
+				const result = [];
+				for (const row of rows.rows) {
+					const meta = this.#parseMeta(row.METADATA);
+					if (plan.filter && !require_batteries_vector_filters.evaluateFilter(plan.filter, meta)) continue;
+					result.push(this.#project(row, plan, void 0));
+				}
+				return result.slice(offset, offset + plan.topK);
+			}
+		} catch (err) {
+			if (err?.message && err.message.includes("Referenced id not found")) throw err;
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_SEARCH_FAILED([String(err)]);
+		}
+	}
+	#project(row, plan, score) {
+		const proj = plan.projection;
+		const out = {};
+		if (proj.id) out.id = row.ID;
+		if (proj.vector) out.vector = Array.from(row.VEC).map(Number);
+		if (proj.document) out.document = row.DOCUMENT ?? void 0;
+		if (proj.metadata) out.metadata = this.#parseMeta(row.METADATA);
+		if (score !== void 0) out.score = score;
+		return out;
+	}
+	async executeDelete(plan) {
+		const T = ident(this.#table(plan.collection));
+		try {
+			if (plan.ids && plan.ids.length > 0) {
+				const ids = plan.ids;
+				const bindObj = {};
+				ids.forEach((id, i) => {
+					bindObj["id" + i] = id;
+				});
+				const sql = `DELETE FROM ${T} WHERE id IN (${ids.map((_id, i) => ":id" + i).join(", ")})`;
+				await this.#conn.execute(sql, bindObj);
+				await this.#conn.commit();
+			} else if (plan.filter) {
+				const targets = (await this.#conn.execute(`SELECT id, metadata FROM ${T}`, {}, {
+					outFormat: this.#oracledb.OUT_FORMAT_OBJECT,
+					fetchInfo: { METADATA: { type: this.#oracledb.STRING } }
+				})).rows.filter((r) => require_batteries_vector_filters.evaluateFilter(plan.filter, this.#parseMeta(r.METADATA))).map((r) => r.ID);
+				if (targets.length > 0) {
+					const bindObj = {};
+					targets.forEach((id, i) => {
+						bindObj["id" + i] = id;
+					});
+					const sql = `DELETE FROM ${T} WHERE id IN (${targets.map((_id, i) => ":id" + i).join(", ")})`;
+					await this.#conn.execute(sql, bindObj);
+					await this.#conn.commit();
+				}
+			} else {
+				await this.#conn.execute(`DELETE FROM ${T}`);
+				await this.#conn.commit();
+			}
+		} catch (err) {
+			throw new require_batteries_vector_exceptions.E_VECTOR_STORE_DELETE_FAILED([String(err)]);
+		}
+	}
+};
+var cosineSim = (a, b) => {
+	let dot = 0;
+	let normA = 0;
+	let normB = 0;
+	for (const [i, av] of a.entries()) {
+		const bv = b[i];
+		dot += av * bv;
+		normA += av * av;
+		normB += bv * bv;
+	}
+	const denom = Math.sqrt(normA) * Math.sqrt(normB);
+	return denom === 0 ? 0 : dot / denom;
+};
+var dotProd = (a, b) => {
+	let s = 0;
+	for (const [i, element] of a.entries()) s += element * b[i];
+	return s;
+};
+var euclideanDist = (a, b) => {
+	let s = 0;
+	for (const [i, element] of a.entries()) {
+		const d = element - b[i];
+		s += d * d;
+	}
+	return Math.sqrt(s);
+};
+var computeScore = (vec, query, metric) => {
+	if (metric === "cosine") return require_batteries_vector_helpers.normalizeScore(cosineSim(vec, query), "cosine", "similarity");
+	else if (metric === "dot") return require_batteries_vector_helpers.normalizeScore(dotProd(vec, query), "dot", "similarity");
+	else if (metric === "euclidean") return require_batteries_vector_helpers.normalizeScore(euclideanDist(vec, query), "euclidean", "distance");
+	else return require_batteries_vector_helpers.normalizeScore(cosineSim(vec, query), "cosine", "similarity");
+};
+//#endregion
+exports.Oracle23aiVectorStore = Oracle23aiVectorStore;
+
+//# sourceMappingURL=oracle23ai.cjs.map

package/batteries/vector/oracle23ai.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"oracle23ai.cjs","names":["#opts","#conn","#oracledb","#dims","#metrics","#table","#parseMeta","#project"],"sources":["../../../src/batteries/vector/oracle23ai/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/oracle23ai\n *\n * Oracle 23ai AI Vector Search adapter. Vectors live in a `VECTOR(dims, FLOAT32)` column\n * written with `DB_TYPE_VECTOR` (oracledb thin mode, default) and read back as Float32Array.\n * KNN search uses `VECTOR_DISTANCE(vec, :q, COSINE|EUCLIDEAN|DOT)` ordered ascending. Metadata\n * is a CLOB containing a JSON string, filtered with the neutral evaluator for exact cross-adapter\n * parity. Each collection maps to a table named `<tablePrefix><collection>` with double-quoted\n * identifiers for safety.\n *\n * The connecting user must default to a non-SYSTEM tablespace (e.g. USERS) and have CREATE TABLE.\n * Oracle 23ai provides strong consistency: commits are synchronous, so there is no settle-poll.\n *\n * Score contract: do NOT trust the raw VECTOR_DISTANCE as a [0,1] score. Instead, use SQL only to\n * order candidates, then recompute the [0,1] similarity locally using the stored `vec` and the\n * computeScore helper, ensuring the [0,1] contract regardless of metric semantics.\n *\n * Driver: `oracledb` (pure-JS thin mode, no Instant Client required).\n */\n\nimport { evaluateFilter } from '../filters'\nimport { normalizeScore } from '../helpers'\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  DistanceMetric,\n} from '../types'\n\nconst getOracle = async (): Promise<any> => {\n  try {\n    // oracledb ships no type declarations; import the specifier dynamically as untyped.\n    const mod = await import(/* @vite-ignore */ 'oracledb' as string)\n    return mod.default ?? mod\n  } catch {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['oracledb'])\n  }\n}\n\n// Build a double-quoted Oracle identifier, safely escaping embedded double quotes.\nconst ident = (name: string): string => '\"' + name.replace(/\"/g, '\"\"') + '\"'\n\nexport interface Oracle23aiVectorStoreOptions extends BaseVectorStoreOptions {\n  connection: {\n    connectString: string // 'host:1521/FREEPDB1'\n    user: string\n    password: string\n    tablePrefix?: string // logical collection → `${tablePrefix}${collection}` table\n  }\n}\n\nexport class Oracle23aiVectorStore extends BaseVectorStore {\n  readonly capabilities: VectorStoreCapabilities = {\n    transactions: false,\n    namedVectors: false,\n    rename: false,\n    rawSql: false,\n    builtInEncoding: false,\n    consistency: { configurable: false, default: 'strong', modes: ['strong'] },\n  }\n\n  #oracledb: any | null = null\n  #conn: any | null = null\n  #dims: Map<string, number> = new Map()\n  #metrics: Map<string, DistanceMetric> = new Map()\n\n  get #opts(): Oracle23aiVectorStoreOptions {\n    return this.options as Oracle23aiVectorStoreOptions\n  }\n\n  // Map a logical collection name to its physical table (with optional prefix).\n  #table(collection: string): string {\n    const prefix = this.#opts.connection.tablePrefix ?? ''\n    return prefix + collection\n  }\n\n  static isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  isAvailable(): boolean {\n    return typeof process !== 'undefined'\n  }\n\n  async connect(): Promise<void> {\n    if (this.#conn) return\n    this.#oracledb = await getOracle()\n    const c = this.#opts.connection\n    try {\n      this.#conn = await this.#oracledb.getConnection({\n        user: c.user,\n        password: c.password,\n        connectString: c.connectString,\n      })\n    } catch (err) {\n      throw new E_VECTOR_STORE_CONNECTION_FAILED([String(err)])\n    }\n  }\n\n  async close(): Promise<void> {\n    if (this.#conn) {\n      await this.#conn.close()\n      this.#conn = null\n      this.#oracledb = null\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  async createCollection(spec: CollectionSpec, ifNotExists: boolean): Promise<void> {\n    const coll = spec.collection\n    const dims = spec.vector.dimensions\n    const metric = spec.vector.metric\n    this.#dims.set(coll, dims)\n    this.#metrics.set(coll, metric)\n\n    const T = ident(this.#table(coll))\n    const tableName = this.#table(coll)\n\n    try {\n      // Check if table exists\n      const checkRows = await this.#conn!.execute(\n        `SELECT 1 FROM user_tables WHERE table_name = :n`,\n        [tableName],\n        { outFormat: this.#oracledb!.OUT_FORMAT_OBJECT }\n      )\n      const exists = checkRows.rows.length > 0\n\n      if (exists) {\n        if (ifNotExists) {\n          // Clear existing table\n          await this.#conn!.execute(`DELETE FROM ${T}`)\n          await this.#conn!.commit()\n          return\n        }\n        // Drop and recreate\n        await this.#conn!.execute(`DROP TABLE ${T}`)\n      }\n\n      // Create table\n      const sql = `CREATE TABLE ${T} (\n        id VARCHAR2(512) PRIMARY KEY,\n        vec VECTOR(${dims}, FLOAT32),\n        document CLOB,\n        metadata CLOB\n      )`\n      await this.#conn!.execute(sql)\n      await this.#conn!.commit()\n    } catch (err) {\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['createCollection', String(err)])\n    }\n  }\n\n  async dropCollection(collection: string, ifExists: boolean): Promise<void> {\n    const T = ident(this.#table(collection))\n    try {\n      await this.#conn!.execute(`DROP TABLE ${T}`)\n      this.#dims.delete(collection)\n      this.#metrics.delete(collection)\n    } catch (err: any) {\n      if (err?.message && err.message.includes('ORA-00942')) {\n        if (ifExists) return\n        throw new E_VECTOR_STORE_COLLECTION_FAILED(['dropCollection', 'table does not exist'])\n      }\n      throw new E_VECTOR_STORE_COLLECTION_FAILED(['dropCollection', String(err)])\n    }\n  }\n\n  async hasCollection(collection: string): Promise<boolean> {\n    const tableName = this.#table(collection)\n    const rows = await this.#conn!.execute(\n      `SELECT 1 FROM user_tables WHERE table_name = :n`,\n      [tableName],\n      { outFormat: this.#oracledb!.OUT_FORMAT_OBJECT }\n    )\n    return rows.rows.length > 0\n  }\n\n  async renameCollection(_from: string, _to: string): Promise<void> {\n    throw new E_VECTOR_STORE_UNSUPPORTED_OPERATION(['renameCollection', 'oracle23ai'])\n  }\n\n  async executeUpsert(plan: UpsertPlan): Promise<void> {\n    if (plan.records.length === 0) return\n    validateRecords(plan.records)\n    const expected = this.#opts.dimensions ?? this.#dims.get(plan.collection)\n\n    const T = ident(this.#table(plan.collection))\n\n    try {\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\n        const vecBind = {\n          type: this.#oracledb!.DB_TYPE_VECTOR,\n          val: Float32Array.from(vector),\n        }\n\n        const doc = r.document ?? ''\n        const meta = r.metadata ? JSON.stringify(r.metadata) : '{}'\n\n        // MERGE upsert\n        await this.#conn!.execute(\n          `MERGE INTO ${T} d\n           USING (SELECT :id AS id FROM dual) s\n           ON (d.id = s.id)\n           WHEN MATCHED THEN UPDATE SET vec = :vec, document = :doc, metadata = :meta\n           WHEN NOT MATCHED THEN INSERT (id, vec, document, metadata)\n             VALUES (:id, :vec, :doc, :meta)`,\n          {\n            id: r.id,\n            vec: vecBind,\n            doc,\n            meta,\n          },\n          { outFormat: this.#oracledb!.OUT_FORMAT_OBJECT }\n        )\n      }\n      await this.#conn!.commit()\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 coll = plan.collection\n    const metric: DistanceMetric = this.#metrics.get(coll) ?? this.#opts.metric ?? 'cosine'\n    const T = ident(this.#table(coll))\n\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 rows = await this.#conn!.execute(\n          `SELECT vec FROM ${T} WHERE id = :id`,\n          [plan.near.id],\n          {\n            outFormat: this.#oracledb!.OUT_FORMAT_OBJECT,\n            fetchInfo: { VEC: { type: this.#oracledb!.DB_TYPE_VECTOR } },\n          }\n        )\n        if (rows.rows.length === 0) {\n          throw new E_VECTOR_STORE_SEARCH_FAILED(['Referenced id not found: ' + plan.near.id])\n        }\n        const arr = rows.rows[0].VEC as Float32Array\n        queryVector = Array.from(arr)\n      }\n    }\n\n    const offset = plan.offset ?? 0\n\n    try {\n      if (queryVector) {\n        const k = plan.filter ? 1000 : plan.topK + offset\n        const metricSql =\n          metric === 'cosine'\n            ? 'COSINE'\n            : metric === 'euclidean'\n              ? 'EUCLIDEAN'\n              : metric === 'dot'\n                ? 'DOT'\n                : 'COSINE'\n\n        const qBind = {\n          type: this.#oracledb!.DB_TYPE_VECTOR,\n          val: Float32Array.from(queryVector),\n        }\n\n        const rows = await this.#conn!.execute(\n          `SELECT id, vec, document, metadata, VECTOR_DISTANCE(vec, :q, ${metricSql}) AS dist\n           FROM ${T}\n           ORDER BY dist\n           FETCH APPROX FIRST :k ROWS ONLY`,\n          { q: qBind, k },\n          {\n            outFormat: this.#oracledb!.OUT_FORMAT_OBJECT,\n            fetchInfo: {\n              DOCUMENT: { type: this.#oracledb!.STRING },\n              METADATA: { type: this.#oracledb!.STRING },\n            },\n          }\n        )\n\n        const result: VectorMatch[] = []\n        for (const row of rows.rows) {\n          const meta = this.#parseMeta(row.METADATA)\n          if (plan.filter && !evaluateFilter(plan.filter, meta)) {\n            continue\n          }\n          const storedVec = Array.from(row.VEC as Float32Array)\n          const score = computeScore(storedVec, queryVector!, metric)\n          result.push(this.#project(row, plan, score))\n        }\n\n        // Apply offset/slice after filtering\n        return result.slice(offset, offset + plan.topK)\n      } else {\n        // Filter-scan: no KNN, read all rows\n        const cap = 1000\n        const rows = await this.#conn!.execute(\n          `SELECT id, vec, document, metadata FROM ${T} FETCH FIRST :cap ROWS ONLY`,\n          [cap],\n          {\n            outFormat: this.#oracledb!.OUT_FORMAT_OBJECT,\n            fetchInfo: {\n              DOCUMENT: { type: this.#oracledb!.STRING },\n              METADATA: { type: this.#oracledb!.STRING },\n            },\n          }\n        )\n\n        const result: VectorMatch[] = []\n        for (const row of rows.rows) {\n          const meta = this.#parseMeta(row.METADATA)\n          if (plan.filter && !evaluateFilter(plan.filter, meta)) {\n            continue\n          }\n          result.push(this.#project(row, plan, undefined))\n        }\n        return result.slice(offset, offset + plan.topK)\n      }\n    } catch (err: any) {\n      if (err?.message && err.message.includes('Referenced id not found')) {\n        throw err\n      }\n      throw new E_VECTOR_STORE_SEARCH_FAILED([String(err)])\n    }\n  }\n\n  #project(row: any, plan: SearchPlan, score?: number): VectorMatch {\n    const proj = plan.projection\n    const out: VectorMatch = {}\n    if (proj.id) out.id = row.ID as string\n    if (proj.vector) out.vector = (Array.from(row.VEC as Float32Array) 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 (score !== undefined) out.score = score\n    return out\n  }\n\n  async executeDelete(plan: DeletePlan): Promise<void> {\n    const T = ident(this.#table(plan.collection))\n    try {\n      if (plan.ids && plan.ids.length > 0) {\n        const ids = plan.ids\n        const bindObj: any = {}\n        ids.forEach((id, i) => {\n          bindObj['id' + i] = id\n        })\n        const sql = `DELETE FROM ${T} WHERE id IN (${ids.map((_id, i) => ':id' + i).join(', ')})`\n        await this.#conn!.execute(sql, bindObj)\n        await this.#conn!.commit()\n      } else if (plan.filter) {\n        const rows = await this.#conn!.execute(\n          `SELECT id, metadata FROM ${T}`,\n          {},\n          {\n            outFormat: this.#oracledb!.OUT_FORMAT_OBJECT,\n            fetchInfo: {\n              METADATA: { type: this.#oracledb!.STRING },\n            },\n          }\n        )\n        const targets = rows.rows\n          .filter((r: any) => evaluateFilter(plan.filter!, this.#parseMeta(r.METADATA)))\n          .map((r: any) => r.ID as string)\n        if (targets.length > 0) {\n          const bindObj: any = {}\n          targets.forEach((id: string, i: number) => {\n            bindObj['id' + i] = id\n          })\n          const sql = `DELETE FROM ${T} WHERE id IN (${targets.map((_id: string, i: number) => ':id' + i).join(', ')})`\n          await this.#conn!.execute(sql, bindObj)\n          await this.#conn!.commit()\n        }\n      } else {\n        await this.#conn!.execute(`DELETE FROM ${T}`)\n        await this.#conn!.commit()\n      }\n    } catch (err) {\n      throw new E_VECTOR_STORE_DELETE_FAILED([String(err)])\n    }\n  }\n}\n\n// Score recomputation helpers (copied from couchbase/index.ts verbatim)\n\nconst cosineSim = (a: number[], b: number[]): number => {\n  let dot = 0\n  let normA = 0\n  let normB = 0\n  for (const [i, av] of a.entries()) {\n    const bv = b[i]\n    dot += av * bv\n    normA += av * av\n    normB += bv * bv\n  }\n  const denom = Math.sqrt(normA) * Math.sqrt(normB)\n  return denom === 0 ? 0 : dot / denom\n}\n\nconst dotProd = (a: number[], b: number[]): number => {\n  let s = 0\n  for (const [i, element] of a.entries()) {\n    s += element * b[i]\n  }\n  return s\n}\n\nconst euclideanDist = (a: number[], b: number[]): number => {\n  let s = 0\n  for (const [i, element] of a.entries()) {\n    const d = element - b[i]\n    s += d * d\n  }\n  return Math.sqrt(s)\n}\n\nconst computeScore = (vec: number[], query: number[], metric: DistanceMetric): number => {\n  if (metric === 'cosine') {\n    const raw = cosineSim(vec, query)\n    return normalizeScore(raw, 'cosine', 'similarity')\n  } else if (metric === 'dot') {\n    const raw = dotProd(vec, query)\n    return normalizeScore(raw, 'dot', 'similarity')\n  } else if (metric === 'euclidean') {\n    const raw = euclideanDist(vec, query)\n    return normalizeScore(raw, 'euclidean', 'distance')\n  } else {\n    // Fallback\n    const raw = cosineSim(vec, query)\n    return normalizeScore(raw, 'cosine', 'similarity')\n  }\n}\n"],"mappings":"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"}