@reddb-io/client 1.26.2 → 1.26.4

package/README.md

@@ -75,6 +75,14 @@ For `http://` and `https://` connections, `connect()` verifies readiness with
 a lightweight `SELECT 1` round-trip. `/health` states such as `degraded` are
 transient during boot and are not fatal as long as queries succeed.
 
+RedWire query parameters retain `Float32Array`, `Float64Array`, `Uint8Array`
+and `Buffer` views through normalization, avoiding intermediate number arrays
+and base64 strings. The request owns its encoded bytes before `query()` yields;
+later mutations of caller-owned views do not change the sent request. The
+transport drops input-view references before waiting for the network. HTTP/gRPC
+keep the same JSON-compatible parameter envelopes. See the measured
+[encoding results](../../docs/perf/client-codecs-2026-10-23.md).
+
 ## Transactions
 
 Use `db.transaction()` when a group of writes must commit or roll back together.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reddb-io/client",
-  "version": "1.26.2",
+  "version": "1.26.4",
   "description": "Thin remote-only RedDB driver. Pure JavaScript — no install scripts, no native binary. Speaks RedWire/gRPC/HTTP. Embedded URIs (memory://, file://, red:///path) are rejected — use @reddb-io/sdk for those.",
   "type": "module",
   "main": "src/index.js",

package/src/core/reddb.js

@@ -122,7 +122,7 @@ export class RedDB {
 
   /** Execute a SQL query. Returns `{ statement, affected, columns, rows }`. */
   query(sql, ...params) {
-    const wireParams = normalizeQueryParams(params)
+    const wireParams = normalizeQueryParams(params, this.client.binaryQueryParams === true)
     if (wireParams == null) {
       return this.client.call('query', { sql }).then(normalizeExactNumbers)
     }

package/src/core/serialization.js

@@ -126,10 +126,20 @@ export function assertSupportedParam(value) {
   )
 }
 
-export function normalizeQueryParams(args) {
+function serializeBinaryParam(value) {
+  if (value instanceof Uint8Array || value instanceof Float32Array || value instanceof Float64Array) {
+    // Preserve the existing handling of empty, detached and resized views.
+    if (value.byteLength === 0) return serializeParam(value)
+    return value
+  }
+  return serializeParam(value)
+}
+
+export function normalizeQueryParams(args, binary = false) {
   if (args.length === 0) return null
-  if (args.length === 1 && Array.isArray(args[0])) return args[0].map(serializeParam)
-  return args.map(serializeParam)
+  const serialize = binary ? serializeBinaryParam : serializeParam
+  if (args.length === 1 && Array.isArray(args[0])) return args[0].map(serialize)
+  return args.map(serialize)
 }
 
 export function bytesToBase64(value) {

package/src/redwire-core.js

@@ -226,6 +226,8 @@ export class RedWireClient {
     this.reader = reader
     this.session = session
     this.serverFeatures = serverFeatures >>> 0
+    // RedWire consumes typed views directly; JSON transports use envelopes.
+    this.binaryQueryParams = true
     this.nextCorr = 1n
     this.nextStream = 1
     this.closed = false
@@ -357,6 +359,8 @@ export class RedWireClient {
       kind = isSelectQuery(sql) ? MessageKind.QueryBinary : MessageKind.Query
       payload = new TextEncoder().encode(sql)
     }
+    // The encoded payload owns its bytes; release caller views before suspending.
+    params = undefined
     await writeFrame(this.socket, kind, corr, payload)
     const resp = await this.reader.next()
     if (resp.kind === MessageKind.Result) {