gremlin 4.0.0-beta.2 → 4.0.0-beta.3

package/build/esm/structure/io/binary/internals/BinarySerializer.js

@@ -52,58 +52,38 @@ export default class BinarySerializer {
         bufs.push(item);
         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.BINARY) {
-                    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 length, length_len;
-            try {
-                ({ v: length, len: length_len } = this.ioc.intSerializer.deserialize(cursor, false));
-                len += length_len;
-            }
-            catch (err) {
-                err.message = '{length}: ' + err.message;
-                throw err;
-            }
-            if (length < 0) {
-                throw new Error('{length} is less than zero');
-            }
-            cursor = cursor.slice(length_len);
-            if (cursor.length < length) {
-                throw new Error(`{value}: unexpected actual {value} length=${cursor.length} when {length}=${length}`);
-            }
-            const v = cursor.slice(0, length);
-            len += length;
-            return { v, len };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<Buffer>}
+     */
+    async deserializeValue(reader, valueFlag, typeCode) {
+        const length = await this.ioc.intSerializer.deserializeBare(reader);
+        if (length < 0) {
+            throw new Error(`BinarySerializer: {length}=${length} is less than zero`);
+        }
+        if (length === 0) {
+            return Buffer.alloc(0);
+        }
+        return reader.readBytes(length);
+    }
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<Buffer|null>}
+     */
+    async deserialize(reader) {
+        const type_code = await reader.readUInt8();
+        if (type_code !== this.ioc.DataType.BINARY) {
+            throw new Error(`BinarySerializer: unexpected {type_code}=0x${type_code.toString(16)}`);
+        }
+        const value_flag = await reader.readUInt8();
+        if (value_flag === 0x01) {
+            return null;
         }
-        catch (err) {
-            throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
+        if (value_flag !== 0x00) {
+            throw new Error(`BinarySerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
         }
+        return this.deserializeValue(reader, value_flag, type_code);
     }
 }

package/build/esm/structure/io/binary/internals/BooleanSerializer.d.ts

@@ -3,9 +3,17 @@ export default class BooleanSerializer {
     ioc: any;
     canBeUsedFor(value: any): value is boolean;
     serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
-    deserialize(buffer: any, fullyQualifiedFormat?: boolean, ...args: any[]): {
-        v: any;
-        len: number;
-    };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<boolean>}
+     */
+    deserializeValue(reader: StreamReader, valueFlag: number, typeCode: number): Promise<boolean>;
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<boolean|null>}
+     */
+    deserialize(reader: StreamReader): Promise<boolean | null>;
 }
 import { Buffer } from 'buffer';

package/build/esm/structure/io/binary/internals/BooleanSerializer.js

@@ -42,49 +42,35 @@ export default class BooleanSerializer {
         bufs.push(Buffer.from([item ? 0x01 : 0x00]));
         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.BOOLEAN) {
-                    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);
-            }
-            if (cursor.length < 1) {
-                throw new Error('unexpected {value} length');
-            }
-            len += 1;
-            let v = cursor.readUInt8();
-            if (v !== 0x00 && v !== 0x01) {
-                throw new Error(`unexpected boolean byte=${v}`);
-            }
-            v = v === 0x01;
-            return { v, len };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<boolean>}
+     */
+    async deserializeValue(reader, valueFlag, typeCode) {
+        const v = await reader.readUInt8();
+        if (v !== 0x00 && v !== 0x01) {
+            throw new Error(`BooleanSerializer: unexpected boolean byte=0x${v.toString(16)}`);
+        }
+        return v === 0x01;
+    }
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<boolean|null>}
+     */
+    async deserialize(reader) {
+        const type_code = await reader.readUInt8();
+        if (type_code !== this.ioc.DataType.BOOLEAN) {
+            throw new Error(`BooleanSerializer: unexpected {type_code}=0x${type_code.toString(16)}`);
+        }
+        const value_flag = await reader.readUInt8();
+        if (value_flag === 0x01) {
+            return null;
         }
-        catch (err) {
-            throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
+        if (value_flag !== 0x00) {
+            throw new Error(`BooleanSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
         }
+        return this.deserializeValue(reader, value_flag, type_code);
     }
 }

package/build/esm/structure/io/binary/internals/ByteSerializer.d.ts

@@ -2,9 +2,17 @@ export default class ByteSerializer {
     constructor(ioc: any);
     ioc: any;
     serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
-    deserialize(buffer: any, fullyQualifiedFormat?: boolean, ...args: any[]): {
-        v: any;
-        len: number;
-    };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<number>}
+     */
+    deserializeValue(reader: StreamReader, valueFlag: number, typeCode: number): Promise<number>;
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<number|null>}
+     */
+    deserialize(reader: StreamReader): Promise<number | null>;
 }
 import { Buffer } from 'buffer';

