@nhtio/adk 1.20260604.0 → 1.20260607.0

package/batteries/vector/elasticsearch.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"elasticsearch.mjs","names":["#opts","#client","#ensure","#dims","#body","#project"],"sources":["../../../src/batteries/vector/elasticsearch/index.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/elasticsearch\n *\n * Elasticsearch 8 adapter — each collection is an index with a `dense_vector` field; KNN uses ES8's\n * top-level `knn` search clause with an optional `filter`; the neutral filter tree compiles to bool/term/range\n * over `metadata.*`. Distinct from the opensearch adapter (which speaks OpenSearch's `knn_vector`/`query.knn` dialect).\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 ElasticsearchVectorStoreOptions extends BaseVectorStoreOptions {\n  connection?: {\n    node?: string // default 'http://localhost:9200'\n    auth?: { username: string; password: string } | { apiKey: string }\n    client?: unknown // BYO @elastic/elasticsearch Client; overrides node\n  }\n}\n\nconst getElasticsearchClient = async () => {\n  try {\n    const mod = await import('@elastic/elasticsearch')\n    return mod.Client\n  } catch {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE(['@elastic/elasticsearch'])\n  }\n}\n\n// Elasticsearch similarity per metric.\nconst similarity = (metric: DistanceMetric): string =>\n  metric === 'cosine' ? 'cosine' : metric === 'dot' ? 'dot_product' : 'l2_norm'\n\n/**\n * Compile the neutral filter tree to an Elasticsearch bool-query clause over `metadata.*`.\n * String values use the `.keyword` sub-field for exact match; numbers use range/term.\n */\nexport const translateElasticsearchFilter = (\n  filter?: VectorFilter\n): Record<string, unknown> | undefined => {\n  if (!filter) return undefined\n  if (isRawFilter(filter)) {\n    if (filter.$dialect === 'elasticsearch' || filter.$dialect === 'opensearch') {\n      return filter.$raw as Record<string, unknown>\n    }\n    throw new E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR(['elasticsearch', 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(['elasticsearch', op])\n    }\n  }\n  if (isFilterGroup(filter)) {\n    const { and, or, not } = filter\n    if (and) {\n      const must = and.map(translateElasticsearchFilter).filter(Boolean)\n      return { bool: { must } }\n    }\n    if (or) {\n      const should = or.map(translateElasticsearchFilter).filter(Boolean)\n      return { bool: { should, minimum_should_match: 1 } }\n    }\n    if (not) {\n      const inner = translateElasticsearchFilter(not)\n      return inner ? { bool: { must_not: [inner] } } : undefined\n    }\n  }\n  return undefined\n}\n\nexport class ElasticsearchVectorStore 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(): ElasticsearchVectorStoreOptions {\n    return this.options as ElasticsearchVectorStoreOptions\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 getElasticsearchClient()\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        mappings: {\n          properties: {\n            vec: {\n              type: 'dense_vector',\n              dims: spec.vector.dimensions,\n              index: true,\n              similarity: similarity(spec.vector.metric),\n            },\n            document: { type: 'text' },\n            metadata: { type: 'object', enabled: true },\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', 'elasticsearch'])\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({ 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 = translateElasticsearchFilter(plan.filter)\n    const size = plan.topK\n    const from = plan.offset ?? 0\n    try {\n      let res: any\n      if (queryVector) {\n        const knn: any = {\n          field: 'vec',\n          query_vector: queryVector,\n          k: size + from,\n          num_candidates: Math.max((size + from) * 10, 100),\n        }\n        if (filter) knn.filter = filter\n        res = await client.search({ index: plan.collection, knn, size, from, _source: true })\n      } else {\n        res = await client.search({\n          index: plan.collection,\n          size,\n          from,\n          query: filter ?? { match_all: {} },\n        })\n      }\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      // Elasticsearch cosine _score is already (sim+1)/2 ∈ [0,1]; 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({ operations, refresh: true })\n      } else if (plan.filter) {\n        const filter = translateElasticsearchFilter(plan.filter)\n        await client.deleteByQuery({\n          index: plan.collection,\n          refresh: true,\n          query: filter ?? { match_all: {} },\n        })\n      } else {\n        await client.deleteByQuery({\n          index: plan.collection,\n          refresh: true,\n          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/exceptions.cjs

@@ -0,0 +1,126 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Ble4zEEl.js");
+const require_exceptions = require("../../exceptions-CitH5wZI.js");
+require("../../factories.cjs");
+//#region src/batteries/vector/exceptions.ts
+/**
+* Battery-scoped exception constructors for vector store adapter failures.
+*
+* @module @nhtio/adk/batteries/vector/exceptions
+*
+* @remarks
+* Battery-scoped exception classes for the vector store battery. These exceptions are owned
+* by the battery (not the ADK core) and are minted via `createException` from
+* `@nhtio/adk/factories`. Re-exported from the battery's barrel.
+*/
+/**
+* Thrown when the vector store configuration fails validation.
+* Fatal: config bugs fail loud at construction time.
+*/
+var E_INVALID_VECTOR_STORE_CONFIG = require_exceptions.createException("E_INVALID_VECTOR_STORE_CONFIG", "Invalid vector store config: %s", "E_INVALID_VECTOR_STORE_CONFIG", 529, true);
+/**
+* Thrown when the vector store driver is unavailable.
+* Fatal: driver failures are critical.
+*/
+var E_VECTOR_STORE_DRIVER_UNAVAILABLE = require_exceptions.createException("E_VECTOR_STORE_DRIVER_UNAVAILABLE", "Vector store driver unavailable: %s", "E_VECTOR_STORE_DRIVER_UNAVAILABLE", 503, true);
+/**
+* Thrown when the vector store adapter receives text input but has no encoder and no built-in encoding.
+* Fatal: encoding is required for vector operations.
+*/
+var E_VECTOR_STORE_ENCODER_REQUIRED = require_exceptions.createException("E_VECTOR_STORE_ENCODER_REQUIRED", "Vector store adapter \"%s\" received text input but has no encoder and no built-in encoding; supply an encoder or pass a precomputed vector", "E_VECTOR_STORE_ENCODER_REQUIRED", 529, true);
+/**
+* Thrown when a vector's dimension does not match the expected dimension.
+* Fatal: dimension mismatch indicates incompatible data.
+*/
+var E_VECTOR_STORE_DIMENSION_MISMATCH = require_exceptions.createException("E_VECTOR_STORE_DIMENSION_MISMATCH", "Vector dimension mismatch: expected %d, got %d", "E_VECTOR_STORE_DIMENSION_MISMATCH", 529, true);
+/**
+* Thrown when a filter operator/dialect is unsupported by the adapter.
+* Fatal: unsupported filter dialects cannot be processed.
+*/
+var E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR = require_exceptions.createException("E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR", "Filter operator/dialect unsupported by adapter \"%s\": %s", "E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR", 529, true);
+/**
+* Thrown when an operation is unsupported by the adapter.
+* Fatal: unsupported operations cannot be performed.
+*/
+var E_VECTOR_STORE_UNSUPPORTED_OPERATION = require_exceptions.createException("E_VECTOR_STORE_UNSUPPORTED_OPERATION", "Operation \"%s\" is unsupported by adapter \"%s\"", "E_VECTOR_STORE_UNSUPPORTED_OPERATION", 529, true);
+/**
+* Thrown when the query builder is in a conflicting state.
+* Fatal: conflicting state indicates programming errors.
+*/
+var E_VECTOR_STORE_QUERY_CONFLICT = require_exceptions.createException("E_VECTOR_STORE_QUERY_CONFLICT", "Conflicting query builder state: %s", "E_VECTOR_STORE_QUERY_CONFLICT", 529, true);
+/**
+* Thrown when a read operation requires an explicit select projection.
+* Fatal: projection is required for read operations.
+*/
+var E_VECTOR_STORE_PROJECTION_REQUIRED = require_exceptions.createException("E_VECTOR_STORE_PROJECTION_REQUIRED", "A read requires an explicit .select() projection", "E_VECTOR_STORE_PROJECTION_REQUIRED", 529, true);
+/**
+* Thrown when the adapter does not support transactions.
+* Fatal: transaction support is required for the requested operation.
+*/
+var E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED = require_exceptions.createException("E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED", "Adapter \"%s\" does not support transactions", "E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED", 529, true);
+/**
+* Thrown when the raw fragment placeholder count does not match the bindings length.
+* Fatal: binding mismatch indicates query construction errors.
+*/
+var E_VECTOR_STORE_RAW_BINDING_MISMATCH = require_exceptions.createException("E_VECTOR_STORE_RAW_BINDING_MISMATCH", "Raw fragment placeholder count (%d) does not match bindings length (%d)", "E_VECTOR_STORE_RAW_BINDING_MISMATCH", 529, true);
+/**
+* Thrown when a vector record at a specific index is invalid.
+* Fatal: invalid records cannot be processed.
+*/
+var E_INVALID_VECTOR_RECORD = require_exceptions.createException("E_INVALID_VECTOR_RECORD", "Invalid vector record at index %d: %s", "E_INVALID_VECTOR_RECORD", 529, true);
+/**
+* Thrown when a vector store operation cannot be confirmed with strong consistency within the bound.
+* Fatal: strong mode requires confirmation; timeout indicates a backend consistency issue.
+*/
+var E_VECTOR_STORE_CONSISTENCY_TIMEOUT = require_exceptions.createException("E_VECTOR_STORE_CONSISTENCY_TIMEOUT", "Strong consistency could not be confirmed within the bound: %s", "E_VECTOR_STORE_CONSISTENCY_TIMEOUT", 504, false);
+/**
+* Thrown when a migration fails.
+* Non-fatal: migration failures are recoverable.
+*/
+var E_VECTOR_STORE_MIGRATION_FAILED = require_exceptions.createException("E_VECTOR_STORE_MIGRATION_FAILED", "Migration \"%s\" failed: %s", "E_VECTOR_STORE_MIGRATION_FAILED", 502, false);
+/**
+* Thrown when a vector store connection fails.
+* Non-fatal: connection failures are recoverable.
+*/
+var E_VECTOR_STORE_CONNECTION_FAILED = require_exceptions.createException("E_VECTOR_STORE_CONNECTION_FAILED", "Vector store connection failed: %s", "E_VECTOR_STORE_CONNECTION_FAILED", 502, false);
+/**
+* Thrown when a collection operation fails.
+* Non-fatal: collection operation failures are recoverable.
+*/
+var E_VECTOR_STORE_COLLECTION_FAILED = require_exceptions.createException("E_VECTOR_STORE_COLLECTION_FAILED", "Collection operation \"%s\" failed: %s", "E_VECTOR_STORE_COLLECTION_FAILED", 502, false);
+/**
+* Thrown when a vector upsert fails.
+* Non-fatal: upsert failures are recoverable.
+*/
+var E_VECTOR_STORE_UPSERT_FAILED = require_exceptions.createException("E_VECTOR_STORE_UPSERT_FAILED", "Vector upsert failed: %s", "E_VECTOR_STORE_UPSERT_FAILED", 502, false);
+/**
+* Thrown when a vector search fails.
+* Non-fatal: search failures are recoverable.
+*/
+var E_VECTOR_STORE_SEARCH_FAILED = require_exceptions.createException("E_VECTOR_STORE_SEARCH_FAILED", "Vector search failed: %s", "E_VECTOR_STORE_SEARCH_FAILED", 502, false);
+/**
+* Thrown when a vector delete fails.
+* Non-fatal: delete failures are recoverable.
+*/
+var E_VECTOR_STORE_DELETE_FAILED = require_exceptions.createException("E_VECTOR_STORE_DELETE_FAILED", "Vector delete failed: %s", "E_VECTOR_STORE_DELETE_FAILED", 502, false);
+//#endregion
+exports.E_INVALID_VECTOR_RECORD = E_INVALID_VECTOR_RECORD;
+exports.E_INVALID_VECTOR_STORE_CONFIG = E_INVALID_VECTOR_STORE_CONFIG;
+exports.E_VECTOR_STORE_COLLECTION_FAILED = E_VECTOR_STORE_COLLECTION_FAILED;
+exports.E_VECTOR_STORE_CONNECTION_FAILED = E_VECTOR_STORE_CONNECTION_FAILED;
+exports.E_VECTOR_STORE_CONSISTENCY_TIMEOUT = E_VECTOR_STORE_CONSISTENCY_TIMEOUT;
+exports.E_VECTOR_STORE_DELETE_FAILED = E_VECTOR_STORE_DELETE_FAILED;
+exports.E_VECTOR_STORE_DIMENSION_MISMATCH = E_VECTOR_STORE_DIMENSION_MISMATCH;
+exports.E_VECTOR_STORE_DRIVER_UNAVAILABLE = E_VECTOR_STORE_DRIVER_UNAVAILABLE;
+exports.E_VECTOR_STORE_ENCODER_REQUIRED = E_VECTOR_STORE_ENCODER_REQUIRED;
+exports.E_VECTOR_STORE_MIGRATION_FAILED = E_VECTOR_STORE_MIGRATION_FAILED;
+exports.E_VECTOR_STORE_PROJECTION_REQUIRED = E_VECTOR_STORE_PROJECTION_REQUIRED;
+exports.E_VECTOR_STORE_QUERY_CONFLICT = E_VECTOR_STORE_QUERY_CONFLICT;
+exports.E_VECTOR_STORE_RAW_BINDING_MISMATCH = E_VECTOR_STORE_RAW_BINDING_MISMATCH;
+exports.E_VECTOR_STORE_SEARCH_FAILED = E_VECTOR_STORE_SEARCH_FAILED;
+exports.E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED = E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED;
+exports.E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR = E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR;
+exports.E_VECTOR_STORE_UNSUPPORTED_OPERATION = E_VECTOR_STORE_UNSUPPORTED_OPERATION;
+exports.E_VECTOR_STORE_UPSERT_FAILED = E_VECTOR_STORE_UPSERT_FAILED;
+
+//# sourceMappingURL=exceptions.cjs.map

package/batteries/vector/exceptions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.cjs","names":[],"sources":["../../../src/batteries/vector/exceptions.ts"],"sourcesContent":["/**\n * Battery-scoped exception constructors for vector store adapter failures.\n *\n * @module @nhtio/adk/batteries/vector/exceptions\n *\n * @remarks\n * Battery-scoped exception classes for the vector store battery. These exceptions are owned\n * by the battery (not the ADK core) and are minted via `createException` from\n * `@nhtio/adk/factories`. Re-exported from the battery's barrel.\n */\n\nimport { createException } from '@nhtio/adk/factories'\n\n/**\n * Thrown when the vector store configuration fails validation.\n * Fatal: config bugs fail loud at construction time.\n */\nexport const E_INVALID_VECTOR_STORE_CONFIG = createException<[string]>(\n  'E_INVALID_VECTOR_STORE_CONFIG',\n  'Invalid vector store config: %s',\n  'E_INVALID_VECTOR_STORE_CONFIG',\n  529,\n  true\n)\n\n/**\n * Thrown when the vector store driver is unavailable.\n * Fatal: driver failures are critical.\n */\nexport const E_VECTOR_STORE_DRIVER_UNAVAILABLE = createException<[string]>(\n  'E_VECTOR_STORE_DRIVER_UNAVAILABLE',\n  'Vector store driver unavailable: %s',\n  'E_VECTOR_STORE_DRIVER_UNAVAILABLE',\n  503,\n  true\n)\n\n/**\n * Thrown when the vector store adapter receives text input but has no encoder and no built-in encoding.\n * Fatal: encoding is required for vector operations.\n */\nexport const E_VECTOR_STORE_ENCODER_REQUIRED = createException<[string]>(\n  'E_VECTOR_STORE_ENCODER_REQUIRED',\n  'Vector store adapter \"%s\" received text input but has no encoder and no built-in encoding; supply an encoder or pass a precomputed vector',\n  'E_VECTOR_STORE_ENCODER_REQUIRED',\n  529,\n  true\n)\n\n/**\n * Thrown when a vector's dimension does not match the expected dimension.\n * Fatal: dimension mismatch indicates incompatible data.\n */\nexport const E_VECTOR_STORE_DIMENSION_MISMATCH = createException<[number, number]>(\n  'E_VECTOR_STORE_DIMENSION_MISMATCH',\n  'Vector dimension mismatch: expected %d, got %d',\n  'E_VECTOR_STORE_DIMENSION_MISMATCH',\n  529,\n  true\n)\n\n/**\n * Thrown when a filter operator/dialect is unsupported by the adapter.\n * Fatal: unsupported filter dialects cannot be processed.\n */\nexport const E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR = createException<[string, string]>(\n  'E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR',\n  'Filter operator/dialect unsupported by adapter \"%s\": %s',\n  'E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR',\n  529,\n  true\n)\n\n/**\n * Thrown when an operation is unsupported by the adapter.\n * Fatal: unsupported operations cannot be performed.\n */\nexport const E_VECTOR_STORE_UNSUPPORTED_OPERATION = createException<[string, string]>(\n  'E_VECTOR_STORE_UNSUPPORTED_OPERATION',\n  'Operation \"%s\" is unsupported by adapter \"%s\"',\n  'E_VECTOR_STORE_UNSUPPORTED_OPERATION',\n  529,\n  true\n)\n\n/**\n * Thrown when the query builder is in a conflicting state.\n * Fatal: conflicting state indicates programming errors.\n */\nexport const E_VECTOR_STORE_QUERY_CONFLICT = createException<[string]>(\n  'E_VECTOR_STORE_QUERY_CONFLICT',\n  'Conflicting query builder state: %s',\n  'E_VECTOR_STORE_QUERY_CONFLICT',\n  529,\n  true\n)\n\n/**\n * Thrown when a read operation requires an explicit select projection.\n * Fatal: projection is required for read operations.\n */\nexport const E_VECTOR_STORE_PROJECTION_REQUIRED = createException<[]>(\n  'E_VECTOR_STORE_PROJECTION_REQUIRED',\n  'A read requires an explicit .select() projection',\n  'E_VECTOR_STORE_PROJECTION_REQUIRED',\n  529,\n  true\n)\n\n/**\n * Thrown when the adapter does not support transactions.\n * Fatal: transaction support is required for the requested operation.\n */\nexport const E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED = createException<[string]>(\n  'E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED',\n  'Adapter \"%s\" does not support transactions',\n  'E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED',\n  529,\n  true\n)\n\n/**\n * Thrown when the raw fragment placeholder count does not match the bindings length.\n * Fatal: binding mismatch indicates query construction errors.\n */\nexport const E_VECTOR_STORE_RAW_BINDING_MISMATCH = createException<[number, number]>(\n  'E_VECTOR_STORE_RAW_BINDING_MISMATCH',\n  'Raw fragment placeholder count (%d) does not match bindings length (%d)',\n  'E_VECTOR_STORE_RAW_BINDING_MISMATCH',\n  529,\n  true\n)\n\n/**\n * Thrown when a vector record at a specific index is invalid.\n * Fatal: invalid records cannot be processed.\n */\nexport const E_INVALID_VECTOR_RECORD = createException<[number, string]>(\n  'E_INVALID_VECTOR_RECORD',\n  'Invalid vector record at index %d: %s',\n  'E_INVALID_VECTOR_RECORD',\n  529,\n  true\n)\n\n/**\n * Thrown when a vector store operation cannot be confirmed with strong consistency within the bound.\n * Fatal: strong mode requires confirmation; timeout indicates a backend consistency issue.\n */\nexport const E_VECTOR_STORE_CONSISTENCY_TIMEOUT = createException<[string]>(\n  'E_VECTOR_STORE_CONSISTENCY_TIMEOUT',\n  'Strong consistency could not be confirmed within the bound: %s',\n  'E_VECTOR_STORE_CONSISTENCY_TIMEOUT',\n  504,\n  false\n)\n\n/**\n * Thrown when a migration fails.\n * Non-fatal: migration failures are recoverable.\n */\nexport const E_VECTOR_STORE_MIGRATION_FAILED = createException<[string, string]>(\n  'E_VECTOR_STORE_MIGRATION_FAILED',\n  'Migration \"%s\" failed: %s',\n  'E_VECTOR_STORE_MIGRATION_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector store connection fails.\n * Non-fatal: connection failures are recoverable.\n */\nexport const E_VECTOR_STORE_CONNECTION_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_CONNECTION_FAILED',\n  'Vector store connection failed: %s',\n  'E_VECTOR_STORE_CONNECTION_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a collection operation fails.\n * Non-fatal: collection operation failures are recoverable.\n */\nexport const E_VECTOR_STORE_COLLECTION_FAILED = createException<[string, string]>(\n  'E_VECTOR_STORE_COLLECTION_FAILED',\n  'Collection operation \"%s\" failed: %s',\n  'E_VECTOR_STORE_COLLECTION_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector upsert fails.\n * Non-fatal: upsert failures are recoverable.\n */\nexport const E_VECTOR_STORE_UPSERT_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_UPSERT_FAILED',\n  'Vector upsert failed: %s',\n  'E_VECTOR_STORE_UPSERT_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector search fails.\n * Non-fatal: search failures are recoverable.\n */\nexport const E_VECTOR_STORE_SEARCH_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_SEARCH_FAILED',\n  'Vector search failed: %s',\n  'E_VECTOR_STORE_SEARCH_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector delete fails.\n * Non-fatal: delete failures are recoverable.\n */\nexport const E_VECTOR_STORE_DELETE_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_DELETE_FAILED',\n  'Vector delete failed: %s',\n  'E_VECTOR_STORE_DELETE_FAILED',\n  502,\n  false\n)\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,IAAa,gCAAgC,mBAAA,gBAC3C,iCACA,mCACA,iCACA,KACA,IACF;;;;;AAMA,IAAa,oCAAoC,mBAAA,gBAC/C,qCACA,uCACA,qCACA,KACA,IACF;;;;;AAMA,IAAa,kCAAkC,mBAAA,gBAC7C,mCACA,+IACA,mCACA,KACA,IACF;;;;;AAMA,IAAa,oCAAoC,mBAAA,gBAC/C,qCACA,kDACA,qCACA,KACA,IACF;;;;;AAMA,IAAa,6CAA6C,mBAAA,gBACxD,8CACA,6DACA,8CACA,KACA,IACF;;;;;AAMA,IAAa,uCAAuC,mBAAA,gBAClD,wCACA,qDACA,wCACA,KACA,IACF;;;;;AAMA,IAAa,gCAAgC,mBAAA,gBAC3C,iCACA,uCACA,iCACA,KACA,IACF;;;;;AAMA,IAAa,qCAAqC,mBAAA,gBAChD,sCACA,oDACA,sCACA,KACA,IACF;;;;;AAMA,IAAa,0CAA0C,mBAAA,gBACrD,2CACA,gDACA,2CACA,KACA,IACF;;;;;AAMA,IAAa,sCAAsC,mBAAA,gBACjD,uCACA,2EACA,uCACA,KACA,IACF;;;;;AAMA,IAAa,0BAA0B,mBAAA,gBACrC,2BACA,yCACA,2BACA,KACA,IACF;;;;;AAMA,IAAa,qCAAqC,mBAAA,gBAChD,sCACA,kEACA,sCACA,KACA,KACF;;;;;AAMA,IAAa,kCAAkC,mBAAA,gBAC7C,mCACA,+BACA,mCACA,KACA,KACF;;;;;AAMA,IAAa,mCAAmC,mBAAA,gBAC9C,oCACA,sCACA,oCACA,KACA,KACF;;;;;AAMA,IAAa,mCAAmC,mBAAA,gBAC9C,oCACA,0CACA,oCACA,KACA,KACF;;;;;AAMA,IAAa,+BAA+B,mBAAA,gBAC1C,gCACA,4BACA,gCACA,KACA,KACF;;;;;AAMA,IAAa,+BAA+B,mBAAA,gBAC1C,gCACA,4BACA,gCACA,KACA,KACF;;;;;AAMA,IAAa,+BAA+B,mBAAA,gBAC1C,gCACA,4BACA,gCACA,KACA,KACF"}

package/batteries/vector/exceptions.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Battery-scoped exception constructors for vector store adapter failures.
+ *
+ * @module @nhtio/adk/batteries/vector/exceptions
+ *
+ * @remarks
+ * Battery-scoped exception classes for the vector store battery. These exceptions are owned
+ * by the battery (not the ADK core) and are minted via `createException` from
+ * `@nhtio/adk/factories`. Re-exported from the battery's barrel.
+ */
+/**
+ * Thrown when the vector store configuration fails validation.
+ * Fatal: config bugs fail loud at construction time.
+ */
+export declare const E_INVALID_VECTOR_STORE_CONFIG: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when the vector store driver is unavailable.
+ * Fatal: driver failures are critical.
+ */
+export declare const E_VECTOR_STORE_DRIVER_UNAVAILABLE: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when the vector store adapter receives text input but has no encoder and no built-in encoding.
+ * Fatal: encoding is required for vector operations.
+ */
+export declare const E_VECTOR_STORE_ENCODER_REQUIRED: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when a vector's dimension does not match the expected dimension.
+ * Fatal: dimension mismatch indicates incompatible data.
+ */
+export declare const E_VECTOR_STORE_DIMENSION_MISMATCH: import("../../factories").CreatedException<[
+    number,
+    number
+]>;
+/**
+ * Thrown when a filter operator/dialect is unsupported by the adapter.
+ * Fatal: unsupported filter dialects cannot be processed.
+ */
+export declare const E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR: import("../../factories").CreatedException<[
+    string,
+    string
+]>;
+/**
+ * Thrown when an operation is unsupported by the adapter.
+ * Fatal: unsupported operations cannot be performed.
+ */
+export declare const E_VECTOR_STORE_UNSUPPORTED_OPERATION: import("../../factories").CreatedException<[
+    string,
+    string
+]>;
+/**
+ * Thrown when the query builder is in a conflicting state.
+ * Fatal: conflicting state indicates programming errors.
+ */
+export declare const E_VECTOR_STORE_QUERY_CONFLICT: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when a read operation requires an explicit select projection.
+ * Fatal: projection is required for read operations.
+ */
+export declare const E_VECTOR_STORE_PROJECTION_REQUIRED: import("../../factories").CreatedException<[
+]>;
+/**
+ * Thrown when the adapter does not support transactions.
+ * Fatal: transaction support is required for the requested operation.
+ */
+export declare const E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when the raw fragment placeholder count does not match the bindings length.
+ * Fatal: binding mismatch indicates query construction errors.
+ */
+export declare const E_VECTOR_STORE_RAW_BINDING_MISMATCH: import("../../factories").CreatedException<[
+    number,
+    number
+]>;
+/**
+ * Thrown when a vector record at a specific index is invalid.
+ * Fatal: invalid records cannot be processed.
+ */
+export declare const E_INVALID_VECTOR_RECORD: import("../../factories").CreatedException<[
+    number,
+    string
+]>;
+/**
+ * Thrown when a vector store operation cannot be confirmed with strong consistency within the bound.
+ * Fatal: strong mode requires confirmation; timeout indicates a backend consistency issue.
+ */
+export declare const E_VECTOR_STORE_CONSISTENCY_TIMEOUT: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when a migration fails.
+ * Non-fatal: migration failures are recoverable.
+ */
+export declare const E_VECTOR_STORE_MIGRATION_FAILED: import("../../factories").CreatedException<[
+    string,
+    string
+]>;
+/**
+ * Thrown when a vector store connection fails.
+ * Non-fatal: connection failures are recoverable.
+ */
+export declare const E_VECTOR_STORE_CONNECTION_FAILED: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when a collection operation fails.
+ * Non-fatal: collection operation failures are recoverable.
+ */
+export declare const E_VECTOR_STORE_COLLECTION_FAILED: import("../../factories").CreatedException<[
+    string,
+    string
+]>;
+/**
+ * Thrown when a vector upsert fails.
+ * Non-fatal: upsert failures are recoverable.
+ */
+export declare const E_VECTOR_STORE_UPSERT_FAILED: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when a vector search fails.
+ * Non-fatal: search failures are recoverable.
+ */
+export declare const E_VECTOR_STORE_SEARCH_FAILED: import("../../factories").CreatedException<[
+    string
+]>;
+/**
+ * Thrown when a vector delete fails.
+ * Non-fatal: delete failures are recoverable.
+ */
+export declare const E_VECTOR_STORE_DELETE_FAILED: import("../../factories").CreatedException<[
+    string
+]>;

package/batteries/vector/exceptions.mjs

@@ -0,0 +1,107 @@
+import { t as createException } from "../../exceptions-BeWH2FwP.mjs";
+import "../../factories.mjs";
+//#region src/batteries/vector/exceptions.ts
+/**
+* Battery-scoped exception constructors for vector store adapter failures.
+*
+* @module @nhtio/adk/batteries/vector/exceptions
+*
+* @remarks
+* Battery-scoped exception classes for the vector store battery. These exceptions are owned
+* by the battery (not the ADK core) and are minted via `createException` from
+* `@nhtio/adk/factories`. Re-exported from the battery's barrel.
+*/
+/**
+* Thrown when the vector store configuration fails validation.
+* Fatal: config bugs fail loud at construction time.
+*/
+var E_INVALID_VECTOR_STORE_CONFIG = createException("E_INVALID_VECTOR_STORE_CONFIG", "Invalid vector store config: %s", "E_INVALID_VECTOR_STORE_CONFIG", 529, true);
+/**
+* Thrown when the vector store driver is unavailable.
+* Fatal: driver failures are critical.
+*/
+var E_VECTOR_STORE_DRIVER_UNAVAILABLE = createException("E_VECTOR_STORE_DRIVER_UNAVAILABLE", "Vector store driver unavailable: %s", "E_VECTOR_STORE_DRIVER_UNAVAILABLE", 503, true);
+/**
+* Thrown when the vector store adapter receives text input but has no encoder and no built-in encoding.
+* Fatal: encoding is required for vector operations.
+*/
+var E_VECTOR_STORE_ENCODER_REQUIRED = createException("E_VECTOR_STORE_ENCODER_REQUIRED", "Vector store adapter \"%s\" received text input but has no encoder and no built-in encoding; supply an encoder or pass a precomputed vector", "E_VECTOR_STORE_ENCODER_REQUIRED", 529, true);
+/**
+* Thrown when a vector's dimension does not match the expected dimension.
+* Fatal: dimension mismatch indicates incompatible data.
+*/
+var E_VECTOR_STORE_DIMENSION_MISMATCH = createException("E_VECTOR_STORE_DIMENSION_MISMATCH", "Vector dimension mismatch: expected %d, got %d", "E_VECTOR_STORE_DIMENSION_MISMATCH", 529, true);
+/**
+* Thrown when a filter operator/dialect is unsupported by the adapter.
+* Fatal: unsupported filter dialects cannot be processed.
+*/
+var E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR = createException("E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR", "Filter operator/dialect unsupported by adapter \"%s\": %s", "E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR", 529, true);
+/**
+* Thrown when an operation is unsupported by the adapter.
+* Fatal: unsupported operations cannot be performed.
+*/
+var E_VECTOR_STORE_UNSUPPORTED_OPERATION = createException("E_VECTOR_STORE_UNSUPPORTED_OPERATION", "Operation \"%s\" is unsupported by adapter \"%s\"", "E_VECTOR_STORE_UNSUPPORTED_OPERATION", 529, true);
+/**
+* Thrown when the query builder is in a conflicting state.
+* Fatal: conflicting state indicates programming errors.
+*/
+var E_VECTOR_STORE_QUERY_CONFLICT = createException("E_VECTOR_STORE_QUERY_CONFLICT", "Conflicting query builder state: %s", "E_VECTOR_STORE_QUERY_CONFLICT", 529, true);
+/**
+* Thrown when a read operation requires an explicit select projection.
+* Fatal: projection is required for read operations.
+*/
+var E_VECTOR_STORE_PROJECTION_REQUIRED = createException("E_VECTOR_STORE_PROJECTION_REQUIRED", "A read requires an explicit .select() projection", "E_VECTOR_STORE_PROJECTION_REQUIRED", 529, true);
+/**
+* Thrown when the adapter does not support transactions.
+* Fatal: transaction support is required for the requested operation.
+*/
+var E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED = createException("E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED", "Adapter \"%s\" does not support transactions", "E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED", 529, true);
+/**
+* Thrown when the raw fragment placeholder count does not match the bindings length.
+* Fatal: binding mismatch indicates query construction errors.
+*/
+var E_VECTOR_STORE_RAW_BINDING_MISMATCH = createException("E_VECTOR_STORE_RAW_BINDING_MISMATCH", "Raw fragment placeholder count (%d) does not match bindings length (%d)", "E_VECTOR_STORE_RAW_BINDING_MISMATCH", 529, true);
+/**
+* Thrown when a vector record at a specific index is invalid.
+* Fatal: invalid records cannot be processed.
+*/
+var E_INVALID_VECTOR_RECORD = createException("E_INVALID_VECTOR_RECORD", "Invalid vector record at index %d: %s", "E_INVALID_VECTOR_RECORD", 529, true);
+/**
+* Thrown when a vector store operation cannot be confirmed with strong consistency within the bound.
+* Fatal: strong mode requires confirmation; timeout indicates a backend consistency issue.
+*/
+var E_VECTOR_STORE_CONSISTENCY_TIMEOUT = createException("E_VECTOR_STORE_CONSISTENCY_TIMEOUT", "Strong consistency could not be confirmed within the bound: %s", "E_VECTOR_STORE_CONSISTENCY_TIMEOUT", 504, false);
+/**
+* Thrown when a migration fails.
+* Non-fatal: migration failures are recoverable.
+*/
+var E_VECTOR_STORE_MIGRATION_FAILED = createException("E_VECTOR_STORE_MIGRATION_FAILED", "Migration \"%s\" failed: %s", "E_VECTOR_STORE_MIGRATION_FAILED", 502, false);
+/**
+* Thrown when a vector store connection fails.
+* Non-fatal: connection failures are recoverable.
+*/
+var E_VECTOR_STORE_CONNECTION_FAILED = createException("E_VECTOR_STORE_CONNECTION_FAILED", "Vector store connection failed: %s", "E_VECTOR_STORE_CONNECTION_FAILED", 502, false);
+/**
+* Thrown when a collection operation fails.
+* Non-fatal: collection operation failures are recoverable.
+*/
+var E_VECTOR_STORE_COLLECTION_FAILED = createException("E_VECTOR_STORE_COLLECTION_FAILED", "Collection operation \"%s\" failed: %s", "E_VECTOR_STORE_COLLECTION_FAILED", 502, false);
+/**
+* Thrown when a vector upsert fails.
+* Non-fatal: upsert failures are recoverable.
+*/
+var E_VECTOR_STORE_UPSERT_FAILED = createException("E_VECTOR_STORE_UPSERT_FAILED", "Vector upsert failed: %s", "E_VECTOR_STORE_UPSERT_FAILED", 502, false);
+/**
+* Thrown when a vector search fails.
+* Non-fatal: search failures are recoverable.
+*/
+var E_VECTOR_STORE_SEARCH_FAILED = createException("E_VECTOR_STORE_SEARCH_FAILED", "Vector search failed: %s", "E_VECTOR_STORE_SEARCH_FAILED", 502, false);
+/**
+* Thrown when a vector delete fails.
+* Non-fatal: delete failures are recoverable.
+*/
+var E_VECTOR_STORE_DELETE_FAILED = createException("E_VECTOR_STORE_DELETE_FAILED", "Vector delete failed: %s", "E_VECTOR_STORE_DELETE_FAILED", 502, false);
+//#endregion
+export { E_INVALID_VECTOR_RECORD, E_INVALID_VECTOR_STORE_CONFIG, E_VECTOR_STORE_COLLECTION_FAILED, E_VECTOR_STORE_CONNECTION_FAILED, E_VECTOR_STORE_CONSISTENCY_TIMEOUT, E_VECTOR_STORE_DELETE_FAILED, E_VECTOR_STORE_DIMENSION_MISMATCH, E_VECTOR_STORE_DRIVER_UNAVAILABLE, E_VECTOR_STORE_ENCODER_REQUIRED, E_VECTOR_STORE_MIGRATION_FAILED, E_VECTOR_STORE_PROJECTION_REQUIRED, E_VECTOR_STORE_QUERY_CONFLICT, E_VECTOR_STORE_RAW_BINDING_MISMATCH, E_VECTOR_STORE_SEARCH_FAILED, E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED, E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR, E_VECTOR_STORE_UNSUPPORTED_OPERATION, E_VECTOR_STORE_UPSERT_FAILED };
+
+//# sourceMappingURL=exceptions.mjs.map

package/batteries/vector/exceptions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.mjs","names":[],"sources":["../../../src/batteries/vector/exceptions.ts"],"sourcesContent":["/**\n * Battery-scoped exception constructors for vector store adapter failures.\n *\n * @module @nhtio/adk/batteries/vector/exceptions\n *\n * @remarks\n * Battery-scoped exception classes for the vector store battery. These exceptions are owned\n * by the battery (not the ADK core) and are minted via `createException` from\n * `@nhtio/adk/factories`. Re-exported from the battery's barrel.\n */\n\nimport { createException } from '@nhtio/adk/factories'\n\n/**\n * Thrown when the vector store configuration fails validation.\n * Fatal: config bugs fail loud at construction time.\n */\nexport const E_INVALID_VECTOR_STORE_CONFIG = createException<[string]>(\n  'E_INVALID_VECTOR_STORE_CONFIG',\n  'Invalid vector store config: %s',\n  'E_INVALID_VECTOR_STORE_CONFIG',\n  529,\n  true\n)\n\n/**\n * Thrown when the vector store driver is unavailable.\n * Fatal: driver failures are critical.\n */\nexport const E_VECTOR_STORE_DRIVER_UNAVAILABLE = createException<[string]>(\n  'E_VECTOR_STORE_DRIVER_UNAVAILABLE',\n  'Vector store driver unavailable: %s',\n  'E_VECTOR_STORE_DRIVER_UNAVAILABLE',\n  503,\n  true\n)\n\n/**\n * Thrown when the vector store adapter receives text input but has no encoder and no built-in encoding.\n * Fatal: encoding is required for vector operations.\n */\nexport const E_VECTOR_STORE_ENCODER_REQUIRED = createException<[string]>(\n  'E_VECTOR_STORE_ENCODER_REQUIRED',\n  'Vector store adapter \"%s\" received text input but has no encoder and no built-in encoding; supply an encoder or pass a precomputed vector',\n  'E_VECTOR_STORE_ENCODER_REQUIRED',\n  529,\n  true\n)\n\n/**\n * Thrown when a vector's dimension does not match the expected dimension.\n * Fatal: dimension mismatch indicates incompatible data.\n */\nexport const E_VECTOR_STORE_DIMENSION_MISMATCH = createException<[number, number]>(\n  'E_VECTOR_STORE_DIMENSION_MISMATCH',\n  'Vector dimension mismatch: expected %d, got %d',\n  'E_VECTOR_STORE_DIMENSION_MISMATCH',\n  529,\n  true\n)\n\n/**\n * Thrown when a filter operator/dialect is unsupported by the adapter.\n * Fatal: unsupported filter dialects cannot be processed.\n */\nexport const E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR = createException<[string, string]>(\n  'E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR',\n  'Filter operator/dialect unsupported by adapter \"%s\": %s',\n  'E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR',\n  529,\n  true\n)\n\n/**\n * Thrown when an operation is unsupported by the adapter.\n * Fatal: unsupported operations cannot be performed.\n */\nexport const E_VECTOR_STORE_UNSUPPORTED_OPERATION = createException<[string, string]>(\n  'E_VECTOR_STORE_UNSUPPORTED_OPERATION',\n  'Operation \"%s\" is unsupported by adapter \"%s\"',\n  'E_VECTOR_STORE_UNSUPPORTED_OPERATION',\n  529,\n  true\n)\n\n/**\n * Thrown when the query builder is in a conflicting state.\n * Fatal: conflicting state indicates programming errors.\n */\nexport const E_VECTOR_STORE_QUERY_CONFLICT = createException<[string]>(\n  'E_VECTOR_STORE_QUERY_CONFLICT',\n  'Conflicting query builder state: %s',\n  'E_VECTOR_STORE_QUERY_CONFLICT',\n  529,\n  true\n)\n\n/**\n * Thrown when a read operation requires an explicit select projection.\n * Fatal: projection is required for read operations.\n */\nexport const E_VECTOR_STORE_PROJECTION_REQUIRED = createException<[]>(\n  'E_VECTOR_STORE_PROJECTION_REQUIRED',\n  'A read requires an explicit .select() projection',\n  'E_VECTOR_STORE_PROJECTION_REQUIRED',\n  529,\n  true\n)\n\n/**\n * Thrown when the adapter does not support transactions.\n * Fatal: transaction support is required for the requested operation.\n */\nexport const E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED = createException<[string]>(\n  'E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED',\n  'Adapter \"%s\" does not support transactions',\n  'E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED',\n  529,\n  true\n)\n\n/**\n * Thrown when the raw fragment placeholder count does not match the bindings length.\n * Fatal: binding mismatch indicates query construction errors.\n */\nexport const E_VECTOR_STORE_RAW_BINDING_MISMATCH = createException<[number, number]>(\n  'E_VECTOR_STORE_RAW_BINDING_MISMATCH',\n  'Raw fragment placeholder count (%d) does not match bindings length (%d)',\n  'E_VECTOR_STORE_RAW_BINDING_MISMATCH',\n  529,\n  true\n)\n\n/**\n * Thrown when a vector record at a specific index is invalid.\n * Fatal: invalid records cannot be processed.\n */\nexport const E_INVALID_VECTOR_RECORD = createException<[number, string]>(\n  'E_INVALID_VECTOR_RECORD',\n  'Invalid vector record at index %d: %s',\n  'E_INVALID_VECTOR_RECORD',\n  529,\n  true\n)\n\n/**\n * Thrown when a vector store operation cannot be confirmed with strong consistency within the bound.\n * Fatal: strong mode requires confirmation; timeout indicates a backend consistency issue.\n */\nexport const E_VECTOR_STORE_CONSISTENCY_TIMEOUT = createException<[string]>(\n  'E_VECTOR_STORE_CONSISTENCY_TIMEOUT',\n  'Strong consistency could not be confirmed within the bound: %s',\n  'E_VECTOR_STORE_CONSISTENCY_TIMEOUT',\n  504,\n  false\n)\n\n/**\n * Thrown when a migration fails.\n * Non-fatal: migration failures are recoverable.\n */\nexport const E_VECTOR_STORE_MIGRATION_FAILED = createException<[string, string]>(\n  'E_VECTOR_STORE_MIGRATION_FAILED',\n  'Migration \"%s\" failed: %s',\n  'E_VECTOR_STORE_MIGRATION_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector store connection fails.\n * Non-fatal: connection failures are recoverable.\n */\nexport const E_VECTOR_STORE_CONNECTION_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_CONNECTION_FAILED',\n  'Vector store connection failed: %s',\n  'E_VECTOR_STORE_CONNECTION_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a collection operation fails.\n * Non-fatal: collection operation failures are recoverable.\n */\nexport const E_VECTOR_STORE_COLLECTION_FAILED = createException<[string, string]>(\n  'E_VECTOR_STORE_COLLECTION_FAILED',\n  'Collection operation \"%s\" failed: %s',\n  'E_VECTOR_STORE_COLLECTION_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector upsert fails.\n * Non-fatal: upsert failures are recoverable.\n */\nexport const E_VECTOR_STORE_UPSERT_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_UPSERT_FAILED',\n  'Vector upsert failed: %s',\n  'E_VECTOR_STORE_UPSERT_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector search fails.\n * Non-fatal: search failures are recoverable.\n */\nexport const E_VECTOR_STORE_SEARCH_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_SEARCH_FAILED',\n  'Vector search failed: %s',\n  'E_VECTOR_STORE_SEARCH_FAILED',\n  502,\n  false\n)\n\n/**\n * Thrown when a vector delete fails.\n * Non-fatal: delete failures are recoverable.\n */\nexport const E_VECTOR_STORE_DELETE_FAILED = createException<[string]>(\n  'E_VECTOR_STORE_DELETE_FAILED',\n  'Vector delete failed: %s',\n  'E_VECTOR_STORE_DELETE_FAILED',\n  502,\n  false\n)\n"],"mappings":";;;;;;;;;;;;;;;;;AAiBA,IAAa,gCAAgC,gBAC3C,iCACA,mCACA,iCACA,KACA,IACF;;;;;AAMA,IAAa,oCAAoC,gBAC/C,qCACA,uCACA,qCACA,KACA,IACF;;;;;AAMA,IAAa,kCAAkC,gBAC7C,mCACA,+IACA,mCACA,KACA,IACF;;;;;AAMA,IAAa,oCAAoC,gBAC/C,qCACA,kDACA,qCACA,KACA,IACF;;;;;AAMA,IAAa,6CAA6C,gBACxD,8CACA,6DACA,8CACA,KACA,IACF;;;;;AAMA,IAAa,uCAAuC,gBAClD,wCACA,qDACA,wCACA,KACA,IACF;;;;;AAMA,IAAa,gCAAgC,gBAC3C,iCACA,uCACA,iCACA,KACA,IACF;;;;;AAMA,IAAa,qCAAqC,gBAChD,sCACA,oDACA,sCACA,KACA,IACF;;;;;AAMA,IAAa,0CAA0C,gBACrD,2CACA,gDACA,2CACA,KACA,IACF;;;;;AAMA,IAAa,sCAAsC,gBACjD,uCACA,2EACA,uCACA,KACA,IACF;;;;;AAMA,IAAa,0BAA0B,gBACrC,2BACA,yCACA,2BACA,KACA,IACF;;;;;AAMA,IAAa,qCAAqC,gBAChD,sCACA,kEACA,sCACA,KACA,KACF;;;;;AAMA,IAAa,kCAAkC,gBAC7C,mCACA,+BACA,mCACA,KACA,KACF;;;;;AAMA,IAAa,mCAAmC,gBAC9C,oCACA,sCACA,oCACA,KACA,KACF;;;;;AAMA,IAAa,mCAAmC,gBAC9C,oCACA,0CACA,oCACA,KACA,KACF;;;;;AAMA,IAAa,+BAA+B,gBAC1C,gCACA,4BACA,gCACA,KACA,KACF;;;;;AAMA,IAAa,+BAA+B,gBAC1C,gCACA,4BACA,gCACA,KACA,KACF;;;;;AAMA,IAAa,+BAA+B,gBAC1C,gCACA,4BACA,gCACA,KACA,KACF"}

