gremlin 3.5.3 → 3.6.1

package/doc/structure_io_type-serializers.js.html

@@ -540,13 +540,13 @@ module.exports = {
 </div>
 
 <nav>
-    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AnonymousTraversalSource.html">AnonymousTraversalSource</a></li><li><a href="Authenticator.html">Authenticator</a></li><li><a href="Bytecode.html">Bytecode</a></li><li><a href="Client.html">Client</a></li><li><a href="Connection.html">Connection</a></li><li><a href="DriverRemoteConnection.html">DriverRemoteConnection</a></li><li><a href="EdgeLabelVerificationStrategy.html">EdgeLabelVerificationStrategy</a></li><li><a href="Graph.html">Graph</a></li><li><a href="GraphSON2Reader.html">GraphSON2Reader</a></li><li><a href="GraphSON2Writer.html">GraphSON2Writer</a></li><li><a href="GraphSON3Reader.html">GraphSON3Reader</a></li><li><a href="GraphSON3Writer.html">GraphSON3Writer</a></li><li><a href="GraphTraversal.html">GraphTraversal</a></li><li><a href="GraphTraversalSource.html">GraphTraversalSource</a></li><li><a href="HaltedTraverserStrategy.html">HaltedTraverserStrategy</a></li><li><a href="MatchAlgorithmStrategy.html">MatchAlgorithmStrategy</a></li><li><a href="P.html">P</a></li><li><a href="PartitionStrategy.html">PartitionStrategy</a></li><li><a href="Path.html">Path</a></li><li><a href="PlainTextSaslAuthenticator.html">PlainTextSaslAuthenticator</a></li><li><a href="ProductiveByStrategy.html">ProductiveByStrategy</a></li><li><a href="RemoteConnection.html">RemoteConnection</a></li><li><a href="RemoteStrategy.html">RemoteStrategy</a></li><li><a href="RemoteTraversal.html">RemoteTraversal</a></li><li><a href="ReservedKeysVerificationStrategy.html">ReservedKeysVerificationStrategy</a></li><li><a href="ResponseError.html">ResponseError</a></li><li><a href="ResultSet.html">ResultSet</a></li><li><a href="SaslAuthenticator.html">SaslAuthenticator</a></li><li><a href="SaslMechanismBase.html">SaslMechanismBase</a></li><li><a href="SaslMechanismPlain.html">SaslMechanismPlain</a></li><li><a href="SubgraphStrategy.html">SubgraphStrategy</a></li><li><a href="TextP.html">TextP</a></li><li><a href="Transaction.html">Transaction</a></li><li><a href="Translator.html">Translator</a></li><li><a href="TraversalStrategies.html">TraversalStrategies</a></li><li><a href="TraversalStrategy.html">TraversalStrategy</a></li><li><a href="TypeSerializer.html">TypeSerializer</a></li></ul><h3>Global</h3><ul><li><a href="global.html#statics">statics</a></li></ul>
+    <h2><a href="index.html">Home</a></h2><h3>Classes</h3><ul><li><a href="AnonymousTraversalSource.html">AnonymousTraversalSource</a></li><li><a href="Authenticator.html">Authenticator</a></li><li><a href="Bytecode.html">Bytecode</a></li><li><a href="Client.html">Client</a></li><li><a href="Connection.html">Connection</a></li><li><a href="DriverRemoteConnection.html">DriverRemoteConnection</a></li><li><a href="EdgeLabelVerificationStrategy.html">EdgeLabelVerificationStrategy</a></li><li><a href="Graph.html">Graph</a></li><li><a href="GraphSON2Reader.html">GraphSON2Reader</a></li><li><a href="GraphSON2Writer.html">GraphSON2Writer</a></li><li><a href="GraphSON3Reader.html">GraphSON3Reader</a></li><li><a href="GraphSON3Writer.html">GraphSON3Writer</a></li><li><a href="GraphTraversal.html">GraphTraversal</a></li><li><a href="GraphTraversalSource.html">GraphTraversalSource</a></li><li><a href="HaltedTraverserStrategy.html">HaltedTraverserStrategy</a></li><li><a href="MatchAlgorithmStrategy.html">MatchAlgorithmStrategy</a></li><li><a href="module.exports.html">exports</a></li><li><a href="P.html">P</a></li><li><a href="PartitionStrategy.html">PartitionStrategy</a></li><li><a href="Path.html">Path</a></li><li><a href="PlainTextSaslAuthenticator.html">PlainTextSaslAuthenticator</a></li><li><a href="ProductiveByStrategy.html">ProductiveByStrategy</a></li><li><a href="RemoteConnection.html">RemoteConnection</a></li><li><a href="RemoteStrategy.html">RemoteStrategy</a></li><li><a href="RemoteTraversal.html">RemoteTraversal</a></li><li><a href="ReservedKeysVerificationStrategy.html">ReservedKeysVerificationStrategy</a></li><li><a href="ResponseError.html">ResponseError</a></li><li><a href="ResultSet.html">ResultSet</a></li><li><a href="SaslAuthenticator.html">SaslAuthenticator</a></li><li><a href="SaslMechanismBase.html">SaslMechanismBase</a></li><li><a href="SaslMechanismPlain.html">SaslMechanismPlain</a></li><li><a href="SeedStrategy.html">SeedStrategy</a></li><li><a href="SubgraphStrategy.html">SubgraphStrategy</a></li><li><a href="TextP.html">TextP</a></li><li><a href="Transaction.html">Transaction</a></li><li><a href="Translator.html">Translator</a></li><li><a href="TraversalStrategies.html">TraversalStrategies</a></li><li><a href="TraversalStrategy.html">TraversalStrategy</a></li><li><a href="TypeSerializer.html">TypeSerializer</a></li></ul><h3>Global</h3><ul><li><a href="global.html#DataType">DataType</a></li><li><a href="global.html#statics">statics</a></li></ul>
 </nav>
 
 <br class="clear">
 
 <footer>
-    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.10</a> on Mon Apr 11 2022 07:21:14 GMT-0400 (Eastern Daylight Time)
+    Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.10</a> on Tue Jul 26 2022 16:12:54 GMT-0400 (Eastern Daylight Time)
 </footer>
 
 <script> prettyPrint(); </script>

package/lib/driver/connection.js

@@ -28,6 +28,7 @@ const WebSocket = require('ws');
 const util = require('util');
 const utils = require('../utils');
 const serializer = require('../structure/io/graph-serializer');
+const { graphBinaryReader, graphBinaryWriter } = require('../structure/io/binary/GraphBinary');
 const ResultSet = require('./result-set');
 const ResponseError = require('./response-error');
 
@@ -40,6 +41,7 @@ const responseStatusCode = {
 
 const defaultMimeType = 'application/vnd.gremlin-v3.0+json';
 const graphSON2MimeType = 'application/vnd.gremlin-v2.0+json';
+const graphBinaryMimeType = 'application/vnd.graphbinary-v1.0';
 
 const pingIntervalDelay = 60 * 1000;
 const pongTimeoutDelay = 30 * 1000;
@@ -65,7 +67,7 @@ class Connection extends EventEmitter {
    * @param {Boolean} [options.pingEnabled] Setup ping interval. Defaults to: true.
    * @param {Number} [options.pingInterval] Ping request interval in ms if ping enabled. Defaults to: 60000.
    * @param {Number} [options.pongTimeout] Timeout of pong response in ms after sending a ping. Defaults to: 30000.
-   * @param {Boolean} [options.connectOnStartup] Open websocket on startup. Defaults to: true.
+   * @param {Boolean} [options.connectOnStartup] Deprecated and non-functional. Open websocket on startup.
    * @constructor
    */
   constructor(url, options) {
@@ -101,8 +103,10 @@ class Connection extends EventEmitter {
     this._pingIntervalDelay = this.options.pingInterval || pingIntervalDelay;
     this._pongTimeoutDelay = this.options.pongTimeout || pongTimeoutDelay;
 
-    if (this.options.connectOnStartup !== false) {
-      this.open();
+    if (this.options.connectOnStartup) {
+      console.warn(
+        'connectOnStartup is now deprecated and non-functional. To open a connection, please call open() after instantiating connection object.',
+      );
     }
   }
 
@@ -180,7 +184,7 @@ class Connection extends EventEmitter {
           };
 
           const request_buf = this._writer.writeRequest(request);
-          const message = Buffer.concat([this._header_buf, request_buf], this._header_buf.length + request_buf.length);
+          const message = Buffer.concat([this._header_buf, request_buf]);
           this._ws.send(message);
         }),
     );
@@ -211,7 +215,7 @@ class Connection extends EventEmitter {
         };
 
         const request_buf = this._writer.writeRequest(request);
-        const message = Buffer.concat([this._header_buf, request_buf], this._header_buf.length + request_buf.length);
+        const message = Buffer.concat([this._header_buf, request_buf]);
         this._ws.send(message);
       })
       .catch((err) => readableStream.destroy(err));
