@wiscale/velesdb-sdk 0.8.10 → 0.8.11

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2024-2026 Wiscale France
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Note: This MIT license applies to the TypeScript SDK code only.
+VelesDB Core itself is licensed under the Elastic License 2.0 (ELv2).
+See https://github.com/cyberlife-coder/VelesDB for VelesDB Core licensing.

package/README.md

@@ -188,6 +188,25 @@ const results = await db.query(
 );
 ```
 
+### `db.isEmpty(collection)` (v0.8.11+)
+
+Check if a collection is empty.
+
+```typescript
+const empty = await db.isEmpty('documents');
+if (empty) {
+  console.log('No vectors in collection');
+}
+```
+
+### `db.flush(collection)` (v0.8.11+)
+
+Flush pending changes to disk.
+
+```typescript
+await db.flush('documents');
+```
+
 ### `db.close()`
 
 Close the client and release resources.
@@ -219,4 +238,6 @@ try {
 
 ## License
 
-Elastic License 2.0 (ELv2) - See [LICENSE](../../LICENSE) for details.
+MIT License - See [LICENSE](./LICENSE) for details.
+
+VelesDB Core is licensed under ELv2 (source available).

package/dist/index.d.mts

@@ -121,6 +121,10 @@ interface IVelesDBBackend {
     }): Promise<SearchResult[]>;
     /** Execute VelesQL query */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /** Check if collection is empty */
+    isEmpty(collection: string): Promise<boolean>;
+    /** Flush pending changes to disk */
+    flush(collection: string): Promise<void>;
     /** Close/cleanup the backend */
     close(): Promise<void>;
 }
@@ -296,6 +300,19 @@ declare class VelesDB {
      * @returns Query results
      */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /**
+     * Check if a collection is empty
+     *
+     * @param collection - Collection name
+     * @returns true if empty, false otherwise
+     */
+    isEmpty(collection: string): Promise<boolean>;
+    /**
+     * Flush pending changes to disk
+     *
+     * @param collection - Collection name
+     */
+    flush(collection: string): Promise<void>;
     /**
      * Close the client and release resources
      */
@@ -349,6 +366,8 @@ declare class WasmBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(_queryString: string, _params?: Record<string, unknown>): Promise<SearchResult[]>;
+    isEmpty(collectionName: string): Promise<boolean>;
+    flush(collectionName: string): Promise<void>;
     close(): Promise<void>;
     private toNumericId;
 }
@@ -398,6 +417,8 @@ declare class RestBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    isEmpty(collection: string): Promise<boolean>;
+    flush(collection: string): Promise<void>;
     close(): Promise<void>;
 }
 

package/dist/index.d.ts

@@ -121,6 +121,10 @@ interface IVelesDBBackend {
     }): Promise<SearchResult[]>;
     /** Execute VelesQL query */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /** Check if collection is empty */
+    isEmpty(collection: string): Promise<boolean>;
+    /** Flush pending changes to disk */
+    flush(collection: string): Promise<void>;
     /** Close/cleanup the backend */
     close(): Promise<void>;
 }
@@ -296,6 +300,19 @@ declare class VelesDB {
      * @returns Query results
      */
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    /**
+     * Check if a collection is empty
+     *
+     * @param collection - Collection name
+     * @returns true if empty, false otherwise
+     */
+    isEmpty(collection: string): Promise<boolean>;
+    /**
+     * Flush pending changes to disk
+     *
+     * @param collection - Collection name
+     */
+    flush(collection: string): Promise<void>;
     /**
      * Close the client and release resources
      */
@@ -349,6 +366,8 @@ declare class WasmBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(_queryString: string, _params?: Record<string, unknown>): Promise<SearchResult[]>;
+    isEmpty(collectionName: string): Promise<boolean>;
+    flush(collectionName: string): Promise<void>;
     close(): Promise<void>;
     private toNumericId;
 }
@@ -398,6 +417,8 @@ declare class RestBackend implements IVelesDBBackend {
         filter?: Record<string, unknown>;
     }): Promise<SearchResult[]>;
     query(queryString: string, params?: Record<string, unknown>): Promise<SearchResult[]>;
+    isEmpty(collection: string): Promise<boolean>;
+    flush(collection: string): Promise<void>;
     close(): Promise<void>;
 }
 

package/dist/index.js

@@ -287,6 +287,21 @@ var WasmBackend = class {
       "NOT_SUPPORTED"
     );
   }
+  async isEmpty(collectionName) {
+    this.ensureInitialized();
+    const collection = this.collections.get(collectionName);
+    if (!collection) {
+      throw new NotFoundError(`Collection '${collectionName}'`);
+    }
+    return collection.store.is_empty();
+  }
+  async flush(collectionName) {
+    this.ensureInitialized();
+    const collection = this.collections.get(collectionName);
+    if (!collection) {
+      throw new NotFoundError(`Collection '${collectionName}'`);
+    }
+  }
   async close() {
     for (const [, data] of this.collections) {
       data.store.free();
@@ -591,6 +606,33 @@ var RestBackend = class {
     }
     return response.data?.results ?? [];
   }
+  async isEmpty(collection) {
+    this.ensureInitialized();
+    const response = await this.request(
+      "GET",
+      `/collections/${encodeURIComponent(collection)}/empty`
+    );
+    if (response.error) {
+      if (response.error.code === "NOT_FOUND") {
+        throw new NotFoundError(`Collection '${collection}'`);
+      }
+      throw new VelesDBError(response.error.message, response.error.code);
+    }
+    return response.data?.is_empty ?? true;
+  }
+  async flush(collection) {
+    this.ensureInitialized();
+    const response = await this.request(
+      "POST",
+      `/collections/${encodeURIComponent(collection)}/flush`
+    );
+    if (response.error) {
+      if (response.error.code === "NOT_FOUND") {
+        throw new NotFoundError(`Collection '${collection}'`);
+      }
+      throw new VelesDBError(response.error.message, response.error.code);
+    }
+  }
   async close() {
     this._initialized = false;
   }
@@ -839,6 +881,25 @@ var VelesDB = class {
     }
     return this.backend.query(queryString, params);
   }
+  /**
+   * Check if a collection is empty
+   * 
+   * @param collection - Collection name
+   * @returns true if empty, false otherwise
+   */
+  async isEmpty(collection) {
+    this.ensureInitialized();
+    return this.backend.isEmpty(collection);
+  }
+  /**
+   * Flush pending changes to disk
+   * 
+   * @param collection - Collection name
+   */
+  async flush(collection) {
+    this.ensureInitialized();
+    await this.backend.flush(collection);
+  }
   /**
    * Close the client and release resources
    */

package/dist/index.mjs

@@ -245,6 +245,21 @@ var WasmBackend = class {
       "NOT_SUPPORTED"
     );
   }
+  async isEmpty(collectionName) {
+    this.ensureInitialized();
+    const collection = this.collections.get(collectionName);
+    if (!collection) {
+      throw new NotFoundError(`Collection '${collectionName}'`);
+    }
+    return collection.store.is_empty();
+  }
+  async flush(collectionName) {
+    this.ensureInitialized();
+    const collection = this.collections.get(collectionName);
+    if (!collection) {
+      throw new NotFoundError(`Collection '${collectionName}'`);
+    }
+  }
   async close() {
     for (const [, data] of this.collections) {
       data.store.free();
@@ -549,6 +564,33 @@ var RestBackend = class {
     }
     return response.data?.results ?? [];
   }
+  async isEmpty(collection) {
+    this.ensureInitialized();
+    const response = await this.request(
+      "GET",
+      `/collections/${encodeURIComponent(collection)}/empty`
+    );
+    if (response.error) {
+      if (response.error.code === "NOT_FOUND") {
+        throw new NotFoundError(`Collection '${collection}'`);
+      }
+      throw new VelesDBError(response.error.message, response.error.code);
+    }
+    return response.data?.is_empty ?? true;
+  }
+  async flush(collection) {
+    this.ensureInitialized();
+    const response = await this.request(
+      "POST",
+      `/collections/${encodeURIComponent(collection)}/flush`
+    );
+    if (response.error) {
+      if (response.error.code === "NOT_FOUND") {
+        throw new NotFoundError(`Collection '${collection}'`);
+      }
+      throw new VelesDBError(response.error.message, response.error.code);
+    }
+  }
   async close() {
     this._initialized = false;
   }
@@ -797,6 +839,25 @@ var VelesDB = class {
     }
     return this.backend.query(queryString, params);
   }
+  /**
+   * Check if a collection is empty
+   * 
+   * @param collection - Collection name
+   * @returns true if empty, false otherwise
+   */
+  async isEmpty(collection) {
+    this.ensureInitialized();
+    return this.backend.isEmpty(collection);
+  }
+  /**
+   * Flush pending changes to disk
+   * 
+   * @param collection - Collection name
+   */
+  async flush(collection) {
+    this.ensureInitialized();
+    await this.backend.flush(collection);
+  }
   /**
    * Close the client and release resources
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiscale/velesdb-sdk",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "description": "Official TypeScript SDK for VelesDB - Vector Search in Microseconds",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -40,7 +40,7 @@
     "typescript"
   ],
   "author": "Wiscale France",
-  "license": "Elastic-2.0",
+  "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/cyberlife-coder/VelesDB.git",
@@ -63,7 +63,7 @@
     "vitest": "^4.0.16"
   },
   "dependencies": {
-    "@wiscale/velesdb-wasm": "^0.8.10"
+    "@wiscale/velesdb-wasm": "^0.8.11"
   },
   "engines": {
     "node": ">=18.0.0"