package/build/esm/structure/io/binary/internals/ByteSerializer.js

@@ -41,45 +41,31 @@ export default class ByteSerializer {
         bufs.push(v);
         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.BYTE) {
-                    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);
-            }
-            if (cursor.length < 1) {
-                throw new Error('unexpected {value} length');
-            }
-            len += 1;
-            const v = cursor.readInt8();
-            return { v, len };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<number>}
+     */
+    async deserializeValue(reader, valueFlag, typeCode) {
+        return await reader.readByte();
+    }
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<number|null>}
+     */
+    async deserialize(reader) {
+        const type_code = await reader.readUInt8();
+        if (type_code !== this.ioc.DataType.BYTE) {
+            throw new Error(`ByteSerializer: unexpected {type_code}=0x${type_code.toString(16)}`);
+        }
+        const value_flag = await reader.readUInt8();
+        if (value_flag === 0x01) {
+            return null;
         }
-        catch (err) {
-            throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
+        if (value_flag !== 0x00) {
+            throw new Error(`ByteSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
         }
+        return this.deserializeValue(reader, value_flag, type_code);
     }
 }

package/build/esm/structure/io/binary/internals/CompositePDTSerializer.d.ts

@@ -0,0 +1,10 @@
+export default class CompositePDTSerializer {
+    constructor(ioc: any);
+    ioc: any;
+    canBeUsedFor(value: any): value is CompositePDT;
+    serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
+    deserializeValue(reader: any, valueFlag: any, typeCode: any): Promise<any>;
+    deserialize(reader: any): Promise<any>;
+}
+import { CompositePDT } from '../../../graph.js';
+import { Buffer } from 'buffer';

package/build/esm/structure/io/binary/internals/CompositePDTSerializer.js

@@ -0,0 +1,78 @@
+/*
+ *  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.
+ */
+import { Buffer } from 'buffer';
+import { CompositePDT } from '../../../graph.js';
+export default class CompositePDTSerializer {
+    constructor(ioc) {
+        this.ioc = ioc;
+        this.ioc.serializers[ioc.DataType.COMPOSITEPDT] = this;
+    }
+    canBeUsedFor(value) {
+        return value instanceof CompositePDT;
+    }
+    serialize(item, fullyQualifiedFormat = true) {
+        if (item === undefined || item === null) {
+            if (fullyQualifiedFormat) {
+                return Buffer.from([this.ioc.DataType.COMPOSITEPDT, 0x01]);
+            }
+            const bufs = [];
+            bufs.push(this.ioc.stringSerializer.serialize('', false));
+            bufs.push(this.ioc.mapSerializer.serialize({}, false));
+            return Buffer.concat(bufs);
+        }
+        const bufs = [];
+        if (fullyQualifiedFormat) {
+            bufs.push(Buffer.from([this.ioc.DataType.COMPOSITEPDT, 0x00]));
+        }
+        bufs.push(this.ioc.stringSerializer.serialize(item.name, true));
+        bufs.push(this.ioc.mapSerializer.serialize(item.fields, true));
+        return Buffer.concat(bufs);
+    }
+    async deserializeValue(reader, valueFlag, typeCode) {
+        const name = await this.ioc.anySerializer.deserialize(reader);
+        if (!name) {
+            throw new Error('CompositePDTSerializer: name cannot be null or empty');
+        }
+        const fieldsRaw = await this.ioc.anySerializer.deserialize(reader);
+        const fields = fieldsRaw instanceof Map ? Object.fromEntries(fieldsRaw) : fieldsRaw || {};
+        const pdt = new CompositePDT(name, fields);
+        const pdtRegistry = reader.pdtRegistry;
+        if (pdtRegistry) {
+            const hydrated = pdtRegistry.hydrate(pdt);
+            if (!(hydrated instanceof CompositePDT)) {
+                return hydrated;
+            }
+        }
+        return pdt;
+    }
+    async deserialize(reader) {
+        const type_code = await reader.readUInt8();
+        if (type_code !== this.ioc.DataType.COMPOSITEPDT) {
+            throw new Error(`CompositePDTSerializer: unexpected {type_code}=0x${type_code.toString(16)}`);
+        }
+        const value_flag = await reader.readUInt8();
+        if (value_flag === 0x01) {
+            return null;
+        }
+        if (value_flag !== 0x00) {
+            throw new Error(`CompositePDTSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
+        }
+        return this.deserializeValue(reader, value_flag, type_code);
+    }
+}

package/build/esm/structure/io/binary/internals/DateTimeSerializer.d.ts

@@ -4,12 +4,17 @@ export default class DateTimeSerializer {
     ID: any;
     canBeUsedFor(value: any): value is Date;
     serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
-    deserialize(buffer: any, fullyQualifiedFormat?: boolean, ...args: any[]): {
-        v: null;
-        len: number;
-    } | {
-        v: Date;
-        len: number;
-    };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<Date>}
+     */
+    deserializeValue(reader: StreamReader, valueFlag: number, typeCode: number): Promise<Date>;
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<Date|null>}
+     */
+    deserialize(reader: StreamReader): Promise<Date | null>;
 }
 import { Buffer } from 'buffer';