package/batteries/vector/factory.cjs

@@ -0,0 +1,28 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../chunk-Ble4zEEl.js");
+const require_batteries_vector_exceptions = require("./exceptions.cjs");
+const require_batteries_vector_validation = require("./validation.cjs");
+//#region src/batteries/vector/factory.ts
+/**
+* @module @nhtio/adk/batteries/vector/factory
+*/
+/**
+* Build a callable store. Validate config; resolve the `client` (class | sync resolver | async
+* resolver) to a BaseVectorStore subclass ctor; optional availability gate; construct; return
+* asCallable(). Async so that `client: () => import('…')` can lazily load the adapter (and its
+* driver) only when the store is actually created.
+*/
+var createVectorStore = async (config) => {
+	require_batteries_vector_validation.validateCreateConfig(config);
+	const Ctor = await require_batteries_vector_validation.resolveClientCtor(config.client);
+	if (typeof Ctor.isAvailable === "function" && !Ctor.isAvailable()) throw new require_batteries_vector_exceptions.E_VECTOR_STORE_DRIVER_UNAVAILABLE([Ctor.name || "unknown"]);
+	return new Ctor(config.options).asCallable();
+};
+var encoderFromEmbeddings = (adapter) => {
+	return (texts, kind) => adapter.embedMany(texts, { kind });
+};
+//#endregion
+exports.createVectorStore = createVectorStore;
+exports.encoderFromEmbeddings = encoderFromEmbeddings;
+
+//# sourceMappingURL=factory.cjs.map

