verso-db 0.1.1

package/dist/errors.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Base error class for all VectorDB errors
+ */
+export declare class VectorDBError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Thrown when vector dimensions don't match expected dimensions
+ */
+export declare class DimensionMismatchError extends VectorDBError {
+    readonly expected: number;
+    readonly actual: number;
+    constructor(expected: number, actual: number, context?: string);
+}
+/**
+ * Thrown when attempting to add a vector with an ID that already exists
+ */
+export declare class DuplicateVectorError extends VectorDBError {
+    readonly ids: string[];
+    constructor(ids: string[]);
+}
+/**
+ * Thrown when a requested collection does not exist
+ */
+export declare class CollectionNotFoundError extends VectorDBError {
+    readonly collectionName: string;
+    constructor(collectionName: string);
+}
+/**
+ * Thrown when attempting to create a collection that already exists
+ */
+export declare class CollectionExistsError extends VectorDBError {
+    readonly collectionName: string;
+    constructor(collectionName: string);
+}
+/**
+ * Thrown when a storage operation fails
+ */
+export declare class StorageError extends VectorDBError {
+    readonly operation: string;
+    readonly path?: string;
+    constructor(operation: string, message: string, path?: string);
+}
+/**
+ * Thrown when quantization operations fail
+ */
+export declare class QuantizationError extends VectorDBError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a vector is not found in the index
+ */
+export declare class VectorNotFoundError extends VectorDBError {
+    readonly vectorId: string | number;
+    constructor(vectorId: string | number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK1C;AAED;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAS/D;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;gBAEX,GAAG,EAAE,MAAM,EAAE;CAQ1B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,cAAc,EAAE,MAAM;CAKnC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;IACtD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBAEpB,cAAc,EAAE,MAAM;CAKnC;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAM9D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,aAAa;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;gBAEvB,QAAQ,EAAE,MAAM,GAAG,MAAM;CAKtC"}

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * verso - High-performance vector search with HNSW indexing
+ *
+ * Features:
+ * - HNSW algorithm for approximate nearest neighbor search
+ * - Multiple distance metrics: cosine, euclidean, dot product
+ * - Int8 scalar quantization for 4x memory reduction
+ * - Batch query support for improved throughput
+ * - Parameter presets for different use cases
+ * - Multi-platform: Bun (file system) and Browser (OPFS)
+ *
+ * @example
+ * ```typescript
+ * import { VectorDB, getRecommendedPreset } from 'verso';
+ *
+ * const db = new VectorDB();
+ * const preset = getRecommendedPreset(768);
+ *
+ * const collection = await db.createCollection('my-vectors', {
+ *   dimension: 768,
+ *   metric: 'cosine',
+ *   M: preset.M,
+ *   efConstruction: preset.efConstruction
+ * });
+ *
+ * await collection.add({
+ *   ids: ['doc1', 'doc2'],
+ *   vectors: [new Float32Array(768), new Float32Array(768)]
+ * });
+ *
+ * const results = await collection.query({
+ *   queryVector: new Float32Array(768),
+ *   k: 10,
+ *   efSearch: preset.efSearch
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ * @module verso
+ */
+export { VectorDB } from './VectorDB';
+export type { VectorDBConfig } from './VectorDB';
+export { Collection } from './Collection';
+export type { AddConfig, QueryConfig, QueryResult } from './Collection';
+export { HNSWIndex } from './HNSWIndex';
+export type { DistanceMetric, Node } from './HNSWIndex';
+export type { DistanceBackend } from './backends/DistanceBackend';
+export { JsDistanceBackend, dotProductFast, l2SquaredFast, normalizeInPlace, cosineDistanceFast } from './backends/JsDistanceBackend';
+export { BinaryHeap } from './BinaryHeap';
+export { MaxBinaryHeap } from './MaxBinaryHeap';
+export { ScalarQuantizer, QuantizedVectorStore, dotProductInt8, l2SquaredInt8, cosineDistanceInt8 } from './quantization/ScalarQuantizer';
+export type { QuantizationParams } from './quantization/ScalarQuantizer';
+export type { HNSWPreset } from './presets';
+export { PRESET_LOW_DIM, PRESET_MEDIUM_DIM, PRESET_HIGH_DIM, PRESET_VERY_HIGH_DIM, PRESET_SMALL_DATASET, PRESET_LARGE_DATASET, PRESET_MAX_RECALL, PRESET_LOW_LATENCY, PRESETS, getRecommendedPreset, getPreset, getRAGPreset } from './presets';
+export type { StorageBackend, StorageOptions } from './storage/StorageBackend';
+export { BunStorageBackend } from './storage/BunStorageBackend';
+export { MemoryBackend } from './storage/MemoryBackend';
+export { OPFSBackend } from './storage/OPFSBackend';
+export { createStorageBackend, getRecommendedStorageType, isStorageTypeAvailable, type StorageType, type CreateStorageOptions, } from './storage/createStorageBackend';
+export { WriteAheadLog, WALOperationType, type WALEntry, } from './storage/WriteAheadLog';
+export { BatchWriter, createBatchWriter, type BatchWriterOptions, } from './storage/BatchWriter';
+export { deltaEncodeNeighbors, deltaDecodeNeighbors, deltaEncodedSize, encodeVarint, decodeVarint, } from './encoding/DeltaEncoder';
+export { VectorDBError, DimensionMismatchError, DuplicateVectorError, CollectionNotFoundError, CollectionExistsError, StorageError, QuantizationError, VectorNotFoundError, } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxD,YAAY,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,aAAa,EACb,kBAAkB,EACnB,MAAM,gCAAgC,CAAC;AACxC,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAIzE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,OAAO,EACP,oBAAoB,EACpB,SAAS,EACT,YAAY,EACb,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,oBAAoB,GAC1B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,KAAK,QAAQ,GACd,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,KAAK,kBAAkB,GACxB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,YAAY,GACb,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,UAAU,CAAC"}