hyperspace-sdk-ts 3.0.8 → 3.0.10

package/README.md

@@ -69,6 +69,19 @@ Create a new collection.
 
 Delete collection and all its data.
 
+### `listCollections()`
+
+Retrieve all active collections for the current tenant.
+Returns `Promise<CollectionInfo[]>`.
+
+```ts
+const collections = await client.listCollections();
+for (const col of collections) {
+  console.log(`${col.name}: dim=${col.dimension}, metric=${col.metric}, count=${col.count}`);
+}
+```
+
+
 ### `insert(id, vector, meta?, collection?, durability?)`
 
 Insert one vector. Accepts `number[]`, `Float32Array`, `Float64Array`.
@@ -109,6 +122,31 @@ const results = await client.searchText("How to use HyperspaceDB?", 10, "coll",
 });
 ```
 
+### Geometric Filters (New in v3.0)
+
+HyperspaceDB v3.0 introduces advanced spatial filters that run on the engine level:
+
+```ts
+// 1. Proximity Search (Ball)
+const ballFilter = {
+  inBall: { center: [0.1, 0.2, 0.3], radius: 0.5 }
+};
+
+// 2. Workspace Constraints (Box)
+const boxFilter = {
+  inBox: { minBounds: [-1, -1, -1], maxBounds: [1, 1, 1] }
+};
+
+// 3. Field of View / Angular Search (Cone)
+const coneFilter = {
+  inCone: { axes: [1.0, 0.0, 0.0], apertures: [0.5], cen: 0.01 }
+};
+
+const results = await client.search([0.1, 0.2, 0.3], 10, "coll", {
+  filters: [ballFilter, boxFilter]
+});
+```
+
 ### `searchBatch(vectors, topK, collection?)`
 
 Run multiple searches in one gRPC request to reduce RPC overhead.

package/dist/client.d.ts

@@ -26,6 +26,12 @@ export interface SearchResult {
         [key: string]: TypedMetadataValue;
     };
 }
+export interface CollectionInfo {
+    name: string;
+    count: number;
+    dimension: number;
+    metric: string;
+}
 export interface GraphNode {
     id: number;
     layer: number;
@@ -69,7 +75,7 @@ export declare class HyperspaceClient {
     constructor(host?: string, apiKey?: string, userId?: string);
     createCollection(name: string, dimension: number, metric: string): Promise<boolean>;
     deleteCollection(name: string): Promise<boolean>;
-    listCollections(): Promise<string[]>;
+    listCollections(): Promise<CollectionInfo[]>;
     delete(id: number, collection?: string): Promise<boolean>;
     insert(vector: number[] | Float32Array | Float64Array, id: number, meta?: {
         [key: string]: string;

package/dist/client.js

@@ -274,7 +274,13 @@ class HyperspaceClient {
             this.client.listCollections(req, this.metadata, (err, resp) => {
                 if (err)
                     return reject(err);
-                resolve(resp.getCollectionsList());
+                const list = resp.getCollectionsList().map(c => ({
+                    name: c.getName(),
+                    count: c.getCount(),
+                    dimension: c.getDimension(),
+                    metric: c.getMetric()
+                }));
+                resolve(list);
             });
         });
     }