gremlin 3.8.1 → 4.0.0-beta.3

package/build/cjs/structure/io/binary/internals/BinarySerializer.cjs

@@ -0,0 +1,92 @@
+"use strict";
+/*
+ *  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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @author Igor Ostapenko
+ */
+const buffer_1 = require("node:buffer");
+class BinarySerializer {
+    constructor(ioc) {
+        this.ioc = ioc;
+        this.ioc.serializers[ioc.DataType.BINARY] = this;
+    }
+    canBeUsedFor(value) {
+        return value instanceof buffer_1.Buffer;
+    }
+    serialize(item, fullyQualifiedFormat = true) {
+        if (item === undefined || item === null) {
+            if (fullyQualifiedFormat) {
+                return buffer_1.Buffer.from([this.ioc.DataType.BINARY, 0x01]);
+            }
+            return buffer_1.Buffer.from([0x00, 0x00, 0x00, 0x00]); // {length} = 0
+        }
+        const bufs = [];
+        if (fullyQualifiedFormat) {
+            bufs.push(buffer_1.Buffer.from([this.ioc.DataType.BINARY, 0x00]));
+        }
+        // {length}
+        let length = item.length;
+        if (length < 0) {
+            length = 0; // TODO: test it
+        }
+        if (length > this.ioc.intSerializer.INT32_MAX) {
+            throw new Error(`Buffer length=${length} is greater than supported max_length=${this.ioc.intSerializer.INT32_MAX}.`);
+        }
+        bufs.push(this.ioc.intSerializer.serialize(length, false));
+        // {value} sequence of bytes
+        bufs.push(item);
+        return buffer_1.Buffer.concat(bufs);
+    }
+    /**
+     * @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_1.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;
+        }
+        if (value_flag !== 0x00) {
+            throw new Error(`BinarySerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
+        }
+        return this.deserializeValue(reader, value_flag, type_code);
+    }
+}
+exports.default = BinarySerializer;

package/build/cjs/structure/io/binary/internals/BinarySerializer.d.cts

@@ -0,0 +1,19 @@
+export default class BinarySerializer {
+    constructor(ioc: any);
+    ioc: any;
+    canBeUsedFor(value: any): boolean;
+    serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
+    /**
+     * @param {StreamReader} reader
+     * @param {number} valueFlag
+     * @param {number} typeCode
+     * @returns {Promise<Buffer>}
+     */
+    deserializeValue(reader: StreamReader, valueFlag: number, typeCode: number): Promise<Buffer>;
+    /**
+     * @param {StreamReader} reader
+     * @returns {Promise<Buffer|null>}
+     */
+    deserialize(reader: StreamReader): Promise<Buffer | null>;
+}
+import { Buffer } from 'buffer';

package/build/cjs/structure/io/binary/internals/BooleanSerializer.cjs

