@wiscale/velesdb-sdk 1.9.3 → 1.11.0

package/README.md

@@ -2,15 +2,23 @@
 
 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.
 
-**v1.9.2** | Node.js >= 18 | Browser (WASM) | MIT License
+**v1.11.0** | Node.js >= 18 | Browser (WASM) | MIT License
 
-## What's New in v1.9.2
+## What's New in v1.11.0
 
-- **SearchQuality type** -- new `SearchQuality` type and `quality` field in `SearchOptions` for per-query recall/latency control (`fast`, `balanced`, `accurate`, `perfect`, `custom:N`, `adaptive:min:max`)
+- **15 new VelesQL statements** -- SHOW COLLECTIONS, DESCRIBE, EXPLAIN, CREATE/DROP INDEX, ANALYZE, TRUNCATE, ALTER COLLECTION, FLUSH, multi-row INSERT, UPSERT, SELECT EDGES, INSERT NODE
+- **203 BDD E2E tests** -- comprehensive end-to-end test coverage for all VelesQL features
+- **TRUNCATE on graph collections** -- clears nodes + edges in a single statement
+- **Python `execute_query()`** -- full VelesQL execution from Python bindings
+- **Cyclomatic complexity ≤ 8** -- refactored 6 hotspots for Codacy compliance
+
+### Previous (v1.10.0)
+
+- **SearchQuality type** -- `SearchQuality` type and `quality` field in `SearchOptions`
 - **StorageMode in HnswParams** -- `storageMode` field in HNSW configuration
-- **Relative score fusion** -- `'relative_score'` fusion strategy in `MultiQuerySearchOptions`
-- **DistanceMetric "ip" alias** -- `"ip"` accepted as an alias for `"dot"` (inner product)
-- **StorageMode aliases** -- `"f32"`, `"int8"`, `"bit"` accepted as aliases for `"full"`, `"sq8"`, `"binary"`
+- **Relative score fusion** -- `'relative_score'` fusion strategy
+- **DistanceMetric "ip" alias** -- `"ip"` accepted as alias for `"dot"`
+- **StorageMode aliases** -- `"f32"`, `"int8"`, `"bit"` accepted
 
 ### Previous (v1.9.1)
 

package/dist/index.d.mts

@@ -321,7 +321,11 @@ interface AggregationQueryResponse {
     /** Execution statistics */
     stats: QueryStats;
 }
-/** Unified response type for `query()` (rows or aggregation). */
+/** Unified response type for `query()` (rows, aggregation, or DDL).
+ *
+ * DDL statements (CREATE, DROP) and mutations (INSERT EDGE, DELETE) return
+ * a standard `QueryResponse` with an empty `results` array.
+ */
 type QueryApiResponse = QueryResponse | AggregationQueryResponse;
 /** Query explain request/response metadata */
 interface ExplainPlanStep {

package/dist/index.d.ts

@@ -321,7 +321,11 @@ interface AggregationQueryResponse {
     /** Execution statistics */
     stats: QueryStats;
 }
-/** Unified response type for `query()` (rows or aggregation). */
+/** Unified response type for `query()` (rows, aggregation, or DDL).
+ *
+ * DDL statements (CREATE, DROP) and mutations (INSERT EDGE, DELETE) return
+ * a standard `QueryResponse` with an empty `results` array.
+ */
 type QueryApiResponse = QueryResponse | AggregationQueryResponse;
 /** Query explain request/response metadata */
 interface ExplainPlanStep {

package/dist/index.js

@@ -909,8 +909,11 @@ function isLikelyAggregationQuery(queryString) {
     queryString
   );
 }
+function isLikelyDdlOrMutationQuery(queryString) {
+  return /^\s*(CREATE|DROP)\s+(COLLECTION|GRAPH|METADATA|INDEX)\b/i.test(queryString) || /^\s*DELETE\s+(FROM|EDGE)\b/i.test(queryString) || /^\s*INSERT\s+(INTO|EDGE|NODE)\b/i.test(queryString) || /^\s*UPSERT\s+INTO\b/i.test(queryString) || /^\s*(SHOW|DESCRIBE|EXPLAIN)\b/i.test(queryString) || /^\s*(FLUSH|ANALYZE|TRUNCATE)\b/i.test(queryString) || /^\s*ALTER\s+COLLECTION\b/i.test(queryString) || /^\s*SELECT\s+EDGES\b/i.test(queryString);
+}
 async function query(transport, collection, queryString, params, options) {
-  const endpoint = isLikelyAggregationQuery(queryString) ? "/aggregate" : "/query";
+  const endpoint = isLikelyDdlOrMutationQuery(queryString) ? "/query" : isLikelyAggregationQuery(queryString) ? "/aggregate" : "/query";
   const response = await transport.requestJson(
     "POST",
     endpoint,

package/dist/index.mjs

@@ -863,8 +863,11 @@ function isLikelyAggregationQuery(queryString) {
     queryString
   );
 }
+function isLikelyDdlOrMutationQuery(queryString) {
+  return /^\s*(CREATE|DROP)\s+(COLLECTION|GRAPH|METADATA|INDEX)\b/i.test(queryString) || /^\s*DELETE\s+(FROM|EDGE)\b/i.test(queryString) || /^\s*INSERT\s+(INTO|EDGE|NODE)\b/i.test(queryString) || /^\s*UPSERT\s+INTO\b/i.test(queryString) || /^\s*(SHOW|DESCRIBE|EXPLAIN)\b/i.test(queryString) || /^\s*(FLUSH|ANALYZE|TRUNCATE)\b/i.test(queryString) || /^\s*ALTER\s+COLLECTION\b/i.test(queryString) || /^\s*SELECT\s+EDGES\b/i.test(queryString);
+}
 async function query(transport, collection, queryString, params, options) {
-  const endpoint = isLikelyAggregationQuery(queryString) ? "/aggregate" : "/query";
+  const endpoint = isLikelyDdlOrMutationQuery(queryString) ? "/query" : isLikelyAggregationQuery(queryString) ? "/aggregate" : "/query";
   const response = await transport.requestJson(
     "POST",
     endpoint,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiscale/velesdb-sdk",
-  "version": "1.9.3",
+  "version": "1.11.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",