package/build/esm/structure/io/binary/internals/DateTimeSerializer.js

@@ -61,76 +61,59 @@ export default class DateTimeSerializer {
         bufs.push(v);
         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.ID) {
-                    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);
-            }
-            if (cursor.length < 18) {
-                throw new Error('unexpected {value} length');
-            }
-            len += 18;
-            let offset = 0;
-            // Read year (Int32BE)
-            const year = cursor.readInt32BE(offset);
-            offset += 4;
-            // Read month (UInt8, 1-based)
-            const month = cursor.readUInt8(offset);
-            offset += 1;
-            // Read day (UInt8, 1-based)
-            const day = cursor.readUInt8(offset);
-            offset += 1;
-            // Read nanoseconds since midnight (BigInt64BE)
-            const nanos = cursor.readBigInt64BE(offset);
-            offset += 8;
-            // Read UTC offset in seconds (Int32BE) - JS Date cannot represent non-zero offsets
-            const utcOffset = cursor.readInt32BE(offset);
-            offset += 4;
-            // Convert nanos to time components
-            const hours = Number(nanos / 3600000000000n);
-            const remainingNanos = nanos % 3600000000000n;
-            const minutes = Number(remainingNanos / 60000000000n);
-            const remainingNanos2 = remainingNanos % 60000000000n;
-            const seconds = Number(remainingNanos2 / 1000000000n);
-            const millis = Number((remainingNanos2 % 1000000000n) / 1000000n);
-            const v = new Date(Date.UTC(year, month - 1, day, hours, minutes, seconds, millis));
-            // Date.UTC treats years 0-99 as 1900-1999, correct it
-            if (year >= 0 && year <= 99) {
-                v.setUTCFullYear(year);
-            }
-            // Adjust for non-zero UTC offset (JS Date is always UTC internally)
-            if (utcOffset !== 0) {
-                v.setTime(v.getTime() - utcOffset * 1000);
-            }
-            return { v, len };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<Date>}
+     */
+    async deserializeValue(reader, valueFlag, typeCode) {
+        // 18 bytes: year(4) + month(1) + day(1) + nanos(8) + utcOffset(4)
+        const buf = await reader.readBytes(18);
+        let offset = 0;
+        const year = buf.readInt32BE(offset);
+        offset += 4;
+        const month = buf.readUInt8(offset);
+        offset += 1;
+        const day = buf.readUInt8(offset);
+        offset += 1;
+        const nanos = buf.readBigInt64BE(offset);
+        offset += 8;
+        const utcOffset = buf.readInt32BE(offset);
+        // Convert nanos to time components
+        const hours = Number(nanos / 3600000000000n);
+        const remainingNanos = nanos % 3600000000000n;
+        const minutes = Number(remainingNanos / 60000000000n);
+        const remainingNanos2 = remainingNanos % 60000000000n;
+        const seconds = Number(remainingNanos2 / 1000000000n);
+        const millis = Number((remainingNanos2 % 1000000000n) / 1000000n);
+        const v = new Date(Date.UTC(year, month - 1, day, hours, minutes, seconds, millis));
+        // Date.UTC treats years 0-99 as 1900-1999, correct it
+        if (year >= 0 && year <= 99) {
+            v.setUTCFullYear(year);
+        }
+        // Adjust for non-zero UTC offset (JS Date is always UTC internally)
+        if (utcOffset !== 0) {
+            v.setTime(v.getTime() - utcOffset * 1000);
+        }
+        return v;
+    }
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<Date|null>}
+     */
+    async deserialize(reader) {
+        const type_code = await reader.readUInt8();
+        if (type_code !== this.ID) {
+            throw new Error(`DateTimeSerializer: unexpected {type_code}=0x${type_code.toString(16)}`);
+        }
+        const value_flag = await reader.readUInt8();
+        if (value_flag === 0x01) {
+            return null;
         }
-        catch (err) {
-            throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
+        if (value_flag !== 0x00) {
+            throw new Error(`DateTimeSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
         }
+        return this.deserializeValue(reader, value_flag, type_code);
     }
 }

package/build/esm/structure/io/binary/internals/DoubleSerializer.d.ts

@@ -3,9 +3,17 @@ export default class DoubleSerializer {
     ioc: any;
     canBeUsedFor(value: any): boolean;
     serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
-    deserialize(buffer: any, fullyQualifiedFormat?: boolean, ...args: any[]): {
-        v: any;
-        len: number;
-    };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<number>}
+     */
+    deserializeValue(reader: StreamReader, valueFlag: number, typeCode: number): Promise<number>;
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<number|null>}
+     */
+    deserialize(reader: StreamReader): Promise<number | null>;
 }
 import { Buffer } from 'buffer';

package/build/esm/structure/io/binary/internals/DoubleSerializer.js

@@ -44,45 +44,31 @@ export default class DoubleSerializer {
         bufs.push(v);
         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.DOUBLE) {
-                    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);
-            }
-            if (cursor.length < 8) {
-                throw new Error('unexpected {value} length');
-            }
-            len += 8;
-            const v = cursor.readDoubleBE();
-            return { v, len };
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<number>}
+     */
+    async deserializeValue(reader, valueFlag, typeCode) {
+        return await reader.readDoubleBE();
+    }
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<number|null>}
+     */
+    async deserialize(reader) {
+        const type_code = await reader.readUInt8();
+        if (type_code !== this.ioc.DataType.DOUBLE) {
+            throw new Error(`DoubleSerializer: unexpected {type_code}=0x${type_code.toString(16)}`);
+        }
+        const value_flag = await reader.readUInt8();
+        if (value_flag === 0x01) {
+            return null;
         }
-        catch (err) {
-            throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
+        if (value_flag !== 0x00) {
+            throw new Error(`DoubleSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
         }
+        return this.deserializeValue(reader, value_flag, type_code);
     }
 }