@geodedb/client 1.0.2 → 1.3.1

package/README.md

@@ -64,6 +64,9 @@ host:port                                          # Simple format (uses QUIC)
 | `hello_name`      | Client name                       | geode-nodejs |
 | `hello_ver`       | Client version                    | 1.0.0        |
 | `conformance`     | GQL conformance level             | min          |
+| `graph`           | Graph to bind the session to      | -            |
+| `tenant`          | Tenant identifier (multi-tenant)  | -            |
+| `role`            | FLE role for field-level access   | -            |
 | `tls`             | Enable TLS (gRPC only)            | true         |
 | `insecure_tls_skip_verify` | Skip TLS verification (dev only)  | false        |
 | `ca`              | Path to CA certificate            | -            |
@@ -72,6 +75,7 @@ host:port                                          # Simple format (uses QUIC)
 | `server_name`     | SNI server name                   | -            |
 | `connect_timeout` | Connection timeout (ms)           | 30000        |
 | `request_timeout` | Request timeout (ms)              | 120000       |
+| `inline_timeout`  | Wait for the inline first page before falling back to PULL (ms) | 5000 |
 
 ### Environment Variables
 
@@ -83,6 +87,8 @@ host:port                                          # Simple format (uses QUIC)
 | `GEODE_TLS_CA`    | Default CA certificate path    |
 | `GEODE_USERNAME`  | Default username               |
 | `GEODE_PASSWORD`  | Default password               |
+| `GEODE_TENANT`    | Default tenant identifier      |
+| `GEODE_ROLE`      | Default FLE role               |
 
 ### Example Configurations
 
@@ -428,6 +434,17 @@ const value = fromJSON({ name: 'Alice', age: 30 });
 | UUID       | string        |
 | JSON/JSONB | any           |
 
+#### 64-bit integers
+
+INT/BIGINT columns and node/edge ids are 64-bit on the wire and decode
+losslessly: a plain `number` when the value fits in the safe-integer range
+(`|v| <= 2^53 - 1`), an exact `bigint` otherwise. Node and edge ids
+(`GQLNode.id`, `GQLEdge.startNode`/`endNode`) are always `bigint`.
+
+> **Note:** `JSON.stringify()` throws `TypeError: Do not know how to serialize a
+> BigInt` on rows containing bigints. Convert first, e.g.
+> `JSON.stringify(row, (_k, v) => (typeof v === 'bigint' ? v.toString() : v))`.
+
 ## Error Handling
 
 ```typescript