package/batteries/vector/factory.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.cjs","names":[],"sources":["../../../src/batteries/vector/factory.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/factory\n */\n\nimport { E_VECTOR_STORE_DRIVER_UNAVAILABLE } from './exceptions'\nimport { validateCreateConfig, resolveClientCtor } from './validation'\nimport type { CallableVectorStore, BaseVectorStore } from './contract'\nimport type { BaseVectorStoreOptions, VectorEncoderFn, EncodeKind } from './types'\n\n// The adapter class shape the factory accepts as 'client'.\nexport interface VectorStoreConstructor<O extends BaseVectorStoreOptions = BaseVectorStoreOptions> {\n  new (options: O): BaseVectorStore\n  isAvailable?: () => boolean\n}\n\n/**\n * `client` is one of:\n *   - the adapter class itself          — `QdrantVectorStore`\n *   - a sync resolver                   — `() => QdrantVectorStore`\n *   - an async resolver / dynamic import — `() => import('…/qdrant').then(m => m.QdrantVectorStore)`\n * A resolver may also return a module namespace whose `default` is the class.\n */\nexport type VectorStoreClient<O extends BaseVectorStoreOptions = BaseVectorStoreOptions> =\n  | VectorStoreConstructor<O>\n  | (() => VectorStoreConstructor<O> | { default: VectorStoreConstructor<O> })\n  | (() => Promise<VectorStoreConstructor<O> | { default: VectorStoreConstructor<O> }>)\n\nexport interface CreateVectorStoreConfig<\n  O extends BaseVectorStoreOptions = BaseVectorStoreOptions,\n> {\n  client: VectorStoreClient<O>\n  options: O\n}\n\n/**\n * Build a callable store. Validate config; resolve the `client` (class | sync resolver | async\n * resolver) to a BaseVectorStore subclass ctor; optional availability gate; construct; return\n * asCallable(). Async so that `client: () => import('…')` can lazily load the adapter (and its\n * driver) only when the store is actually created.\n */\nexport const createVectorStore = async <O extends BaseVectorStoreOptions = BaseVectorStoreOptions>(\n  config: CreateVectorStoreConfig<O>\n): Promise<CallableVectorStore> => {\n  validateCreateConfig(config)\n  const Ctor = (await resolveClientCtor(config.client)) as VectorStoreConstructor<O>\n  if (typeof Ctor.isAvailable === 'function' && !Ctor.isAvailable()) {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE([Ctor.name || 'unknown'])\n  }\n  const instance = new Ctor(config.options)\n  return instance.asCallable() as CallableVectorStore\n}\n\n// Helper: adapt an embeddings-battery-shaped object (has embedMany(texts, { kind })) into a VectorEncoderFn.\n// The embeddings adapters expose: embedMany(texts: string[], opts?: { kind?: 'query'|'document' }): Promise<number[][]>\nexport interface EmbeddingsLike {\n  embedMany(texts: string[], opts?: { kind?: EncodeKind }): Promise<number[][]>\n}\nexport const encoderFromEmbeddings = (adapter: EmbeddingsLike): VectorEncoderFn => {\n  return (texts: string[], kind: EncodeKind) => adapter.embedMany(texts, { kind })\n}\n"],"mappings":";;;;;;;;;;;;;;AAwCA,IAAa,oBAAoB,OAC/B,WACiC;CACjC,oCAAA,qBAAqB,MAAM;CAC3B,MAAM,OAAQ,MAAM,oCAAA,kBAAkB,OAAO,MAAM;CACnD,IAAI,OAAO,KAAK,gBAAgB,cAAc,CAAC,KAAK,YAAY,GAC9D,MAAM,IAAI,oCAAA,kCAAkC,CAAC,KAAK,QAAQ,SAAS,CAAC;CAGtE,OAAO,IADc,KAAK,OAAO,OAC1B,EAAS,WAAW;AAC7B;AAOA,IAAa,yBAAyB,YAA6C;CACjF,QAAQ,OAAiB,SAAqB,QAAQ,UAAU,OAAO,EAAE,KAAK,CAAC;AACjF"}

