@nhtio/adk/batteries/vector/exceptions
Battery-scoped exception constructors for vector store adapter failures.
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.
Variables
| Variable | Description |
|---|---|
| E_INVALID_VECTOR_RECORD | Thrown when a vector record at a specific index is invalid. Fatal: invalid records cannot be processed. |
| E_INVALID_VECTOR_STORE_CONFIG | Thrown when the vector store configuration fails validation. Fatal: config bugs fail loud at construction time. |
| E_VECTOR_STORE_COLLECTION_FAILED | Thrown when a collection operation fails. Non-fatal: collection operation failures are recoverable. |
| E_VECTOR_STORE_CONNECTION_FAILED | Thrown when a vector store connection fails. Non-fatal: connection failures are recoverable. |
| E_VECTOR_STORE_CONSISTENCY_TIMEOUT | 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. |
| E_VECTOR_STORE_DELETE_FAILED | Thrown when a vector delete fails. Non-fatal: delete failures are recoverable. |
| E_VECTOR_STORE_DIMENSION_MISMATCH | Thrown when a vector's dimension does not match the expected dimension. Fatal: dimension mismatch indicates incompatible data. |
| E_VECTOR_STORE_DRIVER_UNAVAILABLE | Thrown when the vector store driver is unavailable. Fatal: driver failures are critical. |
| E_VECTOR_STORE_ENCODER_REQUIRED | 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. |
| E_VECTOR_STORE_MIGRATION_FAILED | Thrown when a migration fails. Non-fatal: migration failures are recoverable. |
| E_VECTOR_STORE_PROJECTION_REQUIRED | Thrown when a read operation requires an explicit select projection. Fatal: projection is required for read operations. |
| E_VECTOR_STORE_QUERY_CONFLICT | Thrown when the query builder is in a conflicting state. Fatal: conflicting state indicates programming errors. |
| E_VECTOR_STORE_RAW_BINDING_MISMATCH | Thrown when the raw fragment placeholder count does not match the bindings length. Fatal: binding mismatch indicates query construction errors. |
| E_VECTOR_STORE_SEARCH_FAILED | Thrown when a vector search fails. Non-fatal: search failures are recoverable. |
| E_VECTOR_STORE_TRANSACTIONS_UNSUPPORTED | Thrown when the adapter does not support transactions. Fatal: transaction support is required for the requested operation. |
| E_VECTOR_STORE_UNSUPPORTED_FILTER_OPERATOR | Thrown when a filter operator/dialect is unsupported by the adapter. Fatal: unsupported filter dialects cannot be processed. |
| E_VECTOR_STORE_UNSUPPORTED_OPERATION | Thrown when an operation is unsupported by the adapter. Fatal: unsupported operations cannot be performed. |
| E_VECTOR_STORE_UPSERT_FAILED | Thrown when a vector upsert fails. Non-fatal: upsert failures are recoverable. |