@reddb-io/sdk 1.0.4 → 1.0.7

package/index.d.ts

@@ -224,6 +224,7 @@ export class RedDB {
   readonly vault: (collection?: string) => VaultClient
 
   query(sql: string): Promise<QueryResult>
+  query(sql: string, params: Array<number | string | null>): Promise<QueryResult>
   insert(collection: string, payload: Record<string, unknown>): Promise<InsertResult>
   bulkInsert(
     collection: string,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reddb-io/sdk",
-  "version": "1.0.4",
+  "version": "1.0.7",
   "description": "Official RedDB driver — talks the native RedWire TCP protocol (mTLS), HTTP, gRPC bridge, or embedded stdio JSON-RPC. Works in Node 18+, Bun and Deno.",
   "type": "module",
   "main": "src/index.js",

package/postinstall.js

@@ -18,7 +18,7 @@
 
 import { createRequire } from 'node:module'
 import { fileURLToPath } from 'node:url'
-import { dirname, join } from 'node:path'
+import { dirname, join, sep } from 'node:path'
 import { existsSync, mkdirSync, writeFileSync, chmodSync } from 'node:fs'
 
 import { fetchReleaseAsset } from './src/internal/asset-fetcher/index.js'
@@ -34,16 +34,66 @@ if (process.env.REDDB_SKIP_POSTINSTALL === '1') {
   process.exit(0)
 }
 
-main().catch((err) => {
-  process.stderr.write(
-    `reddb: postinstall could not download the binary (${err.message}).\n` +
-      `       The package will still install. To use the driver you can:\n` +
-      `         - set REDDB_BINARY_PATH=/path/to/red\n` +
-      `         - or install the binary manually from https://github.com/${DEFAULT_REPO}/releases\n`,
+// Workspace-local install detection. When this file's resolved path is not
+// inside a `node_modules` tree we're running from a fresh checkout of the
+// reddb monorepo (or a fork), where `package.json` may already carry a
+// version whose GitHub Release has not been built yet — and where the
+// developer typically builds `red` with `cargo build` anyway. Skip the
+// download with a clear pointer; release flows still work because the npm
+// tarball, when installed, lives under `node_modules/`.
+if (!HERE.includes(`${sep}node_modules${sep}`)) {
+  process.stdout.write(
+    'reddb: skipping postinstall — running from a workspace checkout (no node_modules/).\n' +
+    '       If you need the binary, either:\n' +
+    '         - cargo build --release --bin red  &&  export REDDB_BIN="$PWD/target/release/red"\n' +
+    '         - or:  curl -fsSL https://raw.githubusercontent.com/reddb-io/reddb/main/install.sh | bash\n' +
+    '       Set REDDB_SKIP_POSTINSTALL=1 to silence this message.\n',
   )
   process.exit(0)
+}
+
+main().catch((err) => {
+  process.stderr.write(formatFailure(err))
+  process.exit(0)
 })
 
+function formatFailure(err) {
+  const repo = process.env.REDDB_POSTINSTALL_REPO || DEFAULT_REPO
+  if (err && err.code === 'UNSUPPORTED_PLATFORM') {
+    return (
+      `reddb: no prebuilt red binary for ${process.platform}/${process.arch}.\n` +
+      `       Options:\n` +
+      `         - build from source: https://github.com/${repo}#build-from-source\n` +
+      `         - or set REDDB_BIN=/path/to/red to point at one you compiled.\n`
+    )
+  }
+  if (err && err.code === 'ASSET_NOT_FOUND') {
+    return (
+      `reddb: release asset not found at ${err.url}\n` +
+      `       Common cause: the GitHub Release for this SDK version has not\n` +
+      `       been published yet (or your platform's binary was not produced\n` +
+      `       for that release). To unblock without reinstalling:\n` +
+      `         1. Install the latest stable red via the official installer\n` +
+      `            and point the SDK at it:\n` +
+      `              curl -fsSL https://raw.githubusercontent.com/${repo}/main/install.sh | bash\n` +
+      `              export REDDB_BIN="$(command -v red)"\n` +
+      `         2. Or pull a specific tag explicitly and re-run postinstall:\n` +
+      `              REDDB_POSTINSTALL_VERSION=v1.0.5 npm rebuild @reddb-io/sdk\n` +
+      `         3. Or skip the download entirely and provide the binary yourself:\n` +
+      `              REDDB_SKIP_POSTINSTALL=1 (re-install), then export REDDB_BIN=…\n` +
+      `       Releases: https://github.com/${repo}/releases\n`
+    )
+  }
+  return (
+    `reddb: postinstall could not download the binary (${err && err.message}).\n` +
+    `       The package itself still installs. To use the driver:\n` +
+    `         - run the installer: curl -fsSL https://raw.githubusercontent.com/${repo}/main/install.sh | bash\n` +
+    `           then: export REDDB_BIN="$(command -v red)"\n` +
+    `         - or download manually from https://github.com/${repo}/releases\n` +
+    `         - or set REDDB_BIN=/path/to/red.\n`
+  )
+}
+
 async function main() {
   const repo = process.env.REDDB_POSTINSTALL_REPO || DEFAULT_REPO
   const tag = process.env.REDDB_POSTINSTALL_VERSION

package/src/index.js

@@ -167,6 +167,17 @@ export async function connect(uri, options = {}) {
   )
 }
 
+// Coerce a JS query parameter to a JSON-serializable shape the server
+// understands. The tracer scope (#355) lifts vector params: `Float32Array`
+// and `Float64Array` round-trip as plain JSON arrays of numbers, which
+// the embedded stdio handler maps to `Value::Vector`.
+function serializeParam(value) {
+  if (value instanceof Float32Array || value instanceof Float64Array) {
+    return Array.from(value)
+  }
+  return value
+}
+
 function embeddedArgs(parsed) {
   if (parsed.path) return ['rpc', '--stdio', '--path', parsed.path]
   return ['rpc', '--stdio']
@@ -344,9 +355,27 @@ export class RedDB {
     this.vault = (collection = 'red.vault') => new VaultClient(client, collection)
   }
 
-  /** Execute a SQL query. Returns `{ statement, affected, columns, rows }`. */
-  query(sql) {
-    return this.client.call('query', { sql })
+  /**
+   * Execute a SQL query.
+   *
+   * Two signatures:
+   *   - `query(sql)` — legacy single-arg form.
+   *   - `query(sql, params)` — positional `$N` bind values. `params` is
+   *     an array (JS scalars: number | string | null map to engine
+   *     int/float / text / null). Indices in the SQL are 1-based
+   *     (`$1`, `$2`, ...), `params` is 0-based JS-style.
+   *
+   * Returns `{ statement, affected, columns, rows }`.
+   */
+  query(sql, params) {
+    if (params === undefined) {
+      return this.client.call('query', { sql })
+    }
+    if (!Array.isArray(params)) {
+      throw new TypeError('query: `params` must be an array')
+    }
+    const wireParams = params.map(serializeParam)
+    return this.client.call('query', { sql, params: wireParams })
   }
 
   /** Insert one row. Returns `{ affected, id? }`. */