package/batteries/vector/factory.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @module @nhtio/adk/batteries/vector/factory
+ */
+import type { CallableVectorStore, BaseVectorStore } from "./contract";
+import type { BaseVectorStoreOptions, VectorEncoderFn, EncodeKind } from "./types";
+export interface VectorStoreConstructor<O extends BaseVectorStoreOptions = BaseVectorStoreOptions> {
+    new (options: O): BaseVectorStore;
+    isAvailable?: () => boolean;
+}
+/**
+ * `client` is one of:
+ *   - the adapter class itself          — `QdrantVectorStore`
+ *   - a sync resolver                   — `() => QdrantVectorStore`
+ *   - an async resolver / dynamic import — `() => import('…/qdrant').then(m => m.QdrantVectorStore)`
+ * A resolver may also return a module namespace whose `default` is the class.
+ */
+export type VectorStoreClient<O extends BaseVectorStoreOptions = BaseVectorStoreOptions> = VectorStoreConstructor<O> | (() => VectorStoreConstructor<O> | {
+    default: VectorStoreConstructor<O>;
+}) | (() => Promise<VectorStoreConstructor<O> | {
+    default: VectorStoreConstructor<O>;
+}>);
+export interface CreateVectorStoreConfig<O extends BaseVectorStoreOptions = BaseVectorStoreOptions> {
+    client: VectorStoreClient<O>;
+    options: O;
+}
+/**
+ * Build a callable store. Validate config; resolve the `client` (class | sync resolver | async
+ * resolver) to a BaseVectorStore subclass ctor; optional availability gate; construct; return
+ * asCallable(). Async so that `client: () => import('…')` can lazily load the adapter (and its
+ * driver) only when the store is actually created.
+ */
+export declare const createVectorStore: <O extends BaseVectorStoreOptions = BaseVectorStoreOptions>(config: CreateVectorStoreConfig<O>) => Promise<CallableVectorStore>;
+export interface EmbeddingsLike {
+    embedMany(texts: string[], opts?: {
+        kind?: EncodeKind;
+    }): Promise<number[][]>;
+}
+export declare const encoderFromEmbeddings: (adapter: EmbeddingsLike) => VectorEncoderFn;

