@reddb-io/sdk 1.23.1-rc.340 → 1.23.1-rc.342

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reddb-io/sdk",
-  "version": "1.23.1-rc.340",
+  "version": "1.23.1-rc.342",
   "description": "Official embedded RedDB SDK — launches a local red binary over stdio JSON-RPC. Use @reddb-io/client for remote HTTP, gRPC, and RedWire.",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -52,6 +52,9 @@ export const HELPER_SPEC_VERSION = '1.0'
 
 const MIN_INSERT_ID_ENGINE_VERSION = '1.0.9'
 const NESTED_TX_NOT_SUPPORTED = 'NESTED_TX_NOT_SUPPORTED'
+const MIN_I64 = -(1n << 63n)
+const MAX_I64 = (1n << 63n) - 1n
+const MAX_U64 = (1n << 64n) - 1n
 
 /**
  * Connect to a RedDB instance.
@@ -94,6 +97,9 @@ export async function connect(uri, options = {}) {
 // stdio/HTTP query parameter envelopes.
 function serializeParam(value) {
   assertSupportedParam(value)
+  if (typeof value === 'bigint') {
+    return exactIntegerEnvelope(value)
+  }
   if (value instanceof Float32Array || value instanceof Float64Array) {
     return Array.from(value)
   }
@@ -113,10 +119,39 @@ function serializeParam(value) {
   return value
 }
 
+function serializeJsonValue(value) {
+  if (typeof value === 'bigint') {
+    return exactIntegerEnvelope(value)
+  }
+  if (Array.isArray(value)) {
+    return value.map(serializeJsonValue)
+  }
+  if (value && typeof value === 'object' && Object.getPrototypeOf(value) === Object.prototype) {
+    if ('$number' in value || '$decimalText' in value) {
+      throw new RedDBError('UNSUPPORTED_EXACT_NUMBER', 'superseded exact-number envelope')
+    }
+    const out = {}
+    for (const [key, item] of Object.entries(value)) out[key] = serializeJsonValue(item)
+    return out
+  }
+  return value
+}
+
+function exactIntegerEnvelope(value) {
+  if (value >= MIN_I64 && value <= MAX_I64) {
+    return { $int: value.toString() }
+  }
+  if (value >= 0n && value <= MAX_U64) {
+    return { $uint: value.toString() }
+  }
+  throw new RedDBError('UNSUPPORTED_PARAM', 'integer value is outside i64/u64 range')
+}
+
 function assertSupportedParam(value) {
   if (value == null) return
   if (
     typeof value === 'boolean'
+    || typeof value === 'bigint'
     || typeof value === 'number'
     || typeof value === 'string'
   ) {
@@ -199,6 +234,13 @@ function normalizeResult(value) {
         if (value.$float === 'Infinity' || value.$float === '+Infinity') return Infinity
         if (value.$float === '-Infinity') return -Infinity
       }
+      if (typeof value.$int === 'string' || typeof value.$uint === 'string') {
+        return BigInt(value.$int ?? value.$uint)
+      }
+      if (typeof value.$decimal === 'string') return value.$decimal
+      if ('$number' in value || '$decimalText' in value) {
+        throw new RedDBError('UNSUPPORTED_EXACT_NUMBER', 'superseded exact-number envelope')
+      }
       if (typeof value.$ts === 'string' || typeof value.$ts === 'number') {
         const raw = typeof value.$ts === 'string'
           ? BigInt(value.$ts)
@@ -459,7 +501,10 @@ export class RedDB {
 
   /** Insert one row. Returns `{ affected, rid, id }`; `id` is a legacy alias. */
   async insert(collection, payload) {
-    const result = await this.client.call('insert', { collection, payload })
+    const result = await this.client.call('insert', {
+      collection,
+      payload: serializeJsonValue(payload),
+    }).then(normalizeResult)
     return requireInsertId(result, 'insert')
   }
 
@@ -469,7 +514,10 @@ export class RedDB {
     if (Array.isArray(payloads) && payloads.length === 0) {
       return { affected: 0, rids: [], ids: [] }
     }
-    const result = await this.client.call('bulk_insert', { collection, payloads })
+    const result = await this.client.call('bulk_insert', {
+      collection,
+      payloads: serializeJsonValue(payloads),
+    }).then(normalizeResult)
     return requireInsertIds(result, payloads.length)
   }
 
@@ -529,7 +577,7 @@ export class RedDB {
 
   /** Get an entity by id. Returns `{ entity }` (entity is `null` if not found). */
   get(collection, id) {
-    return this.client.call('get', { collection, id: String(id) })
+    return this.client.call('get', { collection, id: String(id) }).then(normalizeResult)
   }
 
   /** Delete an entity by id. Returns `{ affected }`. */

package/src/redwire.js

@@ -55,6 +55,9 @@ export const ValueTag = Object.freeze({
   Bytes: 0x05, Vector: 0x06, Json: 0x07, Timestamp: 0x08, Uuid: 0x09,
 })
 
+const MIN_I64 = -(1n << 63n)
+const MAX_I64 = (1n << 63n) - 1n
+
 /**
  * Typed value tags for the binary fast path. Identical to the
  * engine-side `wire::protocol::VAL_*` table.
@@ -809,10 +812,7 @@ export function encodeValue(v) {
   if (v === null || v === undefined) return Uint8Array.of(ValueTag.Null)
   if (typeof v === 'boolean') return Uint8Array.of(ValueTag.Bool, v ? 1 : 0)
   if (typeof v === 'bigint') {
-    const out = new Uint8Array(1 + 8)
-    out[0] = ValueTag.Int
-    new DataView(out.buffer).setBigInt64(1, v, true)
-    return out
+    return encodeInt(v)
   }
   if (typeof v === 'number') {
     if (Number.isInteger(v) && v >= -(2 ** 53) && v <= 2 ** 53) {
@@ -840,6 +840,12 @@ export function encodeValue(v) {
     const keys = Object.keys(v)
     if (keys.length === 1) {
       const k = keys[0]
+      if (k === '$int' && typeof v.$int === 'string') {
+        return encodeInt(BigInt(v.$int))
+      }
+      if (k === '$uint' || k === '$decimal') {
+        throw new RedDBError('UNSUPPORTED_PARAM', `${k} params require a JSON body transport`)
+      }
       if (k === '$bytes' && typeof v.$bytes === 'string') {
         return encodeLenPrefixed(ValueTag.Bytes, base64ToBytes(v.$bytes))
       }
@@ -866,6 +872,16 @@ export function encodeValue(v) {
   throw new RedDBError('UNSUPPORTED_PARAM', `cannot encode param of type ${typeof v}`)
 }
 
+function encodeInt(value) {
+  if (value < MIN_I64 || value > MAX_I64) {
+    throw new RedDBError('UNSUPPORTED_PARAM', 'integer param is outside i64 range')
+  }
+  const out = new Uint8Array(1 + 8)
+  out[0] = ValueTag.Int
+  new DataView(out.buffer).setBigInt64(1, value, true)
+  return out
+}
+
 function encodeLenPrefixed(tag, bytes) {
   if (bytes.length > MAX_VALUE_PAYLOAD_LEN) {
     throw new RedDBError('PAYLOAD_TOO_LARGE', `value len ${bytes.length} > ${MAX_VALUE_PAYLOAD_LEN}`)