@geodedb/client 1.0.0-alpha.13 → 1.0.0-alpha.14

package/dist/index.d.mts

@@ -381,11 +381,23 @@ interface GQLRange<T = unknown> {
     lowerInclusive: boolean;
     upperInclusive: boolean;
 }
+/**
+ * Type alias for node/edge IDs.
+ *
+ * IDs can be:
+ * - string: String-based IDs or hex format IDs
+ * - number: Integer IDs within JavaScript's safe integer range
+ * - bigint: Integer IDs larger than Number.MAX_SAFE_INTEGER (2^53 - 1)
+ *
+ * Note: Geode's internal IDs often exceed JavaScript's safe integer limit,
+ * so bigint is used to preserve full precision.
+ */
+type GQLId = string | number | bigint;
 /**
  * Node structure from graph queries.
  */
 interface GQLNode {
-    id: string | number;
+    id: GQLId;
     labels: string[];
     properties: Record<string, unknown>;
 }
@@ -393,10 +405,10 @@ interface GQLNode {
  * Edge structure from graph queries.
  */
 interface GQLEdge {
-    id: string | number;
+    id: GQLId;
     type: string;
-    startNode: string | number;
-    endNode: string | number;
+    startNode: GQLId;
+    endNode: GQLId;
     properties: Record<string, unknown>;
 }
 /**
@@ -1934,6 +1946,9 @@ interface Frame {
 }
 /**
  * Parse a JSON frame from raw bytes.
+ *
+ * Uses lossless-json to preserve precision for large integers (> Number.MAX_SAFE_INTEGER).
+ * This is critical for node/edge IDs which may be 18+ digit integers.
  */
 declare function parseFrame(data: Buffer | string): Frame;
 /**
@@ -1998,6 +2013,9 @@ declare function buildRollbackToMessage(name: string): Record<string, unknown>;
 declare function buildPingMessage(): Record<string, unknown>;
 /**
  * Serialize a message to JSON line format.
+ *
+ * Uses lossless-json with a custom BigInt stringifier to properly serialize
+ * BigInt values as numbers without quotes, maintaining wire protocol compatibility.
  */
 declare function serializeMessage(msg: Record<string, unknown>): Buffer;
 /**
@@ -2431,4 +2449,4 @@ declare function node(): NodePatternBuilder;
  */
 declare function edge(): EdgePatternBuilder;
 
-export { type AdditionalInfo, AuthClient, BaseTransport, type BatchOptions, type BatchQuery, type BatchResult, type BatchSummary, type ClientOptions, type ColumnDef, type ColumnInfo, ConfigError, Connection, ConnectionPool, type ConnectionState, type CreateRLSPolicyOptions, type CreateRoleOptions, type CreateUserOptions, DEFAULT_CONFORMANCE, DEFAULT_HELLO_NAME, DEFAULT_HELLO_VERSION, DEFAULT_PAGE_SIZE, DEFAULT_PORT, DriverError, type EdgeDirection, type EdgePattern, EdgePatternBuilder, ErrBadConn, ErrClosed, ErrNoTx, ErrQueryInProgress, ErrRowsClosed, ErrTxDone, ErrTxInProgress, type ExplainOptions, type Frame, type FrameResult, type GQLEdge, type GQLNode, type GQLPath, type GQLRange, type GQLType, GQLValue, type GQLValueKind, GeodeClient, type GeodeConfig, type GeodeError, MAX_PAGE_SIZE, MAX_QUERY_LENGTH, MockTransport, MsgType, type NodePattern, NodePatternBuilder, type OperationTiming, type ParameterInfo, PatternBuilder, type PatternElement, type Permission, type PlanOperation, type PoolConfig, PredicateBuilder, type PredicateOp, PreparedStatement, QueryBuilder, type QueryOptions, type QueryParams, type QueryPlan, type QueryProfile, QueryResult, QueryResultIterator, MatrixQuicTransport as QuicheTransport, type RLSPolicy, RespType, type Role, type Row, SecurityError, type SortDirection, StateError, StatusClass, type StatusClassType, Transaction, type Transport, TransportError, type User, batch, batchAll, batchFirst, batchMap, batchParallel, buildBeginMessage, buildCommitMessage, buildHelloMessage, buildPingMessage, buildPullMessage, buildRollbackMessage, buildRollbackToMessage, buildRunGQLMessage, buildSavepointMessage, buildTLSConfig, cloneConfig, countPlaceholders, createAuthClient, createClient, createClientWithConfig, createTransport, defaultConfig, edge, explain, extractParameters, formatPlan, formatProfile, frameToError, fromJSON, getAddress, getColumnsFromSchema, isBindingsFrame, isDriverError, isErrorFrame, isFinalFrame, isGeodeError, isRetryableError, isSchemaFrame, mergeParams, node, parseDSN, parseFrame, parseGQLType, parseRow, pattern, predicate, prepare, profile, query, rewritePlaceholders, rowToObject, sanitizeForLog, serializeMessage, validateConfig, validateHostname, validatePageSize, validateParamName, validateParamValue, validatePort, validateQuery, validateSavepointName, withTransaction };
+export { type AdditionalInfo, AuthClient, BaseTransport, type BatchOptions, type BatchQuery, type BatchResult, type BatchSummary, type ClientOptions, type ColumnDef, type ColumnInfo, ConfigError, Connection, ConnectionPool, type ConnectionState, type CreateRLSPolicyOptions, type CreateRoleOptions, type CreateUserOptions, DEFAULT_CONFORMANCE, DEFAULT_HELLO_NAME, DEFAULT_HELLO_VERSION, DEFAULT_PAGE_SIZE, DEFAULT_PORT, DriverError, type EdgeDirection, type EdgePattern, EdgePatternBuilder, ErrBadConn, ErrClosed, ErrNoTx, ErrQueryInProgress, ErrRowsClosed, ErrTxDone, ErrTxInProgress, type ExplainOptions, type Frame, type FrameResult, type GQLEdge, type GQLId, type GQLNode, type GQLPath, type GQLRange, type GQLType, GQLValue, type GQLValueKind, GeodeClient, type GeodeConfig, type GeodeError, MAX_PAGE_SIZE, MAX_QUERY_LENGTH, MockTransport, MsgType, type NodePattern, NodePatternBuilder, type OperationTiming, type ParameterInfo, PatternBuilder, type PatternElement, type Permission, type PlanOperation, type PoolConfig, PredicateBuilder, type PredicateOp, PreparedStatement, QueryBuilder, type QueryOptions, type QueryParams, type QueryPlan, type QueryProfile, QueryResult, QueryResultIterator, MatrixQuicTransport as QuicheTransport, type RLSPolicy, RespType, type Role, type Row, SecurityError, type SortDirection, StateError, StatusClass, type StatusClassType, Transaction, type Transport, TransportError, type User, batch, batchAll, batchFirst, batchMap, batchParallel, buildBeginMessage, buildCommitMessage, buildHelloMessage, buildPingMessage, buildPullMessage, buildRollbackMessage, buildRollbackToMessage, buildRunGQLMessage, buildSavepointMessage, buildTLSConfig, cloneConfig, countPlaceholders, createAuthClient, createClient, createClientWithConfig, createTransport, defaultConfig, edge, explain, extractParameters, formatPlan, formatProfile, frameToError, fromJSON, getAddress, getColumnsFromSchema, isBindingsFrame, isDriverError, isErrorFrame, isFinalFrame, isGeodeError, isRetryableError, isSchemaFrame, mergeParams, node, parseDSN, parseFrame, parseGQLType, parseRow, pattern, predicate, prepare, profile, query, rewritePlaceholders, rowToObject, sanitizeForLog, serializeMessage, validateConfig, validateHostname, validatePageSize, validateParamName, validateParamValue, validatePort, validateQuery, validateSavepointName, withTransaction };

package/dist/index.d.ts

@@ -381,11 +381,23 @@ interface GQLRange<T = unknown> {
     lowerInclusive: boolean;
     upperInclusive: boolean;
 }
+/**
+ * Type alias for node/edge IDs.
+ *
+ * IDs can be:
+ * - string: String-based IDs or hex format IDs
+ * - number: Integer IDs within JavaScript's safe integer range
+ * - bigint: Integer IDs larger than Number.MAX_SAFE_INTEGER (2^53 - 1)
+ *
+ * Note: Geode's internal IDs often exceed JavaScript's safe integer limit,
+ * so bigint is used to preserve full precision.
+ */
+type GQLId = string | number | bigint;
 /**
  * Node structure from graph queries.
  */
 interface GQLNode {
-    id: string | number;
+    id: GQLId;
     labels: string[];
     properties: Record<string, unknown>;
 }
@@ -393,10 +405,10 @@ interface GQLNode {
  * Edge structure from graph queries.
  */
 interface GQLEdge {
-    id: string | number;
+    id: GQLId;
     type: string;
-    startNode: string | number;
-    endNode: string | number;
+    startNode: GQLId;
+    endNode: GQLId;
     properties: Record<string, unknown>;
 }
 /**
@@ -1934,6 +1946,9 @@ interface Frame {
 }
 /**
  * Parse a JSON frame from raw bytes.
+ *
+ * Uses lossless-json to preserve precision for large integers (> Number.MAX_SAFE_INTEGER).
+ * This is critical for node/edge IDs which may be 18+ digit integers.
  */
 declare function parseFrame(data: Buffer | string): Frame;
 /**
@@ -1998,6 +2013,9 @@ declare function buildRollbackToMessage(name: string): Record<string, unknown>;
 declare function buildPingMessage(): Record<string, unknown>;
 /**
  * Serialize a message to JSON line format.
+ *
+ * Uses lossless-json with a custom BigInt stringifier to properly serialize
+ * BigInt values as numbers without quotes, maintaining wire protocol compatibility.
  */
 declare function serializeMessage(msg: Record<string, unknown>): Buffer;
 /**
@@ -2431,4 +2449,4 @@ declare function node(): NodePatternBuilder;
  */
 declare function edge(): EdgePatternBuilder;
 
-export { type AdditionalInfo, AuthClient, BaseTransport, type BatchOptions, type BatchQuery, type BatchResult, type BatchSummary, type ClientOptions, type ColumnDef, type ColumnInfo, ConfigError, Connection, ConnectionPool, type ConnectionState, type CreateRLSPolicyOptions, type CreateRoleOptions, type CreateUserOptions, DEFAULT_CONFORMANCE, DEFAULT_HELLO_NAME, DEFAULT_HELLO_VERSION, DEFAULT_PAGE_SIZE, DEFAULT_PORT, DriverError, type EdgeDirection, type EdgePattern, EdgePatternBuilder, ErrBadConn, ErrClosed, ErrNoTx, ErrQueryInProgress, ErrRowsClosed, ErrTxDone, ErrTxInProgress, type ExplainOptions, type Frame, type FrameResult, type GQLEdge, type GQLNode, type GQLPath, type GQLRange, type GQLType, GQLValue, type GQLValueKind, GeodeClient, type GeodeConfig, type GeodeError, MAX_PAGE_SIZE, MAX_QUERY_LENGTH, MockTransport, MsgType, type NodePattern, NodePatternBuilder, type OperationTiming, type ParameterInfo, PatternBuilder, type PatternElement, type Permission, type PlanOperation, type PoolConfig, PredicateBuilder, type PredicateOp, PreparedStatement, QueryBuilder, type QueryOptions, type QueryParams, type QueryPlan, type QueryProfile, QueryResult, QueryResultIterator, MatrixQuicTransport as QuicheTransport, type RLSPolicy, RespType, type Role, type Row, SecurityError, type SortDirection, StateError, StatusClass, type StatusClassType, Transaction, type Transport, TransportError, type User, batch, batchAll, batchFirst, batchMap, batchParallel, buildBeginMessage, buildCommitMessage, buildHelloMessage, buildPingMessage, buildPullMessage, buildRollbackMessage, buildRollbackToMessage, buildRunGQLMessage, buildSavepointMessage, buildTLSConfig, cloneConfig, countPlaceholders, createAuthClient, createClient, createClientWithConfig, createTransport, defaultConfig, edge, explain, extractParameters, formatPlan, formatProfile, frameToError, fromJSON, getAddress, getColumnsFromSchema, isBindingsFrame, isDriverError, isErrorFrame, isFinalFrame, isGeodeError, isRetryableError, isSchemaFrame, mergeParams, node, parseDSN, parseFrame, parseGQLType, parseRow, pattern, predicate, prepare, profile, query, rewritePlaceholders, rowToObject, sanitizeForLog, serializeMessage, validateConfig, validateHostname, validatePageSize, validateParamName, validateParamValue, validatePort, validateQuery, validateSavepointName, withTransaction };
+export { type AdditionalInfo, AuthClient, BaseTransport, type BatchOptions, type BatchQuery, type BatchResult, type BatchSummary, type ClientOptions, type ColumnDef, type ColumnInfo, ConfigError, Connection, ConnectionPool, type ConnectionState, type CreateRLSPolicyOptions, type CreateRoleOptions, type CreateUserOptions, DEFAULT_CONFORMANCE, DEFAULT_HELLO_NAME, DEFAULT_HELLO_VERSION, DEFAULT_PAGE_SIZE, DEFAULT_PORT, DriverError, type EdgeDirection, type EdgePattern, EdgePatternBuilder, ErrBadConn, ErrClosed, ErrNoTx, ErrQueryInProgress, ErrRowsClosed, ErrTxDone, ErrTxInProgress, type ExplainOptions, type Frame, type FrameResult, type GQLEdge, type GQLId, type GQLNode, type GQLPath, type GQLRange, type GQLType, GQLValue, type GQLValueKind, GeodeClient, type GeodeConfig, type GeodeError, MAX_PAGE_SIZE, MAX_QUERY_LENGTH, MockTransport, MsgType, type NodePattern, NodePatternBuilder, type OperationTiming, type ParameterInfo, PatternBuilder, type PatternElement, type Permission, type PlanOperation, type PoolConfig, PredicateBuilder, type PredicateOp, PreparedStatement, QueryBuilder, type QueryOptions, type QueryParams, type QueryPlan, type QueryProfile, QueryResult, QueryResultIterator, MatrixQuicTransport as QuicheTransport, type RLSPolicy, RespType, type Role, type Row, SecurityError, type SortDirection, StateError, StatusClass, type StatusClassType, Transaction, type Transport, TransportError, type User, batch, batchAll, batchFirst, batchMap, batchParallel, buildBeginMessage, buildCommitMessage, buildHelloMessage, buildPingMessage, buildPullMessage, buildRollbackMessage, buildRollbackToMessage, buildRunGQLMessage, buildSavepointMessage, buildTLSConfig, cloneConfig, countPlaceholders, createAuthClient, createClient, createClientWithConfig, createTransport, defaultConfig, edge, explain, extractParameters, formatPlan, formatProfile, frameToError, fromJSON, getAddress, getColumnsFromSchema, isBindingsFrame, isDriverError, isErrorFrame, isFinalFrame, isGeodeError, isRetryableError, isSchemaFrame, mergeParams, node, parseDSN, parseFrame, parseGQLType, parseRow, pattern, predicate, prepare, profile, query, rewritePlaceholders, rowToObject, sanitizeForLog, serializeMessage, validateConfig, validateHostname, validatePageSize, validateParamName, validateParamValue, validatePort, validateQuery, validateSavepointName, withTransaction };

package/dist/index.js

@@ -1,6 +1,7 @@
 'use strict';
 
 var Decimal = require('decimal.js-light');
+var losslessJson = require('lossless-json');
 var fs = require('fs');
 var crypto = require('crypto');
 
@@ -1014,8 +1015,20 @@ var init_types = __esm({
     };
   }
 });
