@stoolap/node 0.5.0-beta.2 → 0.5.0-beta.4

package/README.md

@@ -402,7 +402,7 @@ db.querySync(
 );
 ```
 
-Synchronous ad hoc statements pass named parameters to the engine as they are: the SQL is not rewritten, a `:name` inside a string literal is left alone, a name used twice is bound once, keys the SQL does not mention are ignored and a name the object lacks binds `NULL`. A prepared statement, and the asynchronous ad hoc methods, resolve `:name` placeholders in the driver and bind by position, which is the engine's fastest path.
+Synchronous ad hoc statements pass named parameters to the engine as they are: the SQL is not rewritten, a `:name` inside a string literal is left alone, a name used twice is bound once, keys the SQL does not mention are ignored and a name the object lacks is an error. A prepared statement, and the asynchronous ad hoc methods, resolve `:name` placeholders in the driver and bind by position, which is the engine's fastest path.
 
 ### Error Handling
 

package/lib/ffi.js

@@ -163,8 +163,10 @@ function processParams(sql, params) {
 }
 
 /* Rewrite :name placeholders to $n for a prepared statement. The engine binds
- * prepared statements faster by position than by name, so a statement keeps
- * its parameter names and binds an object's values positionally. */
+ * prepared statements faster by position than by name (+10% on a point lookup
+ * since the engine's slot binding, +40% before), so a statement keeps its
+ * parameter names and binds an object's values positionally. Like the engine,
+ * it refuses an object that lacks one of the names. */
 function rewriteNamedParams(sql) {
   const seen = new Map();
   const names = [];

package/lib/parse.js

@@ -13,6 +13,35 @@ const td = new TextDecoder();
 
 let _off = 0;
 
+/* Short ASCII strings are cut from a latin1 decode of an 8 KB block of the
+ * buffer instead of one Buffer.toString call per value: latin1 maps bytes to
+ * chars one to one, so offsets hold, and String.prototype.substring is a pure
+ * V8 operation (~10 ns against ~40 ns for toString). Measured crossover is
+ * about 40 bytes; longer values and any value with a byte >= 0x80 take the
+ * utf8 path. The block is bounded so a kept string pins at most 8 KB. */
+const ASCII_FAST_MAX = 32;
+const BLOCK_SIZE = 8192;
+let _blk = "";
+let _blkStart = -1;
+let _blkEnd = -1;
+
+function readText(bytes, nb, start, len) {
+  const end = start + len;
+  if (len <= ASCII_FAST_MAX) {
+    let k = start;
+    while (k < end && bytes[k] < 128) k++;
+    if (k === end) {
+      if (start < _blkStart || end > _blkEnd) {
+        _blkStart = start;
+        _blkEnd = Math.max(end, Math.min(bytes.length, start + BLOCK_SIZE));
+        _blk = nb.toString("latin1", _blkStart, _blkEnd);
+      }
+      return _blk.substring(start - _blkStart, end - _blkStart);
+    }
+  }
+  return nb.toString("utf8", start, end);
+}
+
 function readVal(bytes, dv, nb) {
   const tag = bytes[_off++];
   switch (tag) {
@@ -39,7 +68,7 @@ function readVal(bytes, dv, nb) {
       const start = _off;
       _off += len;
       return nb
-        ? nb.toString("utf8", start, start + len)
+        ? readText(bytes, nb, start, len)
         : td.decode(
             new Uint8Array(bytes.buffer, bytes.byteOffset + start, len),
           );
@@ -75,6 +104,7 @@ function parseRows(abuf) {
   const nb = _hasBuffer ? Buffer.from(abuf) : null;
 
   _off = 0;
+  _blkEnd = -1;
   const colCount = dv.getUint32(0, true);
   _off = 4;
   const colNames = new Array(colCount);
@@ -107,6 +137,7 @@ function parseRaw(abuf) {
   const nb = _hasBuffer ? Buffer.from(abuf) : null;
 
   _off = 0;
+  _blkEnd = -1;
   const colCount = dv.getUint32(0, true);
   _off = 4;
   const colNames = new Array(colCount);
@@ -176,6 +207,7 @@ function parseRowsCached(abuf, headerOff, factory, colCount) {
   const dv = new DataView(abuf);
   const nb = _hasBuffer ? Buffer.from(abuf) : null;
   _off = headerOff;
+  _blkEnd = -1;
   const rowCount = dv.getUint32(_off, true);
   _off += 4;
   const results = new Array(rowCount);

package/lib/statement.js

@@ -273,7 +273,13 @@ class PreparedStatement {
     const names = this.#paramNames;
     if (!names) return null;
     const values = new Array(names.length);
-    for (let i = 0; i < names.length; i++) values[i] = params[names[i]];
+    for (let i = 0; i < names.length; i++) {
+      const name = names[i];
+      if (!(name in params)) {
+        throw new Error(`invalid argument: named parameter :${name} has no value`);
+      }
+      values[i] = params[name];
+    }
     return values;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stoolap/node",
-  "version": "0.5.0-beta.2",
+  "version": "0.5.0-beta.4",
   "description": "High-performance Node.js driver for Stoolap embedded SQL database",
   "main": "index.js",
   "types": "index.d.ts",
@@ -18,11 +18,11 @@
     "bench": "node benchmark.mjs"
   },
   "optionalDependencies": {
-    "@stoolap/lib-darwin-arm64": "0.5.0-beta.2",
-    "@stoolap/lib-darwin-x64": "0.5.0-beta.2",
-    "@stoolap/lib-linux-arm64-gnu": "0.5.0-beta.2",
-    "@stoolap/lib-linux-x64-gnu": "0.5.0-beta.2",
-    "@stoolap/lib-win32-x64-msvc": "0.5.0-beta.2"
+    "@stoolap/lib-darwin-arm64": "0.5.0-beta.4",
+    "@stoolap/lib-darwin-x64": "0.5.0-beta.4",
+    "@stoolap/lib-linux-arm64-gnu": "0.5.0-beta.4",
+    "@stoolap/lib-linux-x64-gnu": "0.5.0-beta.4",
+    "@stoolap/lib-win32-x64-msvc": "0.5.0-beta.4"
   },
   "devDependencies": {
     "better-sqlite3": "^12.6.2",