@@ -220,10 +224,18 @@ class Connection extends EventEmitter {
   }
 
   _getDefaultReader(mimeType) {
+    if (mimeType === graphBinaryMimeType) {
+      return graphBinaryReader;
+    }
+
     return mimeType === graphSON2MimeType ? new serializer.GraphSON2Reader() : new serializer.GraphSONReader();
   }
 
   _getDefaultWriter(mimeType) {
+    if (mimeType === graphBinaryMimeType) {
+      return graphBinaryWriter;
+    }
+
     return mimeType === graphSON2MimeType ? new serializer.GraphSON2Writer() : new serializer.GraphSONWriter();
   }
 
@@ -252,7 +264,7 @@ class Connection extends EventEmitter {
 
   _handleError(err) {
     this.emit('log', `ws error ${err}`);
-    this._cleanupWebsocket();
+    this._cleanupWebsocket(err);
     this.emit('socketError', err);
   }
 
@@ -356,7 +368,7 @@ class Connection extends EventEmitter {
   /**
    * clean websocket context
    */
-  _cleanupWebsocket() {
+  _cleanupWebsocket(err) {
     if (this._pingInterval) {
       clearInterval(this._pingInterval);
     }
@@ -366,6 +378,17 @@ class Connection extends EventEmitter {
     }
     this._pongTimeout = null;
 
+    // Invoke waiting callbacks to complete Promises when closing the websocket
+    Object.keys(this._responseHandlers).forEach((requestId) => {
+      const handler = this._responseHandlers[requestId];
+      const isStreamingResponse = handler.result instanceof Stream.Readable;
+      if (isStreamingResponse) {
+        handler.callback(null);
+      } else {
+        const cause = err ? err : new Error('Connection has been closed.');
+        handler.callback(cause);
+      }
+    });
     this._ws.removeAllListeners();
     this._openPromise = null;
     this._closePromise = null;

package/lib/process/graph-traversal.js

@@ -94,17 +94,29 @@ class GraphTraversalSource {
    * @returns {GraphTraversalSource}
    */
   withComputer(graphComputer, workers, result, persist, vertices, edges, configuration) {
-    return this.withStrategies(
-      new VertexProgramStrategy({
-        graphComputer: graphComputer,
-        workers: workers,
-        result: result,
-        persist: persist,
-        vertices: vertices,
-        edges: edges,
-        configuration: configuration,
-      }),
-    );
+    const m = {};
+    if (graphComputer !== undefined) {
+      m.graphComputer = graphComputer;
+    }
+    if (workers !== undefined) {
+      m.workers = workers;
+    }
+    if (result !== undefined) {
+      m.result = result;
+    }
+    if (persist !== undefined) {
+      m.graphComputer = persist;
+    }
+    if (vertices !== undefined) {
+      m.vertices = vertices;
+    }
+    if (edges !== undefined) {
+      m.edges = edges;
+    }
+    if (configuration !== undefined) {
+      m.configuration = configuration;
+    }
+    return this.withStrategies(new VertexProgramStrategy(m));
   }
 
   /**
@@ -266,6 +278,16 @@ class GraphTraversalSource {
     return new this.graphTraversalClass(this.graph, new TraversalStrategies(this.traversalStrategies), b);
   }
 
+  /**
+   * mergeV GraphTraversalSource step method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  mergeE(...args) {
+    const b = new Bytecode(this.bytecode).addStep('mergeE', args);
+    return new this.graphTraversalClass(this.graph, new TraversalStrategies(this.traversalStrategies), b);
+  }
+
   /**
    * addV GraphTraversalSource step method.
    * @param {...Object} args
@@ -276,6 +298,16 @@ class GraphTraversalSource {
     return new this.graphTraversalClass(this.graph, new TraversalStrategies(this.traversalStrategies), b);
   }
 
+  /**
+   * mergeV GraphTraversalSource step method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  mergeV(...args) {
+    const b = new Bytecode(this.bytecode).addStep('mergeV', args);
+    return new this.graphTraversalClass(this.graph, new TraversalStrategies(this.traversalStrategies), b);
+  }
+
   /**
    * inject GraphTraversalSource step method.
    * @param {...Object} args
@@ -295,6 +327,16 @@ class GraphTraversalSource {
     const b = new Bytecode(this.bytecode).addStep('io', args);
     return new this.graphTraversalClass(this.graph, new TraversalStrategies(this.traversalStrategies), b);
   }
+
+  /**
+   * call GraphTraversalSource step method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  call(...args) {
+    const b = new Bytecode(this.bytecode).addStep('call', args);
+    return new this.graphTraversalClass(this.graph, new TraversalStrategies(this.traversalStrategies), b);
+  }
 }
 
 /**
@@ -432,6 +474,15 @@ class GraphTraversal extends Traversal {
     return this;
   }
 
+  /**
+   * Graph traversal call method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  call(...args) {
+    this.bytecode.addStep('call', args);
+    return this;
+  }
   /**
    * Graph traversal cap method.
    * @param {...Object} args
@@ -532,6 +583,15 @@ class GraphTraversal extends Traversal {
     return this;
   }
 
+  /**
+   * Graph traversal element method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  element(...args) {
+    this.bytecode.addStep('element', args);
+    return this;
+  }
   /**
    * Graph traversal elementMap method.
    * @param {...Object} args
@@ -552,6 +612,16 @@ class GraphTraversal extends Traversal {
     return this;
   }
 
+  /**
+   * Graph traversal fa method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  fail(...args) {
+    this.bytecode.addStep('fail', args);
+    return this;
+  }
+
   /**
    * Graph traversal filter method.
    * @param {...Object} args
@@ -852,6 +922,26 @@ class GraphTraversal extends Traversal {
     return this;
   }
 
+  /**
+   * Graph traversal mergeE method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  mergeE(...args) {
+    this.bytecode.addStep('mergeE', args);
+    return this;
+  }
+
+  /**
+   * Graph traversal mergeV method.
+   * @param {...Object} args
+   * @returns {GraphTraversal}
+   */
+  mergeV(...args) {
+    this.bytecode.addStep('mergeV', args);
+    return this;
+  }
+
   /**
    * Graph traversal min method.
    * @param {...Object} args
@@ -1364,6 +1454,7 @@ const statics = {
   bothE: (...args) => callOnEmptyTraversal('bothE', args),
   bothV: (...args) => callOnEmptyTraversal('bothV', args),
   branch: (...args) => callOnEmptyTraversal('branch', args),
+  call: (...args) => callOnEmptyTraversal('call', args),
   cap: (...args) => callOnEmptyTraversal('cap', args),
   choose: (...args) => callOnEmptyTraversal('choose', args),
   coalesce: (...args) => callOnEmptyTraversal('coalesce', args),
@@ -1373,8 +1464,10 @@ const statics = {
   cyclicPath: (...args) => callOnEmptyTraversal('cyclicPath', args),
   dedup: (...args) => callOnEmptyTraversal('dedup', args),
   drop: (...args) => callOnEmptyTraversal('drop', args),
+  element: (...args) => callOnEmptyTraversal('element', args),
   elementMap: (...args) => callOnEmptyTraversal('elementMap', args),
   emit: (...args) => callOnEmptyTraversal('emit', args),
+  fail: (...args) => callOnEmptyTraversal('fail', args),
   filter: (...args) => callOnEmptyTraversal('filter', args),
   flatMap: (...args) => callOnEmptyTraversal('flatMap', args),
   fold: (...args) => callOnEmptyTraversal('fold', args),
@@ -1404,6 +1497,8 @@ const statics = {
   math: (...args) => callOnEmptyTraversal('math', args),
   max: (...args) => callOnEmptyTraversal('max', args),
   mean: (...args) => callOnEmptyTraversal('mean', args),
+  mergeE: (...args) => callOnEmptyTraversal('mergeE', args),
+  mergeV: (...args) => callOnEmptyTraversal('mergeV', args),
   min: (...args) => callOnEmptyTraversal('min', args),
   not: (...args) => callOnEmptyTraversal('not', args),
   optional: (...args) => callOnEmptyTraversal('optional', args),

package/lib/process/traversal-strategy.js

@@ -295,7 +295,7 @@ class ReservedKeysVerificationStrategy extends TraversalStrategy {
    * @param {Array<String>} keys the list of reserved keys to verify
    */
   constructor(logWarnings = false, throwException = false, keys = ['id', 'label']) {
-    super('org.apache.tinkerpop.gremlin.process.traversal.strategy.verification.EdgeLabelVerificationStrategy', {
+    super('org.apache.tinkerpop.gremlin.process.traversal.strategy.verification.ReservedKeysVerificationStrategy', {
       logWarnings: logWarnings,
       throwException: throwException,
       keys: keys,
@@ -303,6 +303,18 @@ class ReservedKeysVerificationStrategy extends TraversalStrategy {
   }
 }
 
+class SeedStrategy extends TraversalStrategy {
+  /**
+   * @param {Object} [options]
+   * @param {number} [options.seed] the seed to provide to the random number generator for the traversal
+   */
+  constructor(options) {
+    super('org.apache.tinkerpop.gremlin.process.traversal.strategy.decoration.SeedStrategy', {
+      seed: options.seed,
+    });
+  }
+}
+
 module.exports = {
   TraversalStrategies: TraversalStrategies,
   TraversalStrategy: TraversalStrategy,
@@ -312,6 +324,7 @@ module.exports = {
   HaltedTraverserStrategy: HaltedTraverserStrategy,
   OptionsStrategy: OptionsStrategy,
   PartitionStrategy: PartitionStrategy,
+  SeedStrategy: SeedStrategy,
   SubgraphStrategy: SubgraphStrategy,
   VertexProgramStrategy: VertexProgramStrategy,
   // finalization

package/lib/process/traversal.js

@@ -422,6 +422,16 @@ class TextP {
   static startingWith(...args) {
     return createTextP('startingWith', args);
   }
+
+  /** @param {...Object} args */
+  static regex(...args) {
+    return createTextP('regex', args);
+  }
+
+  /** @param {...Object} args */
+  static notRegex(...args) {
+    return createTextP('notRegex', args);
+  }
 }
 
 function createTextP(operator, args) {
@@ -486,9 +496,10 @@ module.exports = {
   barrier: toEnum('Barrier', 'normSack'),
   cardinality: toEnum('Cardinality', 'list set single'),
   column: toEnum('Column', 'keys values'),
-  direction: toEnum('Direction', 'BOTH IN OUT'),
+  direction: toEnum('Direction', 'BOTH IN OUT from_ to'),
   graphSONVersion: toEnum('GraphSONVersion', 'V1_0 V2_0 V3_0'),
   gryoVersion: toEnum('GryoVersion', 'V1_0 V3_0'),
+  merge: toEnum('Merge', 'onCreate onMatch'),
   operator: toEnum('Operator', 'addAll and assign div max min minus mult or sum sumLong'),
   order: toEnum('Order', 'asc desc shuffle'),
   pick: toEnum('Pick', 'any none'),

package/lib/structure/io/binary/GraphBinary.js

@@ -0,0 +1,109 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one
+ *  or more contributor license agreements.  See the NOTICE file
+ *  distributed with this work for additional information
+ *  regarding copyright ownership.  The ASF licenses this file
+ *  to you under the Apache License, Version 2.0 (the
+ *  "License"); you may not use this file except in compliance
+ *  with the License.  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing,
+ *  software distributed under the License is distributed on an
+ *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *  KIND, either express or implied.  See the License for the
+ *  specific language governing permissions and limitations
+ *  under the License.
+ */
+
+/**
+ * GraphBinary 1.0 support implementation.
+ *
+ * The officially expected entrypoint is GraphBinaryReader/GraphBinaryWriter pair of classes,
+ * examine lib/driver/** for use cases.
+ *
+ * See AnySerializer.serialize() for the mechanism of serializer selection for a given JavaScript value,
+ * also consider AnySerializer.serialize() unit tests for real examples.
+ * See NumberSerializationStrategy to understand how it deals with JavaScript numbers' serialization.
+ *
+ * Consider AnySerializer.serialize()/deserialize() unit tests to see what is not implemented,
+ * what is ignored, what is not expected to be (de)serialized, etc.
+ *
+ * TODO: it has the following open topics:
+ * - [] Should we do anything for application/vnd.graphbinary-v1.0-stringd mime type support?
+ * Core Data Types support:
+ * - [] 0x22: BigDecimal
+ * - [] 0x2b: Tree
+ * - [] 0x2c: Metrics
+ * - [] 0x2d: TraversalMetrics
+ * - [] 0x00: Custom
+ * Extended Types support:
+ * - [] 0x80: Char
+ * - [] 0x81: Duration
+ * - [] 0x82: InetAddress
+ * - [] 0x83: Instant
+ * - [] 0x84: LocalDate
+ * - [] 0x85: LocalDateTime
+ * - [] 0x86: LocalTime
+ * - [] 0x87: MonthDay
+ * - [] 0x88: OffsetDateTime
+ * - [] 0x89: OffsetTime
+ * - [] 0x8a: Period
+ * - [] 0x8b: Year
+ * - [] 0x8c: YearMonth
+ * - [] 0x8d: ZonedDateTime
+ * - [] 0x8e: ZoneOffset
+ *
+ * @author Igor Ostapenko
+ */
+/*eslint-disable*/
+'use strict';
+
+const ioc = {};
+
+ioc.DataType = require('./internals/DataType');
+ioc.utils = require('./internals/utils');
+
+ioc.serializers = {};
+
+ioc.intSerializer               = new (require('./internals/IntSerializer'))(ioc);
+ioc.longSerializer              = new (require('./internals/LongSerializer'))(ioc);
+ioc.longSerializerNg            = new (require('./internals/LongSerializerNg'))(ioc);
+ioc.stringSerializer            = new (require('./internals/StringSerializer'))(ioc, ioc.DataType.STRING);
+ioc.dateSerializer              = new (require('./internals/DateSerializer'))(ioc, ioc.DataType.DATE);
+ioc.timestampSerializer         = new (require('./internals/DateSerializer'))(ioc, ioc.DataType.TIMESTAMP);
+ioc.classSerializer             = new (require('./internals/StringSerializer'))(ioc, ioc.DataType.CLASS);
+ioc.doubleSerializer            = new (require('./internals/DoubleSerializer'))(ioc);
+ioc.floatSerializer             = new (require('./internals/FloatSerializer'))(ioc);
+ioc.listSerializer              = new (require('./internals/ArraySerializer'))(ioc, ioc.DataType.LIST);
+ioc.mapSerializer               = new (require('./internals/MapSerializer'))(ioc);
+ioc.setSerializer               = new (require('./internals/ArraySerializer'))(ioc, ioc.DataType.SET);
+ioc.uuidSerializer              = new (require('./internals/UuidSerializer'))(ioc);
+ioc.edgeSerializer              = new (require('./internals/EdgeSerializer'))(ioc);
+ioc.pathSerializer              = new (require('./internals/PathSerializer'))(ioc);
+ioc.propertySerializer          = new (require('./internals/PropertySerializer'))(ioc);
+ioc.vertexSerializer            = new (require('./internals/VertexSerializer'))(ioc);
+ioc.vertexPropertySerializer    = new (require('./internals/VertexPropertySerializer'))(ioc);
+ioc.bytecodeSerializer          = new (require('./internals/BytecodeSerializer'))(ioc);
+ioc.pSerializer                 = new (require('./internals/PSerializer'))(ioc);
+ioc.traverserSerializer         = new (require('./internals/TraverserSerializer'))(ioc);
+ioc.enumSerializer              = new (require('./internals/EnumSerializer'))(ioc);
+ioc.lambdaSerializer            = new (require('./internals/LambdaSerializer'))(ioc);
+ioc.bigIntegerSerializer        = new (require('./internals/BigIntegerSerializer'))(ioc);
+ioc.byteSerializer              = new (require('./internals/ByteSerializer'))(ioc);
+ioc.byteBufferSerializer        = new (require('./internals/ByteBufferSerializer'))(ioc);
+ioc.shortSerializer             = new (require('./internals/ShortSerializer'))(ioc);
+ioc.booleanSerializer           = new (require('./internals/BooleanSerializer'))(ioc);
+ioc.textPSerializer             = new (require('./internals/TextPSerializer'))(ioc);
+ioc.traversalStrategySerializer = new (require('./internals/TraversalStrategySerializer'))(ioc);
+ioc.bulkSetSerializer           = new (require('./internals/BulkSetSerializer'))(ioc);
+ioc.unspecifiedNullSerializer   = new (require('./internals/UnspecifiedNullSerializer'))(ioc);
+
+ioc.numberSerializationStrategy = new (require('./internals/NumberSerializationStrategy'))(ioc);
+ioc.anySerializer               = new (require('./internals/AnySerializer'))(ioc);
+
+ioc.graphBinaryReader           = new (require('./internals/GraphBinaryReader.js'))(ioc);
+ioc.graphBinaryWriter           = new (require('./internals/GraphBinaryWriter'))(ioc);
+
+module.exports = ioc;

package/lib/structure/io/binary/internals/AnySerializer.js

@@ -0,0 +1,95 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one
+ *  or more contributor license agreements.  See the NOTICE file
+ *  distributed with this work for additional information
+ *  regarding copyright ownership.  The ASF licenses this file
+ *  to you under the Apache License, Version 2.0 (the
+ *  "License"); you may not use this file except in compliance
+ *  with the License.  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing,
+ *  software distributed under the License is distributed on an
+ *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *  KIND, either express or implied.  See the License for the
+ *  specific language governing permissions and limitations
+ *  under the License.
+ */
+
+/**
+ * @author Igor Ostapenko
+ */
+'use strict';
+
+module.exports = class AnySerializer {
+  constructor(ioc) {
+    this.ioc = ioc;
+
+    // specifically ordered, the first canBeUsedFor=true wins
+    this.serializers = [
+      ioc.unspecifiedNullSerializer,
+
+      ioc.numberSerializationStrategy,
+
+      ioc.booleanSerializer,
+      ioc.dateSerializer,
+      ioc.bytecodeSerializer,
+      ioc.pSerializer,
+      ioc.traverserSerializer,
+      ioc.enumSerializer,
+      ioc.listSerializer,
+      ioc.uuidSerializer,
+      ioc.edgeSerializer,
+      ioc.pathSerializer,
+      ioc.propertySerializer,
+      ioc.vertexSerializer,
+      ioc.vertexPropertySerializer,
+      ioc.stringSerializer,
+      ioc.textPSerializer,
+      ioc.traversalStrategySerializer,
+
+      ioc.byteBufferSerializer, // Buffer instance
+      ioc.lambdaSerializer, // any function
+      ioc.mapSerializer, // Map or any Object
+    ];
+  }
+
+  getSerializerCanBeUsedFor(item) {
+    for (let i = 0; i < this.serializers.length; i++) {
+      if (this.serializers[i].canBeUsedFor(item)) {
+        return this.serializers[i];
+      }
+    }
+
+    throw new Error(
+      `No serializer found to support item where typeof(item)='${typeof item}' and String(item)='${String(item)}'.`,
+    );
+  }
+
+  serialize(item, fullyQualifiedFormat = true) {
+    return this.getSerializerCanBeUsedFor(item).serialize(item, fullyQualifiedFormat);
+  }
+
+  deserialize(buffer) {
+    // obviously, fullyQualifiedFormat always is true
+    try {
+      if (buffer === undefined || buffer === null || !(buffer instanceof Buffer)) {
+        throw new Error('buffer is missing');
+      }
+      if (buffer.length < 1) {
+        throw new Error('buffer is empty');
+      }
+
+      const type_code = buffer.readUInt8();
+      const serializer = this.ioc.serializers[type_code];
+      if (!serializer) {
+        throw new Error('unknown {type_code}');
+      }
+
+      return serializer.deserialize(buffer);
+    } catch (err) {
+      throw this.ioc.utils.des_error({ serializer: this, args: arguments, err });
+    }
+  }
+};