@wiscale/velesdb-sdk 1.10.0 → 1.11.0

package/README.md

@@ -2,17 +2,17 @@
 
 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.10.0** | Node.js >= 18 | Browser (WASM) | MIT License
+**v1.11.0** | Node.js >= 18 | Browser (WASM) | MIT License
 
-## What's New in v1.10.0
+## What's New in v1.11.0
 
-- **VelesQL LET clause** -- named score bindings for custom scoring formulas
-- **Component scores** -- `vector_score`, `bm25_score`, `graph_score` resolve independently in ORDER BY
-- **WITH options functional** -- `mode`, `timeout_ms`, `rerank` now wired to execution (were parsed but ignored)
-- **Agent Memory VelesQL** -- query semantic/episodic/procedural memory via standard VelesQL
-- **USING FUSION k parameter** -- configurable RRF constant for hybrid text search
+- **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.9.2)
+### Previous (v1.10.0)
 
 - **SearchQuality type** -- `SearchQuality` type and `quality` field in `SearchOptions`
 - **StorageMode in HnswParams** -- `storageMode` field in HNSW configuration

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.10.0",
+  "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",