gremlin 3.8.1 → 4.0.0-beta.3

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

@@ -1,124 +0,0 @@
-/*
- *  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';
-
-const { Buffer } = require('buffer');
-const t = require('../../../../process/traversal');
-
-module.exports = class TraverserSerializer {
-  constructor(ioc) {
-    this.ioc = ioc;
-    this.ioc.serializers[ioc.DataType.TRAVERSER] = this;
-  }
-
-  canBeUsedFor(value) {
-    return value instanceof t.Traverser;
-  }
-
-  serialize(item, fullyQualifiedFormat = true) {
-    if (item === undefined || item === null) {
-      if (fullyQualifiedFormat) {
-        return Buffer.from([this.ioc.DataType.TRAVERSER, 0x01]);
-      }
-      const bulk = [0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01]; // 1
-      const value = [0xfe, 0x01]; // null
-      return Buffer.from([...bulk, ...value]);
-    }
-
-    const bufs = [];
-    if (fullyQualifiedFormat) {
-      bufs.push(Buffer.from([this.ioc.DataType.TRAVERSER, 0x00]));
-    }
-
-    // {bulk}
-    bufs.push(this.ioc.longSerializer.serialize(item.bulk, false));
-    // {value}
-    bufs.push(this.ioc.anySerializer.serialize(item.object));
-
-    return Buffer.concat(bufs);
-  }
-
-  deserialize(buffer, fullyQualifiedFormat = true) {
-    let len = 0;
-    let cursor = buffer;
-
-    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');
-      }
-
-      if (fullyQualifiedFormat) {
-        const type_code = cursor.readUInt8();
-        len++;
-        if (type_code !== this.ioc.DataType.TRAVERSER) {
-          throw new Error('unexpected {type_code}');
-        }
-        cursor = cursor.slice(1);
-
-        if (cursor.length < 1) {
-          throw new Error('{value_flag} is missing');
-        }
-        const value_flag = cursor.readUInt8();
-        len++;
-        if (value_flag === 1) {
-          return { v: null, len };
-        }
-        if (value_flag !== 0) {
-          throw new Error('unexpected {value_flag}');
-        }
-        cursor = cursor.slice(1);
-      }
-
-      let bulk, bulk_len;
-      try {
-        ({ v: bulk, len: bulk_len } = this.ioc.longSerializer.deserialize(cursor, false));
-        len += bulk_len;
-      } catch (err) {
-        err.message = '{bulk}: ' + err.message;
-        throw err;
-      }
-      if (bulk < 0) {
-        throw new Error('{bulk} is less than zero');
-      }
-      cursor = cursor.slice(bulk_len);
-
-      let value, value_len;
-      try {
-        ({ v: value, len: value_len } = this.ioc.anySerializer.deserialize(cursor));
-        len += value_len;
-      } catch (err) {
-        err.message = '{value}: ' + err.message;
-        throw err;
-      }
-      cursor = cursor.slice(value_len);
-
-      const v = new t.Traverser(value, bulk);
-      return { v, len };
-    } catch (err) {
-      throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
-    }
-  }
-};

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

@@ -1,77 +0,0 @@
-/*
- *  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';
-
-const { Buffer } = require('buffer');
-
-module.exports = class UnspecifiedNullSerializer {
-  constructor(ioc) {
-    this.ioc = ioc;
-    this.ioc.serializers[ioc.DataType.UNSPECIFIED_NULL] = this;
-  }
-
-  canBeUsedFor(value) {
-    return value === null || value === undefined;
-  }
-
-  serialize(item) {
-    // fullyQualifiedFormat always is true
-    return Buffer.from([this.ioc.DataType.UNSPECIFIED_NULL, 0x01]);
-  }
-
-  deserialize(buffer) {
-    // fullyQualifiedFormat always is true
-    let len = 0;
-    let cursor = buffer;
-
-    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 = cursor.readUInt8();
-      len++;
-      if (type_code !== this.ioc.DataType.UNSPECIFIED_NULL) {
-        throw new Error('unexpected {type_code}');
-      }
-      cursor = cursor.slice(1);
-
-      if (cursor.length < 1) {
-        throw new Error('{value_flag} is missing');
-      }
-      const value_flag = cursor.readUInt8();
-      len++;
-      if (value_flag !== 1) {
-        throw new Error('unexpected {value_flag}');
-      }
-      cursor = cursor.slice(1);
-
-      return { v: null, len };
-    } catch (err) {
-      throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
-    }
-  }
-};

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

@@ -1,121 +0,0 @@
-/*
- *  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';
-
-const { Buffer } = require('buffer');
-
-module.exports = class UuidSerializer {
-  constructor(ioc) {
-    this.ioc = ioc;
-    this.ioc.serializers[ioc.DataType.UUID] = this;
-  }
-
-  canBeUsedFor(value) {
-    // TODO: any idea to support UUID automatic serialization via AnySerializer in future?
-  }
-
-  serialize(item, fullyQualifiedFormat = true) {
-    if (item === undefined || item === null) {
-      if (fullyQualifiedFormat) {
-        return Buffer.from([this.ioc.DataType.UUID, 0x01]);
-      }
-      return Buffer.from([
-        0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
-      ]);
-    }
-
-    const uuid_str = String(item)
-      .replace(/^urn:uuid:/, '')
-      .replace(/[{}-]/g, '');
-
-    const bufs = [];
-    if (fullyQualifiedFormat) {
-      bufs.push(Buffer.from([this.ioc.DataType.UUID, 0x00]));
-    }
-
-    const v = Buffer.alloc(16, 0);
-    for (let i = 0; i < 16 && i * 2 < uuid_str.length; i++) {
-      v[i] = parseInt(uuid_str.slice(i * 2, i * 2 + 2), 16);
-    }
-    bufs.push(v);
-
-    return Buffer.concat(bufs);
-  }
-
-  deserialize(buffer, fullyQualifiedFormat = true, nullable = false) {
-    let len = 0;
-    let cursor = buffer;
-
-    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');
-      }
-
-      if (fullyQualifiedFormat) {
-        const type_code = cursor.readUInt8();
-        len++;
-        if (type_code !== this.ioc.DataType.UUID) {
-          throw new Error('unexpected {type_code}');
-        }
-        cursor = cursor.slice(1);
-      }
-      if (fullyQualifiedFormat || nullable) {
-        if (cursor.length < 1) {
-          throw new Error('{value_flag} is missing');
-        }
-        const value_flag = cursor.readUInt8();
-        len++;
-        if (value_flag === 1) {
-          return { v: null, len };
-        }
-        if (value_flag !== 0) {
-          throw new Error('unexpected {value_flag}');
-        }
-        cursor = cursor.slice(1);
-      }
-
-      if (cursor.length < 16) {
-        throw new Error('unexpected {value} length');
-      }
-      len += 16;
-
-      // Example: 2075278D-F624-4B2B-960D-25D374D57C04
-      const v =
-        cursor.slice(0, 4).toString('hex') +
-        '-' +
-        cursor.slice(4, 6).toString('hex') +
-        '-' +
-        cursor.slice(6, 8).toString('hex') +
-        '-' +
-        cursor.slice(8, 10).toString('hex') +
-        '-' +
-        cursor.slice(10, 16).toString('hex');
-      return { v, len };
-    } catch (err) {
-      throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
-    }
-  }
-};

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

@@ -1,176 +0,0 @@
-/*
- *  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';
-
-const { Buffer } = require('buffer');
-const g = require('../../../graph');
-
-module.exports = class VertexPropertySerializer {
-  constructor(ioc) {
-    this.ioc = ioc;
-    this.ioc.serializers[ioc.DataType.VERTEXPROPERTY] = this;
-  }
-
-  canBeUsedFor(value) {
-    return value instanceof g.VertexProperty;
-  }
-
-  serialize(item, fullyQualifiedFormat = true) {
-    if (item === undefined || item === null) {
-      if (fullyQualifiedFormat) {
-        return Buffer.from([this.ioc.DataType.VERTEXPROPERTY, 0x01]);
-      }
-      return Buffer.concat([
-        this.ioc.unspecifiedNullSerializer.serialize(null), // {id}=null
-        this.ioc.stringSerializer.serialize('', false), // {label}=''
-        this.ioc.unspecifiedNullSerializer.serialize(null), // {value}=null
-        this.ioc.unspecifiedNullSerializer.serialize(null), // {parent}=null
-        this.ioc.unspecifiedNullSerializer.serialize(null), // {properties}=null
-      ]);
-    }
-
-    const bufs = [];
-    if (fullyQualifiedFormat) {
-      bufs.push(Buffer.from([this.ioc.DataType.VERTEXPROPERTY, 0x00]));
-    }
-
-    // {id}
-    bufs.push(this.ioc.anySerializer.serialize(item.id));
-
-    // {label}
-    bufs.push(this.ioc.stringSerializer.serialize(item.label, false));
-
-    // {value}
-    bufs.push(this.ioc.anySerializer.serialize(item.value));
-
-    // {parent}
-    bufs.push(this.ioc.unspecifiedNullSerializer.serialize(null));
-
-    // {properties}
-    bufs.push(this.ioc.anySerializer.serialize(item.properties));
-
-    return Buffer.concat(bufs);
-  }
-
-  deserialize(buffer, fullyQualifiedFormat = true) {
-    let len = 0;
-    let cursor = buffer;
-
-    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');
-      }
-
-      if (fullyQualifiedFormat) {
-        const type_code = cursor.readUInt8();
-        len++;
-        if (type_code !== this.ioc.DataType.VERTEXPROPERTY) {
-          throw new Error('unexpected {type_code}');
-        }
-        cursor = cursor.slice(1);
-
-        if (cursor.length < 1) {
-          throw new Error('{value_flag} is missing');
-        }
-        const value_flag = cursor.readUInt8();
-        len++;
-        if (value_flag === 1) {
-          return { v: null, len };
-        }
-        if (value_flag !== 0) {
-          throw new Error('unexpected {value_flag}');
-        }
-        cursor = cursor.slice(1);
-      }
-
-      // {id} is a fully qualified typed value composed of {type_code}{type_info}{value_flag}{value}
-      let id, id_len;
-      try {
-        ({ v: id, len: id_len } = this.ioc.anySerializer.deserialize(cursor));
-        len += id_len;
-      } catch (err) {
-        err.message = '{id}: ' + err.message;
-        throw err;
-      }
-      cursor = cursor.slice(id_len);
-
-      // {label} is a String value
-      let label, label_len;
-      try {
-        ({ v: label, len: label_len } = this.ioc.stringSerializer.deserialize(cursor, false));
-        len += label_len;
-      } catch (err) {
-        err.message = '{label}: ' + err.message;
-        throw err;
-      }
-      cursor = cursor.slice(label_len);
-
-      // {value} is a fully qualified typed value composed of {type_code}{type_info}{value_flag}{value}
-      let value, value_len;
-      try {
-        ({ v: value, len: value_len } = this.ioc.anySerializer.deserialize(cursor));
-        len += value_len;
-      } catch (err) {
-        err.message = '{value}: ' + err.message;
-        throw err;
-      }
-      cursor = cursor.slice(value_len);
-
-      // {parent} is a fully qualified typed value composed of {type_code}{type_info}{value_flag}{value} which contains the parent Vertex.
-      // Note that as TinkerPop currently send "references" only, this value will always be null.
-      let parent_len;
-      try {
-        ({ len: parent_len } = this.ioc.unspecifiedNullSerializer.deserialize(cursor));
-        len += parent_len;
-      } catch (err) {
-        err.message = '{parent}: ' + err.message;
-        throw err;
-      }
-      // TODO: should we verify that parent is null?
-      cursor = cursor.slice(parent_len);
-
-      // {properties} is a fully qualified typed value composed of {type_code}{type_info}{value_flag}{value} which contains properties. Note that as TinkerPop currently send "references" only, this value will always be null.
-      let properties, properties_len;
-      try {
-        ({ v: properties, len: properties_len } = this.ioc.anySerializer.deserialize(cursor));
-        len += properties_len;
-      } catch (err) {
-        err.message = '{properties}: ' + err.message;
-        throw err;
-      }
-      // TODO: should we verify that properties is null?
-      cursor = cursor.slice(properties_len);
-
-      // null properties are deserialized into empty lists
-      const vp_props = properties ? properties : [];
-
-      const v = new g.VertexProperty(id, label, value, vp_props);
-      return { v, len };
-    } catch (err) {
-      throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
-    }
-  }
-};

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

@@ -1,139 +0,0 @@
-/*
- *  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';
-
-const { Buffer } = require('buffer');
-const g = require('../../../graph');
-
-module.exports = class VertexSerializer {
-  constructor(ioc) {
-    this.ioc = ioc;
-    this.ioc.serializers[ioc.DataType.VERTEX] = this;
-  }
-
-  canBeUsedFor(value) {
-    return value instanceof g.Vertex;
-  }
-
-  serialize(item, fullyQualifiedFormat = true) {
-    if (item === undefined || item === null) {
-      if (fullyQualifiedFormat) {
-        return Buffer.from([this.ioc.DataType.VERTEX, 0x01]);
-      }
-      const id = [0x03, 0x00, 0x00, 0x00, 0x00, 0x00]; // String ''
-      const label = [0x00, 0x00, 0x00, 0x00]; // ''
-      const properties = [0xfe, 0x01]; // null
-      return Buffer.from([...id, ...label, ...properties]);
-    }
-
-    const bufs = [];
-    if (fullyQualifiedFormat) {
-      bufs.push(Buffer.from([this.ioc.DataType.VERTEX, 0x00]));
-    }
-
-    // {id}
-    bufs.push(this.ioc.anySerializer.serialize(item.id));
-
-    // {label}
-    bufs.push(this.ioc.stringSerializer.serialize(item.label, false));
-
-    // {properties}
-    bufs.push(this.ioc.anySerializer.serialize(item.properties));
-
-    return Buffer.concat(bufs);
-  }
-
-  deserialize(buffer, fullyQualifiedFormat = true) {
-    let len = 0;
-    let cursor = buffer;
-
-    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');
-      }
-
-      if (fullyQualifiedFormat) {
-        const type_code = cursor.readUInt8();
-        len++;
-        if (type_code !== this.ioc.DataType.VERTEX) {
-          throw new Error('unexpected {type_code}');
-        }
-        cursor = cursor.slice(1);
-
-        if (cursor.length < 1) {
-          throw new Error('{value_flag} is missing');
-        }
-        const value_flag = cursor.readUInt8();
-        len++;
-        if (value_flag === 1) {
-          return { v: null, len };
-        }
-        if (value_flag !== 0) {
-          throw new Error('unexpected {value_flag}');
-        }
-        cursor = cursor.slice(1);
-      }
-
-      let id, id_len;
-      try {
-        ({ v: id, len: id_len } = this.ioc.anySerializer.deserialize(cursor));
-        len += id_len;
-      } catch (err) {
-        err.message = '{id}: ' + err.message;
-        throw err;
-      }
-      cursor = cursor.slice(id_len);
-
-      let label, label_len;
-      try {
-        ({ v: label, len: label_len } = this.ioc.stringSerializer.deserialize(cursor, false));
-        len += label_len;
-      } catch (err) {
-        err.message = '{label}: ' + err.message;
-        throw err;
-      }
-      cursor = cursor.slice(label_len);
-
-      let properties, properties_len;
-      try {
-        ({ v: properties, len: properties_len } = this.ioc.anySerializer.deserialize(cursor));
-        len += properties_len;
-      } catch (err) {
-        err.message = '{properties}: ' + err.message;
-        throw err;
-      }
-      cursor = cursor.slice(properties_len);
-
-      // null properties are deserialized into empty lists
-      const vertex_props = properties ? properties : [];
-
-      const v = new g.Vertex(id, label, vertex_props);
-      return { v, len };
-    } catch (err) {
-      throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
-    }
-  }
-};