package/batteries/vector/factory.mjs

@@ -0,0 +1,25 @@
+import { E_VECTOR_STORE_DRIVER_UNAVAILABLE } from "./exceptions.mjs";
+import { resolveClientCtor, validateCreateConfig } from "./validation.mjs";
+//#region src/batteries/vector/factory.ts
+/**
+* @module @nhtio/adk/batteries/vector/factory
+*/
+/**
+* Build a callable store. Validate config; resolve the `client` (class | sync resolver | async
+* resolver) to a BaseVectorStore subclass ctor; optional availability gate; construct; return
+* asCallable(). Async so that `client: () => import('…')` can lazily load the adapter (and its
+* driver) only when the store is actually created.
+*/
+var createVectorStore = async (config) => {
+	validateCreateConfig(config);
+	const Ctor = await resolveClientCtor(config.client);
+	if (typeof Ctor.isAvailable === "function" && !Ctor.isAvailable()) throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE([Ctor.name || "unknown"]);
+	return new Ctor(config.options).asCallable();
+};
+var encoderFromEmbeddings = (adapter) => {
+	return (texts, kind) => adapter.embedMany(texts, { kind });
+};
+//#endregion
+export { createVectorStore, encoderFromEmbeddings };
+
+//# sourceMappingURL=factory.mjs.map

