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

package/dist/index.d.mts

@@ -381,24 +381,55 @@ 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>;
 }
 /**
  * Edge structure from graph queries.
+ *
+ * Note: The server may return edge endpoints as either:
+ * - `startNode`/`endNode` (normalized form used by the client)
+ * - `from`/`to` (alternative wire format)
+ *
+ * The client normalizes both formats to `startNode`/`endNode`.
  */
 interface GQLEdge {
-    id: string | number;
+    id: GQLId;
     type: string;
-    startNode: string | number;
-    endNode: string | number;
+    startNode: GQLId;
+    endNode: GQLId;
     properties: Record<string, unknown>;
 }
+/**
+ * Raw edge structure as it may appear in wire format.
+ * Used internally for parsing before normalization.
+ */
+interface RawEdge {
+    id: GQLId;
+    type: string;
+    startNode?: GQLId;
+    endNode?: GQLId;
+    from?: GQLId;
+    to?: GQLId;
+    properties?: Record<string, unknown>;
+}
 /**
  * Path structure from graph queries.
  */
@@ -1934,6 +1965,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 +2032,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 +2468,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, type RawEdge, 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,24 +381,55 @@ 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>;
 }
 /**
  * Edge structure from graph queries.
+ *
+ * Note: The server may return edge endpoints as either:
+ * - `startNode`/`endNode` (normalized form used by the client)
+ * - `from`/`to` (alternative wire format)
+ *
+ * The client normalizes both formats to `startNode`/`endNode`.
  */
 interface GQLEdge {
-    id: string | number;
+    id: GQLId;
     type: string;
-    startNode: string | number;
-    endNode: string | number;
+    startNode: GQLId;
+    endNode: GQLId;
     properties: Record<string, unknown>;
 }
+/**
+ * Raw edge structure as it may appear in wire format.
+ * Used internally for parsing before normalization.
+ */
+interface RawEdge {
+    id: GQLId;
+    type: string;
+    startNode?: GQLId;
+    endNode?: GQLId;
+    from?: GQLId;
+    to?: GQLId;
+    properties?: Record<string, unknown>;
+}
 /**
  * Path structure from graph queries.
  */
@@ -1934,6 +1965,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 +2032,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 +2468,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, type RawEdge, 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');
 
@@ -579,8 +580,20 @@ function fromJSON(value, typeHint) {
     if ("id" in obj && "labels" in obj && "properties" in obj) {
       return exports.GQLValue.node(obj);
     }
-    if ("id" in obj && "type" in obj && "startNode" in obj && "endNode" in obj) {
-      return exports.GQLValue.edge(obj);
+    if ("id" in obj && "type" in obj) {
+      const hasStartEnd = "startNode" in obj && "endNode" in obj;
+      const hasFromTo = "from" in obj && "to" in obj;
+      if (hasStartEnd || hasFromTo) {
+        const rawEdge = obj;
+        const normalizedEdge = {
+          id: rawEdge.id,
+          type: rawEdge.type,
+          startNode: rawEdge.startNode ?? rawEdge.from ?? "",
+          endNode: rawEdge.endNode ?? rawEdge.to ?? "",
+          properties: rawEdge.properties ?? {}
+        };
+        return exports.GQLValue.edge(normalizedEdge);
+      }
     }
     if ("nodes" in obj && "edges" in obj && Array.isArray(obj.nodes)) {
       return exports.GQLValue.path(obj);
@@ -675,8 +688,17 @@ function convertWithType(value, type) {
       return fromJSON(value);
     case "NODE":
       return exports.GQLValue.node(value);
-    case "EDGE":
-      return exports.GQLValue.edge(value);
+    case "EDGE": {
+      const rawEdge = value;
+      const normalizedEdge = {
+        id: rawEdge.id,
+        type: rawEdge.type,
+        startNode: rawEdge.startNode ?? rawEdge.from ?? "",
+        endNode: rawEdge.endNode ?? rawEdge.to ?? "",
+        properties: rawEdge.properties ?? {}
+      };
+      return exports.GQLValue.edge(normalizedEdge);
+    }
     case "PATH":
       return exports.GQLValue.path(value);
     default:
@@ -1014,8 +1036,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 +1058,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 +1207,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 +1280,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 +1306,10 @@ var init_protocol = __esm({
       RESULT: "RESULT",
       STATUS: "STATUS"
     };
+    bigIntStringifier = {
+      test: (value) => typeof value === "bigint",
+      stringify: (value) => value.toString()
+    };
   }
 });