@@ -0,0 +1,79 @@
+"use strict";
+/*
+ *  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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @author Igor Ostapenko
+ */
+const buffer_1 = require("node:buffer");
+class BooleanSerializer {
+    constructor(ioc) {
+        this.ioc = ioc;
+        this.ioc.serializers[ioc.DataType.BOOLEAN] = this;
+    }
+    canBeUsedFor(value) {
+        return typeof value === 'boolean';
+    }
+    serialize(item, fullyQualifiedFormat = true) {
+        if (item === undefined || item === null) {
+            if (fullyQualifiedFormat) {
+                return buffer_1.Buffer.from([this.ioc.DataType.BOOLEAN, 0x01]);
+            }
+            return buffer_1.Buffer.from([0x00]);
+        }
+        const bufs = [];
+        if (fullyQualifiedFormat) {
+            bufs.push(buffer_1.Buffer.from([this.ioc.DataType.BOOLEAN, 0x00]));
+        }
+        bufs.push(buffer_1.Buffer.from([item ? 0x01 : 0x00]));
+        return buffer_1.Buffer.concat(bufs);
+    }
+    /**
+     * @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;
+        }
+        if (value_flag !== 0x00) {
+            throw new Error(`BooleanSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
+        }
+        return this.deserializeValue(reader, value_flag, type_code);
+    }
+}
+exports.default = BooleanSerializer;

package/build/cjs/structure/io/binary/internals/BooleanSerializer.d.cts

@@ -0,0 +1,19 @@
+export default class BooleanSerializer {
+    constructor(ioc: any);
+    ioc: any;
+    canBeUsedFor(value: any): value is boolean;
+    serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
+    /**
+     * @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/cjs/structure/io/binary/internals/ByteSerializer.cjs

@@ -0,0 +1,74 @@
+"use strict";
+/*
+ *  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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @author Igor Ostapenko
+ */
+const buffer_1 = require("node:buffer");
+class ByteSerializer {
+    constructor(ioc) {
+        this.ioc = ioc;
+        this.ioc.serializers[ioc.DataType.BYTE] = this;
+    }
+    serialize(item, fullyQualifiedFormat = true) {
+        if (item === undefined || item === null) {
+            if (fullyQualifiedFormat) {
+                return buffer_1.Buffer.from([this.ioc.DataType.BYTE, 0x01]);
+            }
+            return buffer_1.Buffer.from([0x00]);
+        }
+        const bufs = [];
+        if (fullyQualifiedFormat) {
+            bufs.push(buffer_1.Buffer.from([this.ioc.DataType.BYTE, 0x00]));
+        }
+        const v = buffer_1.Buffer.alloc(1);
+        v.writeInt8(item); // if item is not within int8 limits writeInt8 will error
+        bufs.push(v);
+        return buffer_1.Buffer.concat(bufs);
+    }
+    /**
+     * @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;
+        }
+        if (value_flag !== 0x00) {
+            throw new Error(`ByteSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
+        }
+        return this.deserializeValue(reader, value_flag, type_code);
+    }
+}
+exports.default = ByteSerializer;

package/build/cjs/structure/io/binary/internals/ByteSerializer.d.cts

@@ -0,0 +1,18 @@
+export default class ByteSerializer {
+    constructor(ioc: any);
+    ioc: any;
+    serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
+    /**
+     * @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/cjs/structure/io/binary/internals/CompositePDTSerializer.cjs

@@ -0,0 +1,81 @@
+"use strict";
+/*
+ *  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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const buffer_1 = require("node:buffer");
+const graph_js_1 = require("../../../graph.cjs");
+class CompositePDTSerializer {
+    constructor(ioc) {
+        this.ioc = ioc;
+        this.ioc.serializers[ioc.DataType.COMPOSITEPDT] = this;
+    }
+    canBeUsedFor(value) {
+        return value instanceof graph_js_1.CompositePDT;
+    }
+    serialize(item, fullyQualifiedFormat = true) {
+        if (item === undefined || item === null) {
+            if (fullyQualifiedFormat) {
+                return buffer_1.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_1.Buffer.concat(bufs);
+        }
+        const bufs = [];
+        if (fullyQualifiedFormat) {
+            bufs.push(buffer_1.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_1.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 graph_js_1.CompositePDT(name, fields);
+        const pdtRegistry = reader.pdtRegistry;
+        if (pdtRegistry) {
+            const hydrated = pdtRegistry.hydrate(pdt);
+            if (!(hydrated instanceof graph_js_1.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);
+    }
+}
+exports.default = CompositePDTSerializer;

package/build/cjs/structure/io/binary/internals/CompositePDTSerializer.d.cts

@@ -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.cjs';
+import { Buffer } from 'buffer';

package/build/cjs/structure/io/binary/internals/DataType.cjs

@@ -0,0 +1,63 @@
+"use strict";
+/*
+ *  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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @author Igor Ostapenko
+ */
+/**
+ * Represents a GraphBinary data type.
+ *
+ * See org.apache.tinkerpop.gremlin.structure.io.binary.DataType Java class.
+ */
+const DataType = {
+    INT: 0x01,
+    LONG: 0x02,
+    STRING: 0x03,
+    DATETIME: 0x04,
+    DOUBLE: 0x07,
+    FLOAT: 0x08,
+    LIST: 0x09,
+    MAP: 0x0a,
+    SET: 0x0b,
+    UUID: 0x0c,
+    EDGE: 0x0d,
+    PATH: 0x0e,
+    PROPERTY: 0x0f,
+    GRAPH: 0x10,
+    VERTEX: 0x11,
+    VERTEXPROPERTY: 0x12,
+    DIRECTION: 0x18,
+    T: 0x20,
+    BIGDECIMAL: 0x22,
+    BIGINTEGER: 0x23,
+    BYTE: 0x24,
+    BINARY: 0x25,
+    SHORT: 0x26,
+    BOOLEAN: 0x27,
+    TREE: 0x2b,
+    MERGE: 0x2e,
+    CHAR: 0x80,
+    DURATION: 0x81,
+    COMPOSITEPDT: 0xf0,
+    PRIMITIVEPDT: 0xf1,
+    MARKER: 0xfd,
+    UNSPECIFIED_NULL: 0xfe,
+};
+exports.default = DataType;

package/build/cjs/structure/io/binary/internals/DataType.d.cts

@@ -0,0 +1,35 @@
+export default DataType;
+declare namespace DataType {
+    let INT: number;
+    let LONG: number;
+    let STRING: number;
+    let DATETIME: number;
+    let DOUBLE: number;
+    let FLOAT: number;
+    let LIST: number;
+    let MAP: number;
+    let SET: number;
+    let UUID: number;
+    let EDGE: number;
+    let PATH: number;
+    let PROPERTY: number;
+    let GRAPH: number;
+    let VERTEX: number;
+    let VERTEXPROPERTY: number;
+    let DIRECTION: number;
+    let T: number;
+    let BIGDECIMAL: number;
+    let BIGINTEGER: number;
+    let BYTE: number;
+    let BINARY: number;
+    let SHORT: number;
+    let BOOLEAN: number;
+    let TREE: number;
+    let MERGE: number;
+    let CHAR: number;
+    let DURATION: number;
+    let COMPOSITEPDT: number;
+    let PRIMITIVEPDT: number;
+    let MARKER: number;
+    let UNSPECIFIED_NULL: number;
+}

package/build/cjs/structure/io/binary/internals/DateTimeSerializer.cjs

@@ -0,0 +1,122 @@
+"use strict";
+/*
+ *  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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const buffer_1 = require("node:buffer");
+class DateTimeSerializer {
+    constructor(ioc) {
+        this.ioc = ioc;
+        this.ID = ioc.DataType.DATETIME;
+        this.ioc.serializers[this.ID] = this;
+    }
+    canBeUsedFor(value) {
+        return value instanceof Date;
+    }
+    serialize(item, fullyQualifiedFormat = true) {
+        if (item === undefined || item === null) {
+            if (fullyQualifiedFormat) {
+                return buffer_1.Buffer.from([this.ID, 0x01]);
+            }
+            return buffer_1.Buffer.alloc(18);
+        }
+        const bufs = [];
+        if (fullyQualifiedFormat) {
+            bufs.push(buffer_1.Buffer.from([this.ID, 0x00]));
+        }
+        const v = buffer_1.Buffer.alloc(18);
+        let offset = 0;
+        // Year (Int32BE)
+        v.writeInt32BE(item.getUTCFullYear(), offset);
+        offset += 4;
+        // Month (UInt8, 1-based)
+        v.writeUInt8(item.getUTCMonth() + 1, offset);
+        offset += 1;
+        // Day (UInt8, 1-based)
+        v.writeUInt8(item.getUTCDate(), offset);
+        offset += 1;
+        // Nanoseconds since midnight (BigInt64BE)
+        const hours = item.getUTCHours();
+        const minutes = item.getUTCMinutes();
+        const seconds = item.getUTCSeconds();
+        const millis = item.getUTCMilliseconds();
+        const nanos = BigInt(hours * 3600 + minutes * 60 + seconds) * 1000000000n + BigInt(millis) * 1000000n;
+        v.writeBigInt64BE(nanos, offset);
+        offset += 8;
+        // UTC offset in seconds (Int32BE) - always 0 for JS Date
+        v.writeInt32BE(0, offset);
+        bufs.push(v);
+        return buffer_1.Buffer.concat(bufs);
+    }
+    /**
+     * @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;
+        }
+        if (value_flag !== 0x00) {
+            throw new Error(`DateTimeSerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
+        }
+        return this.deserializeValue(reader, value_flag, type_code);
+    }
+}
+exports.default = DateTimeSerializer;

package/build/cjs/structure/io/binary/internals/DateTimeSerializer.d.cts

@@ -0,0 +1,20 @@
+export default class DateTimeSerializer {
+    constructor(ioc: any);
+    ioc: any;
+    ID: any;
+    canBeUsedFor(value: any): value is Date;
+    serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
+    /**
+     * @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';