package/batteries/vector/factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.mjs","names":[],"sources":["../../../src/batteries/vector/factory.ts"],"sourcesContent":["/**\n * @module @nhtio/adk/batteries/vector/factory\n */\n\nimport { E_VECTOR_STORE_DRIVER_UNAVAILABLE } from './exceptions'\nimport { validateCreateConfig, resolveClientCtor } from './validation'\nimport type { CallableVectorStore, BaseVectorStore } from './contract'\nimport type { BaseVectorStoreOptions, VectorEncoderFn, EncodeKind } from './types'\n\n// The adapter class shape the factory accepts as 'client'.\nexport interface VectorStoreConstructor<O extends BaseVectorStoreOptions = BaseVectorStoreOptions> {\n  new (options: O): BaseVectorStore\n  isAvailable?: () => boolean\n}\n\n/**\n * `client` is one of:\n *   - the adapter class itself          — `QdrantVectorStore`\n *   - a sync resolver                   — `() => QdrantVectorStore`\n *   - an async resolver / dynamic import — `() => import('…/qdrant').then(m => m.QdrantVectorStore)`\n * A resolver may also return a module namespace whose `default` is the class.\n */\nexport type VectorStoreClient<O extends BaseVectorStoreOptions = BaseVectorStoreOptions> =\n  | VectorStoreConstructor<O>\n  | (() => VectorStoreConstructor<O> | { default: VectorStoreConstructor<O> })\n  | (() => Promise<VectorStoreConstructor<O> | { default: VectorStoreConstructor<O> }>)\n\nexport interface CreateVectorStoreConfig<\n  O extends BaseVectorStoreOptions = BaseVectorStoreOptions,\n> {\n  client: VectorStoreClient<O>\n  options: O\n}\n\n/**\n * Build a callable store. Validate config; resolve the `client` (class | sync resolver | async\n * resolver) to a BaseVectorStore subclass ctor; optional availability gate; construct; return\n * asCallable(). Async so that `client: () => import('…')` can lazily load the adapter (and its\n * driver) only when the store is actually created.\n */\nexport const createVectorStore = async <O extends BaseVectorStoreOptions = BaseVectorStoreOptions>(\n  config: CreateVectorStoreConfig<O>\n): Promise<CallableVectorStore> => {\n  validateCreateConfig(config)\n  const Ctor = (await resolveClientCtor(config.client)) as VectorStoreConstructor<O>\n  if (typeof Ctor.isAvailable === 'function' && !Ctor.isAvailable()) {\n    throw new E_VECTOR_STORE_DRIVER_UNAVAILABLE([Ctor.name || 'unknown'])\n  }\n  const instance = new Ctor(config.options)\n  return instance.asCallable() as CallableVectorStore\n}\n\n// Helper: adapt an embeddings-battery-shaped object (has embedMany(texts, { kind })) into a VectorEncoderFn.\n// The embeddings adapters expose: embedMany(texts: string[], opts?: { kind?: 'query'|'document' }): Promise<number[][]>\nexport interface EmbeddingsLike {\n  embedMany(texts: string[], opts?: { kind?: EncodeKind }): Promise<number[][]>\n}\nexport const encoderFromEmbeddings = (adapter: EmbeddingsLike): VectorEncoderFn => {\n  return (texts: string[], kind: EncodeKind) => adapter.embedMany(texts, { kind })\n}\n"],"mappings":";;;;;;;;;;;;AAwCA,IAAa,oBAAoB,OAC/B,WACiC;CACjC,qBAAqB,MAAM;CAC3B,MAAM,OAAQ,MAAM,kBAAkB,OAAO,MAAM;CACnD,IAAI,OAAO,KAAK,gBAAgB,cAAc,CAAC,KAAK,YAAY,GAC9D,MAAM,IAAI,kCAAkC,CAAC,KAAK,QAAQ,SAAS,CAAC;CAGtE,OAAO,IADc,KAAK,OAAO,OAC1B,EAAS,WAAW;AAC7B;AAOA,IAAa,yBAAyB,YAA6C;CACjF,QAAQ,OAAiB,SAAqB,QAAQ,UAAU,OAAO,EAAE,KAAK,CAAC;AACjF"}