@wiscale/velesdb-sdk 2.0.0 → 3.0.0

package/README.md

@@ -2,10 +2,11 @@
 
 Official TypeScript SDK for [VelesDB](https://github.com/cyberlife-coder/VelesDB) -- the local-first vector database for AI and RAG. Sub-millisecond semantic search in Browser and Node.js.
 
-**v2.0.0** | Node.js >= 18 | Browser (WASM) | VelesDB Core License 1.0
+**v3.0.0** | Node.js >= 18 | Browser (WASM) | VelesDB Core License 1.0
 
 ## What's New (unreleased)
 
+- **Streaming ingestion enablement (2026-06-14)** (REST backend): `enableStreaming(collection, config?)` turns on the bounded streaming-ingestion channel before `streamInsert()`. The optional `StreamingConfig` (`bufferSize`, `batchSize`, `flushIntervalMs`) is camelCase; omitted fields fall back to the server defaults. See [`db.enableStreaming`](#dbenablestreamingcollection-config) below. The WASM backend throws `NOT_SUPPORTED`.
 - **Relation + durable-TTL surface** (REST backend): `relate()`, `unrelate()`, `getRelations()`, `setTtlDurable()` — now fully tested and documented (see [Knowledge Graph API](#knowledge-graph-api) and [Agent Memory API](#agent-memory-api) below). The WASM backend throws `NOT_SUPPORTED` for these methods.
 - The shipped example (`examples/hybrid_queries.ts`) was rewritten against the real API and is now compile-checked in CI.
 
@@ -332,6 +333,21 @@ await db.upsertBatch('docs', [
 ]);
 ```
 
+#### `db.enableStreaming(collection, config?)`
+
+Enable the bounded streaming-ingestion channel on a collection. Call this once before `streamInsert()`. The optional `config` is camelCase; every field is optional and omitted fields fall back to the server defaults (REST only; the WASM backend throws `NOT_SUPPORTED`).
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `bufferSize` | `number` | `10000` | Bounded ingestion channel capacity |
+| `batchSize` | `number` | `128` | Points flushed to the index per batch |
+| `flushIntervalMs` | `number` | `50` | Max milliseconds before a partial batch is flushed |
+
+```typescript
+await db.enableStreaming('docs', { bufferSize: 4096, batchSize: 64 });
+await db.streamInsert('docs', largeDocumentArray);
+```
+
 #### `db.streamInsert(collection, documents)`
 
 Insert documents with server backpressure support. Sends documents sequentially, respecting 429 rate limits. Throws `BackpressureError` if the server pushes back.

package/dist/index.d.mts

@@ -1001,6 +1001,8 @@ interface CapabilityMap {
     secondaryIndexes: boolean;
     /** Agent Memory SDK (semantic, episodic, procedural). */
     agentMemory: boolean;
+    /** Enable the bounded streaming-ingestion channel (`enableStreaming`). */
+    enableStreaming: boolean;
     /** Streaming insert with backpressure (`streamInsert`). */
     streamInsert: boolean;
     /** Product quantization training (`trainPq`). */
@@ -1173,6 +1175,23 @@ interface AggregateResponse {
         count: number;
     };
 }
+/**
+ * Configuration for `POST /collections/{name}/stream/enable`.
+ *
+ * Enables the bounded streaming-ingestion channel on a collection so that
+ * subsequent `streamInsert` calls are accepted. Every field is optional;
+ * omitted fields fall back to the server defaults (`bufferSize` 10000,
+ * `batchSize` 128, `flushIntervalMs` 50). camelCase here, converted to the
+ * snake_case wire body by the backend.
+ */
+interface StreamingConfig {
+    /** Bounded ingestion channel capacity (server default: 10000). */
+    bufferSize?: number;
+    /** Points flushed to the index per batch (server default: 128). */
+    batchSize?: number;
+    /** Max milliseconds before a partial batch is flushed (server default: 50). */
+    flushIntervalMs?: number;
+}
 /**
  * Response from `POST /collections/{name}/points/stream` (NDJSON batch upsert).
  *
@@ -1220,6 +1239,17 @@ interface IVelesDBBackend {
     upsert(collection: string, doc: VectorDocument): Promise<void>;
     /** Upsert (insert or replace) multiple vectors */
     upsertBatch(collection: string, docs: VectorDocument[]): Promise<void>;
+    /**
+     * Bulk upsert multiple vectors via the binary wire format (REST only).
+     *
+     * Encodes `(id, vector)` pairs into the deterministic VRB1 binary layout
+     * and POSTs them as `application/octet-stream`, avoiding per-point JSON
+     * overhead. Payloads are not carried on this path. Not supported by the
+     * WASM backend.
+     *
+     * @returns the number of points the server reports as inserted.
+     */
+    upsertBatchRaw(collection: string, docs: VectorDocument[]): Promise<number>;
     /** Search for similar vectors */
     search(collection: string, query: number[] | Float32Array, options?: SearchOptions): Promise<SearchResult[]>;
     /** Delete a vector by ID */
@@ -1257,6 +1287,11 @@ interface IVelesDBBackend {
     collectionSanity(collection: string): Promise<CollectionSanityResponse>;
     /** Multi-query fusion search */
     multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
+    /** Multi-query fusion search returning only IDs and scores */
+    multiQuerySearchIds(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     /** Check if collection is empty */
     isEmpty(collection: string): Promise<boolean>;
     /** Flush pending changes to disk */
@@ -1294,6 +1329,14 @@ interface IVelesDBBackend {
     sparseSearchNamed(collection: string, query: SparseVector, indexName: string, options?: SparseSearchNamedOptions): Promise<SearchResult[]>;
     /** Train Product Quantization on a collection */
     trainPq(collection: string, options?: PqTrainOptions): Promise<string>;
+    /**
+     * Enable the bounded streaming-ingestion channel on a collection.
+     *
+     * POSTs an optional `StreamingConfig` to
+     * `POST /collections/{name}/stream/enable`; omitted config fields fall
+     * back to the server defaults. Must be called before `streamInsert`.
+     */
+    enableStreaming(collection: string, config?: StreamingConfig): Promise<void>;
     /** Stream-insert documents with backpressure support */
     streamInsert(collection: string, docs: VectorDocument[]): Promise<void>;
     /**
@@ -1490,6 +1533,18 @@ declare class VelesDB {
     listCollections(): Promise<Collection[]>;
     upsert(collection: string, doc: VectorDocument): Promise<void>;
     upsertBatch(collection: string, docs: VectorDocument[]): Promise<void>;
+    /**
+     * Bulk upsert via the binary wire format (REST backend only).
+     *
+     * Encodes `(id, vector)` pairs into the deterministic VRB1 binary layout
+     * and sends them as a single `application/octet-stream` request, avoiding
+     * per-point JSON overhead. Payloads are not carried — use
+     * {@link upsertBatch} when you need them. Throws a not-supported error on
+     * the WASM backend.
+     *
+     * @returns the number of points the server reports as inserted.
+     */
+    upsertBatchRaw(collection: string, docs: VectorDocument[]): Promise<number>;
     delete(collection: string, id: string | number): Promise<boolean>;
     get(collection: string, id: string | number): Promise<VectorDocument | null>;
     isEmpty(collection: string): Promise<boolean>;
@@ -1512,6 +1567,11 @@ declare class VelesDB {
         filter?: FilterInput;
     }): Promise<SearchResult[]>;
     multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
+    /** Multi-query fusion search returning only IDs and scores (no payloads). */
+    multiQuerySearchIds(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     /**
      * Pure sparse search against a named sparse index.
      *
@@ -1526,6 +1586,7 @@ declare class VelesDB {
     collectionSanity(collection: string): Promise<CollectionSanityResponse>;
     scroll(collection: string, request?: ScrollRequest): Promise<ScrollResponse>;
     trainPq(collection: string, options?: PqTrainOptions): Promise<string>;
+    enableStreaming(collection: string, config?: StreamingConfig): Promise<void>;
     streamInsert(collection: string, docs: VectorDocument[]): Promise<void>;
     streamUpsertPoints(collection: string, docs: VectorDocument[]): Promise<StreamUpsertResponse>;
     searchIds(collection: string, query: number[] | Float32Array, options?: SearchOptions): Promise<Array<{
@@ -1590,6 +1651,7 @@ declare class WasmBackend implements IVelesDBBackend {
     listCollections(): Promise<Collection[]>;
     upsert(collectionName: string, doc: VectorDocument): Promise<void>;
     upsertBatch(collectionName: string, docs: VectorDocument[]): Promise<void>;
+    upsertBatchRaw(c: string, d: VectorDocument[]): Promise<number>;
     delete(collectionName: string, id: string | number): Promise<boolean>;
     get(collectionName: string, id: string | number): Promise<VectorDocument | null>;
     isEmpty(collectionName: string): Promise<boolean>;
@@ -1627,6 +1689,7 @@ declare class WasmBackend implements IVelesDBBackend {
     traverseParallel(c: string, r: TraverseParallelRequest): Promise<TraverseResponse>;
     getNodeDegree(c: string, n: number): Promise<DegreeResponse>;
     trainPq(c: string, o?: PqTrainOptions): Promise<string>;
+    enableStreaming(c: string, cfg?: StreamingConfig): Promise<void>;
     streamInsert(c: string, d: VectorDocument[]): Promise<void>;
     streamUpsertPoints(c: string, d: VectorDocument[]): Promise<StreamUpsertResponse>;
     createGraphCollection(n: string, c?: GraphCollectionConfig): Promise<void>;
@@ -1637,6 +1700,10 @@ declare class WasmBackend implements IVelesDBBackend {
         id: number;
         score: number;
     }>>;
+    multiQuerySearchIds(c: string, v: Array<number[] | Float32Array>, o?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
     searchSemanticMemory(c: string, e: number[], k?: number): Promise<SearchResult[]>;
     recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<string>;
@@ -1684,6 +1751,7 @@ declare class RestBackend implements IVelesDBBackend {
     listCollections(): Promise<Collection[]>;
     upsert(c: string, d: VectorDocument): Promise<void>;
     upsertBatch(c: string, d: VectorDocument[]): Promise<void>;
+    upsertBatchRaw(c: string, d: VectorDocument[]): Promise<number>;
     delete(c: string, id: string | number): Promise<boolean>;
     get(c: string, id: string | number): Promise<VectorDocument | null>;
     isEmpty(c: string): Promise<boolean>;
@@ -1721,6 +1789,10 @@ declare class RestBackend implements IVelesDBBackend {
         filter?: FilterInput;
     }): Promise<SearchResult[]>;
     multiQuerySearch(c: string, v: Array<number[] | Float32Array>, o?: MultiQuerySearchOptions): Promise<SearchResult[]>;
+    multiQuerySearchIds(c: string, v: Array<number[] | Float32Array>, o?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     searchIds(c: string, q: number[] | Float32Array, o?: SearchOptions): Promise<Array<{
         id: number;
         score: number;
@@ -1746,6 +1818,7 @@ declare class RestBackend implements IVelesDBBackend {
     analyzeCollection(c: string): Promise<CollectionStatsResponse>;
     getCollectionConfig(c: string): Promise<CollectionConfigResponse>;
     trainPq(c: string, o?: PqTrainOptions): Promise<string>;
+    enableStreaming(c: string, cfg?: StreamingConfig): Promise<void>;
     streamInsert(c: string, d: VectorDocument[]): Promise<void>;
     streamUpsertPoints(c: string, d: VectorDocument[]): Promise<StreamUpsertResponse>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
@@ -2246,4 +2319,4 @@ declare class OpenAIEmbedder implements Embedder {
     embed(texts: string[]): Promise<number[][]>;
 }
 
-export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type Embedder, type EpisodicEvent, type EpisodicRecord, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, type GraphNodeId, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OpenAIEmbedder, type OpenAIEmbedderOptions, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, type RelateRequest, type RelateResponse, type RelationEdge, type RelationsResponse, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };
+export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type Embedder, type EpisodicEvent, type EpisodicRecord, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, type GraphNodeId, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OpenAIEmbedder, type OpenAIEmbedderOptions, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, type RelateRequest, type RelateResponse, type RelationEdge, type RelationsResponse, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, type StreamingConfig, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };

package/dist/index.d.ts

@@ -1001,6 +1001,8 @@ interface CapabilityMap {
     secondaryIndexes: boolean;
     /** Agent Memory SDK (semantic, episodic, procedural). */
     agentMemory: boolean;
+    /** Enable the bounded streaming-ingestion channel (`enableStreaming`). */
+    enableStreaming: boolean;
     /** Streaming insert with backpressure (`streamInsert`). */
     streamInsert: boolean;
     /** Product quantization training (`trainPq`). */
@@ -1173,6 +1175,23 @@ interface AggregateResponse {
         count: number;
     };
 }
+/**
+ * Configuration for `POST /collections/{name}/stream/enable`.
+ *
+ * Enables the bounded streaming-ingestion channel on a collection so that
+ * subsequent `streamInsert` calls are accepted. Every field is optional;
+ * omitted fields fall back to the server defaults (`bufferSize` 10000,
+ * `batchSize` 128, `flushIntervalMs` 50). camelCase here, converted to the
+ * snake_case wire body by the backend.
+ */
+interface StreamingConfig {
+    /** Bounded ingestion channel capacity (server default: 10000). */
+    bufferSize?: number;
+    /** Points flushed to the index per batch (server default: 128). */
+    batchSize?: number;
+    /** Max milliseconds before a partial batch is flushed (server default: 50). */
+    flushIntervalMs?: number;
+}
 /**
  * Response from `POST /collections/{name}/points/stream` (NDJSON batch upsert).
  *
@@ -1220,6 +1239,17 @@ interface IVelesDBBackend {
     upsert(collection: string, doc: VectorDocument): Promise<void>;
     /** Upsert (insert or replace) multiple vectors */
     upsertBatch(collection: string, docs: VectorDocument[]): Promise<void>;
+    /**
+     * Bulk upsert multiple vectors via the binary wire format (REST only).
+     *
+     * Encodes `(id, vector)` pairs into the deterministic VRB1 binary layout
+     * and POSTs them as `application/octet-stream`, avoiding per-point JSON
+     * overhead. Payloads are not carried on this path. Not supported by the
+     * WASM backend.
+     *
+     * @returns the number of points the server reports as inserted.
+     */
+    upsertBatchRaw(collection: string, docs: VectorDocument[]): Promise<number>;
     /** Search for similar vectors */
     search(collection: string, query: number[] | Float32Array, options?: SearchOptions): Promise<SearchResult[]>;
     /** Delete a vector by ID */
@@ -1257,6 +1287,11 @@ interface IVelesDBBackend {
     collectionSanity(collection: string): Promise<CollectionSanityResponse>;
     /** Multi-query fusion search */
     multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
+    /** Multi-query fusion search returning only IDs and scores */
+    multiQuerySearchIds(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     /** Check if collection is empty */
     isEmpty(collection: string): Promise<boolean>;
     /** Flush pending changes to disk */
@@ -1294,6 +1329,14 @@ interface IVelesDBBackend {
     sparseSearchNamed(collection: string, query: SparseVector, indexName: string, options?: SparseSearchNamedOptions): Promise<SearchResult[]>;
     /** Train Product Quantization on a collection */
     trainPq(collection: string, options?: PqTrainOptions): Promise<string>;
+    /**
+     * Enable the bounded streaming-ingestion channel on a collection.
+     *
+     * POSTs an optional `StreamingConfig` to
+     * `POST /collections/{name}/stream/enable`; omitted config fields fall
+     * back to the server defaults. Must be called before `streamInsert`.
+     */
+    enableStreaming(collection: string, config?: StreamingConfig): Promise<void>;
     /** Stream-insert documents with backpressure support */
     streamInsert(collection: string, docs: VectorDocument[]): Promise<void>;
     /**
@@ -1490,6 +1533,18 @@ declare class VelesDB {
     listCollections(): Promise<Collection[]>;
     upsert(collection: string, doc: VectorDocument): Promise<void>;
     upsertBatch(collection: string, docs: VectorDocument[]): Promise<void>;
+    /**
+     * Bulk upsert via the binary wire format (REST backend only).
+     *
+     * Encodes `(id, vector)` pairs into the deterministic VRB1 binary layout
+     * and sends them as a single `application/octet-stream` request, avoiding
+     * per-point JSON overhead. Payloads are not carried — use
+     * {@link upsertBatch} when you need them. Throws a not-supported error on
+     * the WASM backend.
+     *
+     * @returns the number of points the server reports as inserted.
+     */
+    upsertBatchRaw(collection: string, docs: VectorDocument[]): Promise<number>;
     delete(collection: string, id: string | number): Promise<boolean>;
     get(collection: string, id: string | number): Promise<VectorDocument | null>;
     isEmpty(collection: string): Promise<boolean>;
@@ -1512,6 +1567,11 @@ declare class VelesDB {
         filter?: FilterInput;
     }): Promise<SearchResult[]>;
     multiQuerySearch(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<SearchResult[]>;
+    /** Multi-query fusion search returning only IDs and scores (no payloads). */
+    multiQuerySearchIds(collection: string, vectors: Array<number[] | Float32Array>, options?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     /**
      * Pure sparse search against a named sparse index.
      *
@@ -1526,6 +1586,7 @@ declare class VelesDB {
     collectionSanity(collection: string): Promise<CollectionSanityResponse>;
     scroll(collection: string, request?: ScrollRequest): Promise<ScrollResponse>;
     trainPq(collection: string, options?: PqTrainOptions): Promise<string>;
+    enableStreaming(collection: string, config?: StreamingConfig): Promise<void>;
     streamInsert(collection: string, docs: VectorDocument[]): Promise<void>;
     streamUpsertPoints(collection: string, docs: VectorDocument[]): Promise<StreamUpsertResponse>;
     searchIds(collection: string, query: number[] | Float32Array, options?: SearchOptions): Promise<Array<{
@@ -1590,6 +1651,7 @@ declare class WasmBackend implements IVelesDBBackend {
     listCollections(): Promise<Collection[]>;
     upsert(collectionName: string, doc: VectorDocument): Promise<void>;
     upsertBatch(collectionName: string, docs: VectorDocument[]): Promise<void>;
+    upsertBatchRaw(c: string, d: VectorDocument[]): Promise<number>;
     delete(collectionName: string, id: string | number): Promise<boolean>;
     get(collectionName: string, id: string | number): Promise<VectorDocument | null>;
     isEmpty(collectionName: string): Promise<boolean>;
@@ -1627,6 +1689,7 @@ declare class WasmBackend implements IVelesDBBackend {
     traverseParallel(c: string, r: TraverseParallelRequest): Promise<TraverseResponse>;
     getNodeDegree(c: string, n: number): Promise<DegreeResponse>;
     trainPq(c: string, o?: PqTrainOptions): Promise<string>;
+    enableStreaming(c: string, cfg?: StreamingConfig): Promise<void>;
     streamInsert(c: string, d: VectorDocument[]): Promise<void>;
     streamUpsertPoints(c: string, d: VectorDocument[]): Promise<StreamUpsertResponse>;
     createGraphCollection(n: string, c?: GraphCollectionConfig): Promise<void>;
@@ -1637,6 +1700,10 @@ declare class WasmBackend implements IVelesDBBackend {
         id: number;
         score: number;
     }>>;
+    multiQuerySearchIds(c: string, v: Array<number[] | Float32Array>, o?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
     searchSemanticMemory(c: string, e: number[], k?: number): Promise<SearchResult[]>;
     recordEpisodicEvent(c: string, e: EpisodicEvent): Promise<string>;
@@ -1684,6 +1751,7 @@ declare class RestBackend implements IVelesDBBackend {
     listCollections(): Promise<Collection[]>;
     upsert(c: string, d: VectorDocument): Promise<void>;
     upsertBatch(c: string, d: VectorDocument[]): Promise<void>;
+    upsertBatchRaw(c: string, d: VectorDocument[]): Promise<number>;
     delete(c: string, id: string | number): Promise<boolean>;
     get(c: string, id: string | number): Promise<VectorDocument | null>;
     isEmpty(c: string): Promise<boolean>;
@@ -1721,6 +1789,10 @@ declare class RestBackend implements IVelesDBBackend {
         filter?: FilterInput;
     }): Promise<SearchResult[]>;
     multiQuerySearch(c: string, v: Array<number[] | Float32Array>, o?: MultiQuerySearchOptions): Promise<SearchResult[]>;
+    multiQuerySearchIds(c: string, v: Array<number[] | Float32Array>, o?: MultiQuerySearchOptions): Promise<Array<{
+        id: number;
+        score: number;
+    }>>;
     searchIds(c: string, q: number[] | Float32Array, o?: SearchOptions): Promise<Array<{
         id: number;
         score: number;
@@ -1746,6 +1818,7 @@ declare class RestBackend implements IVelesDBBackend {
     analyzeCollection(c: string): Promise<CollectionStatsResponse>;
     getCollectionConfig(c: string): Promise<CollectionConfigResponse>;
     trainPq(c: string, o?: PqTrainOptions): Promise<string>;
+    enableStreaming(c: string, cfg?: StreamingConfig): Promise<void>;
     streamInsert(c: string, d: VectorDocument[]): Promise<void>;
     streamUpsertPoints(c: string, d: VectorDocument[]): Promise<StreamUpsertResponse>;
     storeSemanticFact(c: string, e: SemanticEntry): Promise<void>;
@@ -2246,4 +2319,4 @@ declare class OpenAIEmbedder implements Embedder {
     embed(texts: string[]): Promise<number[][]>;
 }
 
-export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type Embedder, type EpisodicEvent, type EpisodicRecord, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, type GraphNodeId, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OpenAIEmbedder, type OpenAIEmbedderOptions, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, type RelateRequest, type RelateResponse, type RelationEdge, type RelationsResponse, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };
+export { type ActualStats, type AddEdgeRequest, AgentMemoryClient, type AgentMemoryConfig, type AggregateQueryOptions, type AggregateResponse, type AggregationQueryResponse, AllocationFailedError, type AsyncIndexBuilderOptions, type BackendType, BackpressureError, type CapabilityMap, type Collection, type CollectionConfig, type CollectionConfigResponse, CollectionExistsError, CollectionNotFoundError, type CollectionSanityChecks, type CollectionSanityDiagnostics, type CollectionSanityResponse, type CollectionStatsResponse, type CollectionType, type ColumnStatsDetail, ColumnStoreError, type CompareOp, type Condition, ConfigError, ConnectionError, type CreateIndexOptions, DatabaseLockedError, type DeferredIndexerOptions, type DegreeResponse, DimensionMismatchError, type DistanceMetric, EdgeExistsError, EdgeNotFoundError, type EdgesResponse, type Embedder, type EpisodicEvent, type EpisodicRecord, EpochMismatchError, type ExplainCost, type ExplainFeatures, type ExplainPlanStep, type ExplainResponse, type Filter, type FilterInput, type FusionOptions, type FusionStrategy, type GetEdgesOptions, type GetNodeEdgesOptions, GpuError, type GraphCollectionConfig, type GraphEdge, type GraphNodeId, GraphNotSupportedError, type GraphSchemaMode, type GraphSearchRequest, type GraphSearchResponse, type GraphSearchResultItem, GuardRailError, type GuardRailsConfigResponse, type GuardRailsUpdateRequest, type HnswParams, type IVelesDBBackend, IncompatibleSchemaVersionError, IndexCorruptedError, IndexError, type IndexInfo, type IndexType, InternalError, InvalidCollectionNameError, InvalidDimensionError, InvalidEdgeLabelError, InvalidQuantizerConfigError, InvalidVectorError, IoError, type JsonValue, type ListNodesResponse, type MatchQueryOptions, type MatchQueryResponse, type MatchQueryResultItem, type MultiQuerySearchOptions, type NearVectorOptions, NodeNotFoundError, type NodePayloadResponse, type NodeStats, NotFoundError, OpenAIEmbedder, type OpenAIEmbedderOptions, OverflowError, PointNotFoundError, type PqTrainOptions, type ProceduralPattern, type QueryApiResponse, QueryError, type QueryOptions, type QueryResponse, type QueryResult, type QueryStats, REST_CAPABILITIES, type RebuildIndexResponse, type RelDirection, type RelOptions, type RelateRequest, type RelateResponse, type RelationEdge, type RelationsResponse, RestBackend, type RestPointId, SchemaValidationError, type ScrollRequest, type ScrollResponse, SearchNotSupportedError, type SearchOptions, type SearchQuality, type SearchQualityWire, type SearchResult, type SemanticEntry, SerializationError, SnapshotBuildFailedError, SparseIndexError, type SparseSearchNamedOptions, type SparseVector, StorageError, type StorageMode, type StreamUpsertResponse, type StreamingConfig, TrainingFailedError, type TraversalResultItem, type TraversalStats, type TraverseParallelRequest, type TraverseRequest, type TraverseResponse, VELES_ERROR_CODES, ValidationError, type VectorDocument, VectorNotAllowedError, VectorRequiredError, VelesDB, type VelesDBConfig, VelesDBError, VelesError, type VelesErrorCode, VelesQLBuilder, WASM_CAPABILITIES, WasmBackend, f, isTypedFilter, normalizeFilter, parseVelesError, searchQualityToMode, velesql };

package/dist/index.js

@@ -5,8 +5,13 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+var __esm = (fn, res, err) => function __init() {
+  if (err) throw err[0];
+  try {
+    return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+  } catch (e) {
+    throw err = [e], e;
+  }
 };
 var __export = (target, all) => {
   for (var name in all)
@@ -182,6 +187,7 @@ var REST_CAPABILITIES = Object.freeze({
   graphTraversal: true,
   secondaryIndexes: true,
   agentMemory: true,
+  enableStreaming: true,
   streamInsert: true,
   pqTraining: true,
   velesqlQuery: true,
@@ -197,6 +203,7 @@ var WASM_CAPABILITIES = Object.freeze({
   graphTraversal: false,
   secondaryIndexes: false,
   agentMemory: false,
+  enableStreaming: false,
   streamInsert: false,
   pqTraining: false,
   velesqlQuery: false,
@@ -891,6 +898,9 @@ function validateCollectionName(name) {
     );
   }
 }
+async function safeJsonParse(response) {
+  return response.json().catch(() => ({}));
+}
 function toNumberArray(v) {
   return v instanceof Float32Array ? Array.from(v) : v;
 }
@@ -944,12 +954,18 @@ async function wasmScroll(_collection, _request) {
 async function wasmTrainPq(_collection, _options) {
   wasmNotSupported("PQ training");
 }
+async function wasmEnableStreaming(_collection, _config) {
+  wasmNotSupported("Streaming enable");
+}
 async function wasmStreamInsert(_collection, _docs) {
   wasmNotSupported("Streaming insert");
 }
 async function wasmStreamUpsertPoints(_collection, _docs) {
   wasmNotSupported("Streaming batch upsert");
 }
+async function wasmUpsertBatchRaw(_collection, _docs) {
+  wasmNotSupported("Binary bulk upsert (upsertBatchRaw)");
+}
 async function wasmCreateGraphCollection(_name, _config) {
   wasmNotSupported("Graph collections");
 }
@@ -965,6 +981,9 @@ async function wasmGetCollectionConfig(_collection) {
 async function wasmSearchIds(_collection, _query, _options) {
   wasmNotSupported("searchIds");
 }
+async function wasmMultiQuerySearchIds(_collection, _vectors, _options) {
+  wasmNotSupported("multiQuerySearchIds");
+}
 async function wasmStoreSemanticFact(_collection, _entry) {
   wasmNotSupported("Agent memory");
 }
@@ -1221,6 +1240,9 @@ var WasmBackend = class {
       }
     }
   }
+  async upsertBatchRaw(c, d) {
+    return wasmUpsertBatchRaw(c, d);
+  }
   async delete(collectionName, id) {
     this.ensureInitialized();
     const collection = this.collections.get(collectionName);
@@ -1352,6 +1374,10 @@ var WasmBackend = class {
     this.ensureInitialized();
     return wasmTrainPq(c, o);
   }
+  async enableStreaming(c, cfg) {
+    this.ensureInitialized();
+    return wasmEnableStreaming(c, cfg);
+  }
   async streamInsert(c, d) {
     this.ensureInitialized();
     return wasmStreamInsert(c, d);
@@ -1380,6 +1406,10 @@ var WasmBackend = class {
     this.ensureInitialized();
     return wasmSearchIds(c, q, o);
   }
+  async multiQuerySearchIds(c, v, o) {
+    this.ensureInitialized();
+    return wasmMultiQuerySearchIds(c, v, o);
+  }
   async storeSemanticFact(c, e) {
     this.ensureInitialized();
     return wasmStoreSemanticFact(c, e);
@@ -1484,6 +1514,9 @@ var WasmBackend = class {
 };
 
 // src/backends/crud-backend.ts
+var RAW_BULK_HEADER_LEN = 16;
+var RAW_BULK_MAGIC = [86, 82, 66, 49];
+var RAW_BULK_ID_WIDTH = 8;
 var U64_MAX = 18446744073709551615n;
 function coerceDecimalStringId(id) {
   if (!/^\d+$/.test(id)) return NaN;
@@ -1634,6 +1667,105 @@ async function flush(transport, collection) {
   );
   throwOnError(response, `Collection '${collection}'`);
 }
+function encodeRawBulk(ids, vectors, dim) {
+  const count = ids.length;
+  if (vectors.length !== count) {
+    throw new ValidationError(
+      `encodeRawBulk: ids length (${count}) must match vectors length (${vectors.length})`
+    );
+  }
+  const buf = new Uint8Array(RAW_BULK_HEADER_LEN + count * 8 + count * dim * 4);
+  const view = new DataView(buf.buffer);
+  buf.set(RAW_BULK_MAGIC, 0);
+  view.setUint32(4, count, true);
+  view.setUint32(8, dim, true);
+  buf[12] = RAW_BULK_ID_WIDTH;
+  writeIds(view, ids);
+  writeVectors(view, vectors, dim, count);
+  return buf;
+}
+function writeIds(view, ids) {
+  let off = RAW_BULK_HEADER_LEN;
+  for (const id of ids) {
+    view.setBigUint64(off, BigInt(id), true);
+    off += 8;
+  }
+}
+function writeVectors(view, vectors, dim, count) {
+  let off = RAW_BULK_HEADER_LEN + count * 8;
+  for (const vec of vectors) {
+    if (vec.length !== dim) {
+      throw new ValidationError(
+        `encodeRawBulk: vector length (${vec.length}) must match dim (${dim})`
+      );
+    }
+    for (let i = 0; i < dim; i++) {
+      view.setFloat32(off, vec[i] ?? 0, true);
+      off += 4;
+    }
+  }
+}
+async function upsertBatchRaw(transport, collection, docs, dim) {
+  const ids = docs.map((d) => coerceNumericId(d.id));
+  const vectors = docs.map((d) => d.vector);
+  const body = encodeRawBulk(ids, vectors, dim);
+  return sendRawBulk(transport, collection, body);
+}
+function coerceNumericId(id) {
+  const parsed = parseRestPointId(id);
+  if (typeof parsed === "string") {
+    throw new ValidationError(
+      `upsertBatchRaw requires ids in the JS safe integer range; received: ${parsed}`
+    );
+  }
+  return parsed;
+}
+async function sendRawBulk(transport, collection, body) {
+  const url = `${transport.baseUrl}${collectionPath(collection)}/points/raw`;
+  const headers = {
+    "Content-Type": "application/octet-stream"
+  };
+  if (transport.apiKey) {
+    headers["Authorization"] = `Bearer ${transport.apiKey}`;
+  }
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), transport.timeout);
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body,
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    return await parseRawBulkResponse(response);
+  } catch (error) {
+    clearTimeout(timeoutId);
+    throw wrapRawBulkError(error);
+  }
+}
+async function parseRawBulkResponse(response) {
+  const data = await safeJsonParse(response);
+  if (!response.ok) {
+    const code = typeof data.code === "string" ? data.code : `HTTP_${response.status}`;
+    const message = typeof data.error === "string" ? data.error : `HTTP ${response.status}`;
+    throw new VelesDBError(message, code);
+  }
+  return typeof data.count === "number" ? data.count : 0;
+}
+function wrapRawBulkError(error) {
+  if (error instanceof VelesDBError) {
+    return error;
+  }
+  if (error instanceof Error && error.name === "AbortError") {
+    return new ConnectionError("Request timeout");
+  }
+  const message = error instanceof Error ? error.message : "Unknown error";
+  return new ConnectionError(
+    `Raw bulk upsert failed: ${message}`,
+    error instanceof Error ? error : void 0
+  );
+}
 
 // src/backends/rest-http.ts
 var STATUS_ERROR_CODES = {
@@ -1704,7 +1836,7 @@ async function request(config, method, path, body) {
       signal: controller.signal
     });
     clearTimeout(timeoutId);
-    const data = await response.json().catch(() => ({}));
+    const data = await safeJsonParse(response);
     if (!response.ok) {
       const ep = extractErrorPayload(data);
       return { error: {
@@ -1728,6 +1860,13 @@ function buildCrudTransport(config) {
     requestJson: (m, p, b) => request(config, m, p, b)
   };
 }
+function buildRawBulkTransport(config) {
+  return {
+    baseUrl: config.baseUrl,
+    apiKey: config.apiKey,
+    timeout: config.timeout
+  };
+}
 function buildSearchTransport(config) {
   return {
     requestJson: (m, p, b) => request(config, m, p, b),
@@ -2215,6 +2354,22 @@ async function multiQuerySearch(transport, collection, vectors, options) {
   throwOnError(response, `Collection '${collection}'`);
   return response.data?.results ?? [];
 }
+async function multiQuerySearchIds(transport, collection, vectors, options) {
+  const formattedVectors = vectors.map(toNumberArray);
+  const response = await transport.requestJson("POST", `${collectionPath(collection)}/search/multi/ids`, {
+    vectors: formattedVectors,
+    top_k: options?.k ?? 10,
+    strategy: options?.fusion ?? "rrf",
+    rrf_k: options?.fusionParams?.k ?? 60,
+    avg_weight: options?.fusionParams?.avgWeight,
+    max_weight: options?.fusionParams?.maxWeight,
+    hit_weight: options?.fusionParams?.hitWeight,
+    dense_weight: options?.fusionParams?.denseWeight,
+    sparse_weight: options?.fusionParams?.sparseWeight
+  });
+  throwOnError(response, `Collection '${collection}'`);
+  return response.data?.results ?? [];
+}
 async function sparseSearchNamed(transport, collection, query3, indexName, options) {
   const body = {
     sparse_vectors: { [indexName]: transport.sparseToRest(query3) },
@@ -2432,7 +2587,7 @@ async function query(transport, collection, queryString, params, options) {
   );
   throwOnError(response, `Collection '${collection}'`);
   const rawData = response.data;
-  if (rawData && Object.prototype.hasOwnProperty.call(rawData, "result")) {
+  if (rawData != null && Object.prototype.hasOwnProperty.call(rawData, "result")) {
     return {
       result: rawData.result,
       stats: {
@@ -2702,7 +2857,7 @@ async function streamInsert(transport, collection, docs) {
         throw new BackpressureError();
       }
       if (!response.ok && response.status !== 202) {
-        const data = await response.json().catch(() => ({}));
+        const data = await safeJsonParse(response);
         const errorPayload = transport.extractErrorPayload(data);
         throw new VelesDBError(
           errorPayload.message ?? `HTTP ${response.status}`,
@@ -2724,6 +2879,24 @@ async function streamInsert(transport, collection, docs) {
     }
   }
 }
+async function enableStreaming(transport, collection, config) {
+  const body = {};
+  if (config?.bufferSize !== void 0) {
+    body.buffer_size = config.bufferSize;
+  }
+  if (config?.batchSize !== void 0) {
+    body.batch_size = config.batchSize;
+  }
+  if (config?.flushIntervalMs !== void 0) {
+    body.flush_interval_ms = config.flushIntervalMs;
+  }
+  const response = await transport.requestJson(
+    "POST",
+    `${collectionPath(collection)}/stream/enable`,
+    body
+  );
+  throwOnError(response);
+}
 function requireSafeRangeId(restId) {
   if (typeof restId === "string") {
     throw new ValidationError(
@@ -2768,14 +2941,14 @@ async function streamUpsertPoints(transport, collection, docs) {
       throw new BackpressureError();
     }
     if (!response.ok) {
-      const data2 = await response.json().catch(() => ({}));
+      const data2 = await safeJsonParse(response);
       const errorPayload = transport.extractErrorPayload(data2);
       throw new VelesDBError(
         errorPayload.message ?? `HTTP ${response.status}`,
         errorPayload.code ?? transport.mapStatusToErrorCode(response.status)
       );
     }
-    const data = await response.json().catch(() => ({}));
+    const data = await safeJsonParse(response);
     return {
       message: typeof data.message === "string" ? data.message : "Stream processed",
       inserted: typeof data.inserted === "number" ? data.inserted : 0,
@@ -2860,6 +3033,10 @@ var RestBackend = class {
     this.ensureInitialized();
     return upsertBatch(buildCrudTransport(this.httpConfig), c, d);
   }
+  async upsertBatchRaw(c, d) {
+    this.ensureInitialized();
+    return upsertBatchRaw(buildRawBulkTransport(this.httpConfig), c, d, d[0]?.vector.length ?? 0);
+  }
   async delete(c, id) {
     this.ensureInitialized();
     return deletePoint(buildCrudTransport(this.httpConfig), c, id);
@@ -2962,6 +3139,10 @@ var RestBackend = class {
     this.ensureInitialized();
     return multiQuerySearch(buildSearchTransport(this.httpConfig), c, v, o);
   }
+  async multiQuerySearchIds(c, v, o) {
+    this.ensureInitialized();
+    return multiQuerySearchIds(buildSearchTransport(this.httpConfig), c, v, o);
+  }
   async searchIds(c, q, o) {
     this.ensureInitialized();
     return searchIds(buildSearchTransport(this.httpConfig), c, q, o);
@@ -3048,6 +3229,10 @@ var RestBackend = class {
     this.ensureInitialized();
     return trainPq(buildStreamingTransport(this.httpConfig), c, o);
   }
+  async enableStreaming(c, cfg) {
+    this.ensureInitialized();
+    return enableStreaming(buildStreamingTransport(this.httpConfig), c, cfg);
+  }
   async streamInsert(c, d) {
     this.ensureInitialized();
     return streamInsert(buildStreamingTransport(this.httpConfig), c, d);
@@ -3230,9 +3415,21 @@ function multiQuerySearch2(backend, collection, vectors, options) {
   }
   return backend.multiQuerySearch(collection, vectors, options);
 }
+function multiQuerySearchIds2(backend, collection, vectors, options) {
+  if (!Array.isArray(vectors) || vectors.length === 0) {
+    throw new ValidationError("Vectors must be a non-empty array");
+  }
+  for (const v of vectors) {
+    requireVector(v, "Each vector");
+  }
+  return backend.multiQuerySearchIds(collection, vectors, options);
+}
 function trainPq2(backend, collection, options) {
   return backend.trainPq(collection, options);
 }
+function enableStreaming2(backend, collection, config) {
+  return backend.enableStreaming(collection, config);
+}
 function streamInsert2(backend, config, collection, docs) {
   validateDocsBatch(docs, (doc) => {
     validateDocument(doc, config);
@@ -3501,6 +3698,24 @@ var VelesDB = class {
     });
     await this.backend.upsertBatch(collection, docs);
   }
+  /**
+   * Bulk upsert via the binary wire format (REST backend only).
+   *
+   * Encodes `(id, vector)` pairs into the deterministic VRB1 binary layout
+   * and sends them as a single `application/octet-stream` request, avoiding
+   * per-point JSON overhead. Payloads are not carried — use
+   * {@link upsertBatch} when you need them. Throws a not-supported error on
+   * the WASM backend.
+   *
+   * @returns the number of points the server reports as inserted.
+   */
+  async upsertBatchRaw(collection, docs) {
+    this.ensureInitialized();
+    validateDocsBatch(docs, (doc) => {
+      validateDocument(doc, this.config);
+    });
+    return this.backend.upsertBatchRaw(collection, docs);
+  }
   async delete(collection, id) {
     this.ensureInitialized();
     validateRestPointId(id, this.config);
@@ -3548,6 +3763,11 @@ var VelesDB = class {
     this.ensureInitialized();
     return multiQuerySearch2(this.backend, collection, vectors, options);
   }
+  /** Multi-query fusion search returning only IDs and scores (no payloads). */
+  async multiQuerySearchIds(collection, vectors, options) {
+    this.ensureInitialized();
+    return multiQuerySearchIds2(this.backend, collection, vectors, options);
+  }
   /**
    * Pure sparse search against a named sparse index.
    *
@@ -3578,6 +3798,10 @@ var VelesDB = class {
     this.ensureInitialized();
     return trainPq2(this.backend, collection, options);
   }
+  async enableStreaming(collection, config) {
+    this.ensureInitialized();
+    return enableStreaming2(this.backend, collection, config);
+  }
   async streamInsert(collection, docs) {
     this.ensureInitialized();
     return streamInsert2(this.backend, this.config, collection, docs);

package/dist/index.mjs

@@ -43,6 +43,7 @@ var REST_CAPABILITIES = Object.freeze({
   graphTraversal: true,
   secondaryIndexes: true,
   agentMemory: true,
+  enableStreaming: true,
   streamInsert: true,
   pqTraining: true,
   velesqlQuery: true,
@@ -58,6 +59,7 @@ var WASM_CAPABILITIES = Object.freeze({
   graphTraversal: false,
   secondaryIndexes: false,
   agentMemory: false,
+  enableStreaming: false,
   streamInsert: false,
   pqTraining: false,
   velesqlQuery: false,
@@ -752,6 +754,9 @@ function validateCollectionName(name) {
     );
   }
 }
+async function safeJsonParse(response) {
+  return response.json().catch(() => ({}));
+}
 function toNumberArray(v) {
   return v instanceof Float32Array ? Array.from(v) : v;
 }
@@ -805,12 +810,18 @@ async function wasmScroll(_collection, _request) {
 async function wasmTrainPq(_collection, _options) {
   wasmNotSupported("PQ training");
 }
+async function wasmEnableStreaming(_collection, _config) {
+  wasmNotSupported("Streaming enable");
+}
 async function wasmStreamInsert(_collection, _docs) {
   wasmNotSupported("Streaming insert");
 }
 async function wasmStreamUpsertPoints(_collection, _docs) {
   wasmNotSupported("Streaming batch upsert");
 }
+async function wasmUpsertBatchRaw(_collection, _docs) {
+  wasmNotSupported("Binary bulk upsert (upsertBatchRaw)");
+}
 async function wasmCreateGraphCollection(_name, _config) {
   wasmNotSupported("Graph collections");
 }
@@ -826,6 +837,9 @@ async function wasmGetCollectionConfig(_collection) {
 async function wasmSearchIds(_collection, _query, _options) {
   wasmNotSupported("searchIds");
 }
+async function wasmMultiQuerySearchIds(_collection, _vectors, _options) {
+  wasmNotSupported("multiQuerySearchIds");
+}
 async function wasmStoreSemanticFact(_collection, _entry) {
   wasmNotSupported("Agent memory");
 }
@@ -1082,6 +1096,9 @@ var WasmBackend = class {
       }
     }
   }
+  async upsertBatchRaw(c, d) {
+    return wasmUpsertBatchRaw(c, d);
+  }
   async delete(collectionName, id) {
     this.ensureInitialized();
     const collection = this.collections.get(collectionName);
@@ -1213,6 +1230,10 @@ var WasmBackend = class {
     this.ensureInitialized();
     return wasmTrainPq(c, o);
   }
+  async enableStreaming(c, cfg) {
+    this.ensureInitialized();
+    return wasmEnableStreaming(c, cfg);
+  }
   async streamInsert(c, d) {
     this.ensureInitialized();
     return wasmStreamInsert(c, d);
@@ -1241,6 +1262,10 @@ var WasmBackend = class {
     this.ensureInitialized();
     return wasmSearchIds(c, q, o);
   }
+  async multiQuerySearchIds(c, v, o) {
+    this.ensureInitialized();
+    return wasmMultiQuerySearchIds(c, v, o);
+  }
   async storeSemanticFact(c, e) {
     this.ensureInitialized();
     return wasmStoreSemanticFact(c, e);
@@ -1345,6 +1370,9 @@ var WasmBackend = class {
 };
 
 // src/backends/crud-backend.ts
+var RAW_BULK_HEADER_LEN = 16;
+var RAW_BULK_MAGIC = [86, 82, 66, 49];
+var RAW_BULK_ID_WIDTH = 8;
 var U64_MAX = 18446744073709551615n;
 function coerceDecimalStringId(id) {
   if (!/^\d+$/.test(id)) return NaN;
@@ -1495,6 +1523,105 @@ async function flush(transport, collection) {
   );
   throwOnError(response, `Collection '${collection}'`);
 }
+function encodeRawBulk(ids, vectors, dim) {
+  const count = ids.length;
+  if (vectors.length !== count) {
+    throw new ValidationError(
+      `encodeRawBulk: ids length (${count}) must match vectors length (${vectors.length})`
+    );
+  }
+  const buf = new Uint8Array(RAW_BULK_HEADER_LEN + count * 8 + count * dim * 4);
+  const view = new DataView(buf.buffer);
+  buf.set(RAW_BULK_MAGIC, 0);
+  view.setUint32(4, count, true);
+  view.setUint32(8, dim, true);
+  buf[12] = RAW_BULK_ID_WIDTH;
+  writeIds(view, ids);
+  writeVectors(view, vectors, dim, count);
+  return buf;
+}
+function writeIds(view, ids) {
+  let off = RAW_BULK_HEADER_LEN;
+  for (const id of ids) {
+    view.setBigUint64(off, BigInt(id), true);
+    off += 8;
+  }
+}
+function writeVectors(view, vectors, dim, count) {
+  let off = RAW_BULK_HEADER_LEN + count * 8;
+  for (const vec of vectors) {
+    if (vec.length !== dim) {
+      throw new ValidationError(
+        `encodeRawBulk: vector length (${vec.length}) must match dim (${dim})`
+      );
+    }
+    for (let i = 0; i < dim; i++) {
+      view.setFloat32(off, vec[i] ?? 0, true);
+      off += 4;
+    }
+  }
+}
+async function upsertBatchRaw(transport, collection, docs, dim) {
+  const ids = docs.map((d) => coerceNumericId(d.id));
+  const vectors = docs.map((d) => d.vector);
+  const body = encodeRawBulk(ids, vectors, dim);
+  return sendRawBulk(transport, collection, body);
+}
+function coerceNumericId(id) {
+  const parsed = parseRestPointId(id);
+  if (typeof parsed === "string") {
+    throw new ValidationError(
+      `upsertBatchRaw requires ids in the JS safe integer range; received: ${parsed}`
+    );
+  }
+  return parsed;
+}
+async function sendRawBulk(transport, collection, body) {
+  const url = `${transport.baseUrl}${collectionPath(collection)}/points/raw`;
+  const headers = {
+    "Content-Type": "application/octet-stream"
+  };
+  if (transport.apiKey) {
+    headers["Authorization"] = `Bearer ${transport.apiKey}`;
+  }
+  const controller = new AbortController();
+  const timeoutId = setTimeout(() => controller.abort(), transport.timeout);
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body,
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+    return await parseRawBulkResponse(response);
+  } catch (error) {
+    clearTimeout(timeoutId);
+    throw wrapRawBulkError(error);
+  }
+}
+async function parseRawBulkResponse(response) {
+  const data = await safeJsonParse(response);
+  if (!response.ok) {
+    const code = typeof data.code === "string" ? data.code : `HTTP_${response.status}`;
+    const message = typeof data.error === "string" ? data.error : `HTTP ${response.status}`;
+    throw new VelesDBError(message, code);
+  }
+  return typeof data.count === "number" ? data.count : 0;
+}
+function wrapRawBulkError(error) {
+  if (error instanceof VelesDBError) {
+    return error;
+  }
+  if (error instanceof Error && error.name === "AbortError") {
+    return new ConnectionError("Request timeout");
+  }
+  const message = error instanceof Error ? error.message : "Unknown error";
+  return new ConnectionError(
+    `Raw bulk upsert failed: ${message}`,
+    error instanceof Error ? error : void 0
+  );
+}
 
 // src/backends/rest-http.ts
 var STATUS_ERROR_CODES = {
@@ -1565,7 +1692,7 @@ async function request(config, method, path, body) {
       signal: controller.signal
     });
     clearTimeout(timeoutId);
-    const data = await response.json().catch(() => ({}));
+    const data = await safeJsonParse(response);
     if (!response.ok) {
       const ep = extractErrorPayload(data);
       return { error: {
@@ -1589,6 +1716,13 @@ function buildCrudTransport(config) {
     requestJson: (m, p, b) => request(config, m, p, b)
   };
 }
+function buildRawBulkTransport(config) {
+  return {
+    baseUrl: config.baseUrl,
+    apiKey: config.apiKey,
+    timeout: config.timeout
+  };
+}
 function buildSearchTransport(config) {
   return {
     requestJson: (m, p, b) => request(config, m, p, b),
@@ -2076,6 +2210,22 @@ async function multiQuerySearch(transport, collection, vectors, options) {
   throwOnError(response, `Collection '${collection}'`);
   return response.data?.results ?? [];
 }
+async function multiQuerySearchIds(transport, collection, vectors, options) {
+  const formattedVectors = vectors.map(toNumberArray);
+  const response = await transport.requestJson("POST", `${collectionPath(collection)}/search/multi/ids`, {
+    vectors: formattedVectors,
+    top_k: options?.k ?? 10,
+    strategy: options?.fusion ?? "rrf",
+    rrf_k: options?.fusionParams?.k ?? 60,
+    avg_weight: options?.fusionParams?.avgWeight,
+    max_weight: options?.fusionParams?.maxWeight,
+    hit_weight: options?.fusionParams?.hitWeight,
+    dense_weight: options?.fusionParams?.denseWeight,
+    sparse_weight: options?.fusionParams?.sparseWeight
+  });
+  throwOnError(response, `Collection '${collection}'`);
+  return response.data?.results ?? [];
+}
 async function sparseSearchNamed(transport, collection, query3, indexName, options) {
   const body = {
     sparse_vectors: { [indexName]: transport.sparseToRest(query3) },
@@ -2293,7 +2443,7 @@ async function query(transport, collection, queryString, params, options) {
   );
   throwOnError(response, `Collection '${collection}'`);
   const rawData = response.data;
-  if (rawData && Object.prototype.hasOwnProperty.call(rawData, "result")) {
+  if (rawData != null && Object.prototype.hasOwnProperty.call(rawData, "result")) {
     return {
       result: rawData.result,
       stats: {
@@ -2563,7 +2713,7 @@ async function streamInsert(transport, collection, docs) {
         throw new BackpressureError();
       }
       if (!response.ok && response.status !== 202) {
-        const data = await response.json().catch(() => ({}));
+        const data = await safeJsonParse(response);
         const errorPayload = transport.extractErrorPayload(data);
         throw new VelesDBError(
           errorPayload.message ?? `HTTP ${response.status}`,
@@ -2585,6 +2735,24 @@ async function streamInsert(transport, collection, docs) {
     }
   }
 }
+async function enableStreaming(transport, collection, config) {
+  const body = {};
+  if (config?.bufferSize !== void 0) {
+    body.buffer_size = config.bufferSize;
+  }
+  if (config?.batchSize !== void 0) {
+    body.batch_size = config.batchSize;
+  }
+  if (config?.flushIntervalMs !== void 0) {
+    body.flush_interval_ms = config.flushIntervalMs;
+  }
+  const response = await transport.requestJson(
+    "POST",
+    `${collectionPath(collection)}/stream/enable`,
+    body
+  );
+  throwOnError(response);
+}
 function requireSafeRangeId(restId) {
   if (typeof restId === "string") {
     throw new ValidationError(
@@ -2629,14 +2797,14 @@ async function streamUpsertPoints(transport, collection, docs) {
       throw new BackpressureError();
     }
     if (!response.ok) {
-      const data2 = await response.json().catch(() => ({}));
+      const data2 = await safeJsonParse(response);
       const errorPayload = transport.extractErrorPayload(data2);
       throw new VelesDBError(
         errorPayload.message ?? `HTTP ${response.status}`,
         errorPayload.code ?? transport.mapStatusToErrorCode(response.status)
       );
     }
-    const data = await response.json().catch(() => ({}));
+    const data = await safeJsonParse(response);
     return {
       message: typeof data.message === "string" ? data.message : "Stream processed",
       inserted: typeof data.inserted === "number" ? data.inserted : 0,
@@ -2721,6 +2889,10 @@ var RestBackend = class {
     this.ensureInitialized();
     return upsertBatch(buildCrudTransport(this.httpConfig), c, d);
   }
+  async upsertBatchRaw(c, d) {
+    this.ensureInitialized();
+    return upsertBatchRaw(buildRawBulkTransport(this.httpConfig), c, d, d[0]?.vector.length ?? 0);
+  }
   async delete(c, id) {
     this.ensureInitialized();
     return deletePoint(buildCrudTransport(this.httpConfig), c, id);
@@ -2823,6 +2995,10 @@ var RestBackend = class {
     this.ensureInitialized();
     return multiQuerySearch(buildSearchTransport(this.httpConfig), c, v, o);
   }
+  async multiQuerySearchIds(c, v, o) {
+    this.ensureInitialized();
+    return multiQuerySearchIds(buildSearchTransport(this.httpConfig), c, v, o);
+  }
   async searchIds(c, q, o) {
     this.ensureInitialized();
     return searchIds(buildSearchTransport(this.httpConfig), c, q, o);
@@ -2909,6 +3085,10 @@ var RestBackend = class {
     this.ensureInitialized();
     return trainPq(buildStreamingTransport(this.httpConfig), c, o);
   }
+  async enableStreaming(c, cfg) {
+    this.ensureInitialized();
+    return enableStreaming(buildStreamingTransport(this.httpConfig), c, cfg);
+  }
   async streamInsert(c, d) {
     this.ensureInitialized();
     return streamInsert(buildStreamingTransport(this.httpConfig), c, d);
@@ -3091,9 +3271,21 @@ function multiQuerySearch2(backend, collection, vectors, options) {
   }
   return backend.multiQuerySearch(collection, vectors, options);
 }
+function multiQuerySearchIds2(backend, collection, vectors, options) {
+  if (!Array.isArray(vectors) || vectors.length === 0) {
+    throw new ValidationError("Vectors must be a non-empty array");
+  }
+  for (const v of vectors) {
+    requireVector(v, "Each vector");
+  }
+  return backend.multiQuerySearchIds(collection, vectors, options);
+}
 function trainPq2(backend, collection, options) {
   return backend.trainPq(collection, options);
 }
+function enableStreaming2(backend, collection, config) {
+  return backend.enableStreaming(collection, config);
+}
 function streamInsert2(backend, config, collection, docs) {
   validateDocsBatch(docs, (doc) => {
     validateDocument(doc, config);
@@ -3362,6 +3554,24 @@ var VelesDB = class {
     });
     await this.backend.upsertBatch(collection, docs);
   }
+  /**
+   * Bulk upsert via the binary wire format (REST backend only).
+   *
+   * Encodes `(id, vector)` pairs into the deterministic VRB1 binary layout
+   * and sends them as a single `application/octet-stream` request, avoiding
+   * per-point JSON overhead. Payloads are not carried — use
+   * {@link upsertBatch} when you need them. Throws a not-supported error on
+   * the WASM backend.
+   *
+   * @returns the number of points the server reports as inserted.
+   */
+  async upsertBatchRaw(collection, docs) {
+    this.ensureInitialized();
+    validateDocsBatch(docs, (doc) => {
+      validateDocument(doc, this.config);
+    });
+    return this.backend.upsertBatchRaw(collection, docs);
+  }
   async delete(collection, id) {
     this.ensureInitialized();
     validateRestPointId(id, this.config);
@@ -3409,6 +3619,11 @@ var VelesDB = class {
     this.ensureInitialized();
     return multiQuerySearch2(this.backend, collection, vectors, options);
   }
+  /** Multi-query fusion search returning only IDs and scores (no payloads). */
+  async multiQuerySearchIds(collection, vectors, options) {
+    this.ensureInitialized();
+    return multiQuerySearchIds2(this.backend, collection, vectors, options);
+  }
   /**
    * Pure sparse search against a named sparse index.
    *
@@ -3439,6 +3654,10 @@ var VelesDB = class {
     this.ensureInitialized();
     return trainPq2(this.backend, collection, options);
   }
+  async enableStreaming(collection, config) {
+    this.ensureInitialized();
+    return enableStreaming2(this.backend, collection, config);
+  }
   async streamInsert(collection, docs) {
     this.ensureInitialized();
     return streamInsert2(this.backend, this.config, collection, docs);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiscale/velesdb-sdk",
-  "version": "2.0.0",
+  "version": "3.0.0",
   "description": "VelesDB TypeScript SDK: The Local Vector Database for AI & RAG. Microsecond semantic search in Browser & Node.js.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -69,12 +69,13 @@
     "vitest": "^4.0.16"
   },
   "dependencies": {
-    "@wiscale/velesdb-wasm": "^1.4.1"
+    "@wiscale/velesdb-wasm": "^2.0.0"
   },
   "engines": {
     "node": ">=18.0.0"
   },
   "overrides": {
-    "minimatch": "^9.0.7"
+    "minimatch": "^9.0.7",
+    "esbuild": ">=0.28.1"
   }
 }