-
-// src/protocol.ts
+function bigIntReviver(_key, value) {
+  if (losslessJson.isLosslessNumber(value)) {
+    const str = value.value;
+    if (/^-?\d+$/.test(str)) {
+      const num = Number(str);
+      if (Number.isSafeInteger(num)) {
+        return num;
+      }
+      return BigInt(str);
+    }
+    return Number(str);
+  }
+  return value;
+}
 function parseFrame(data) {
   let str;
   if (Buffer.isBuffer(data)) {
@@ -1024,7 +1037,7 @@ function parseFrame(data) {
     str = data;
   }
   try {
-    const frame = JSON.parse(str);
+    const frame = losslessJson.parse(str, bigIntReviver);
     if (!frame.result || typeof frame.result.type !== "string") {
       const topLevel = frame;
       if (typeof topLevel.type === "string") {
@@ -1173,7 +1186,7 @@ function buildPingMessage() {
   };
 }
 function serializeMessage(msg) {
-  const json = JSON.stringify(msg);
+  const json = losslessJson.stringify(msg, void 0, void 0, [bigIntStringifier]);
   return Buffer.from(json + "\n", "utf-8");
 }
 function rewritePlaceholders(query2, args) {
@@ -1246,7 +1259,7 @@ function mergeParams(positionalParams, namedParams) {
   }
   return { ...positionalParams, ...namedParams };
 }
-exports.MsgType = void 0; exports.RespType = void 0;
+exports.MsgType = void 0; exports.RespType = void 0; var bigIntStringifier;
 var init_protocol = __esm({
   "src/protocol.ts"() {
     init_errors();
@@ -1272,6 +1285,10 @@ var init_protocol = __esm({
       RESULT: "RESULT",
       STATUS: "STATUS"
     };
+    bigIntStringifier = {
+      test: (value) => typeof value === "bigint",
+      stringify: (value) => value.toString()
+    };
   }
 });