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

package/build/cjs/structure/graph.d.cts

@@ -3,8 +3,14 @@
  */
 /**
  * An "empty" graph object to server only as a reference.
+ *
+ * Holds in-memory collections of vertices and edges so that GraphBinary
+ * Graph (0x10) deserialization can return a usable data container.
  */
 export declare class Graph {
+    readonly vertices: Map<any, Vertex>;
+    readonly edges: Map<any, Edge>;
+    constructor();
     toString(): string;
 }
 declare class Element<TLabel extends string = string, TId = any> {
@@ -20,14 +26,15 @@ declare class Element<TLabel extends string = string, TId = any> {
 export declare class Vertex<TLabel extends string = string, TProperties extends Record<string, any> = Record<string, any>, TId = number, TVertexProperties = {
     [P in keyof TProperties]: P extends string ? VertexProperties<P, TProperties[P]> : never;
 }> extends Element<TLabel, TId> {
-    constructor(id: TId, label: TLabel, properties?: Property[] | null);
+    readonly labels: Set<string>;
+    constructor(id: TId, label: TLabel | string[], properties?: Property[] | null, labels?: string[]);
     toString(): string;
 }
 export declare class Edge<TOutVertex extends Vertex = Vertex, TLabel extends string = string, TInVertex extends Vertex = Vertex, TProperties extends Record<string, any> = Record<string, any>, TId = number> extends Element<TLabel, TId> {
     readonly outV: TOutVertex;
-    readonly label: TLabel;
     readonly inV: TInVertex;
-    constructor(id: TId, outV: TOutVertex, label: TLabel, inV: TInVertex, properties?: Property[] | null);
+    readonly labels: Set<string>;
+    constructor(id: TId, outV: TOutVertex, label: TLabel | string[], inV: TInVertex, properties?: Property[] | null, labels?: string[]);
     toString(): string;
 }
 export declare class VertexProperty<TLabel extends string = string, TValue = any, TProperties extends Record<string, any> | null | undefined = Record<string, any>, TId = any> extends Element<TLabel, TId> {
@@ -44,6 +51,100 @@ export declare class Property<T = any> {
     toString(): string;
     equals(other: any): boolean;
 }
+/**
+ * A tree data structure with a tree-shaped public API.
+ *
+ * Children are kept in a private, ordered array of {key, value} entries (not a
+ * native {@link Map}, whose reference-identity keys would break value-equality).
+ * Access is only through the read API; lookups use {@link treeKeysEqual}, which
+ * compares keys by value and treats null/undefined as a distinct key.
+ */
+export declare class Tree {
+    #private;
+    constructor(...rootValues: any[]);
+    /**
+     * Locates the entry whose key is structurally equal to the given key.
+     * @returns the matching entry, or undefined if none exists.
+     */
+    private _findEntry;
+    /**
+     * Returns the keys at the root of this tree.
+     */
+    rootNodes(): any[];
+    /**
+     * Returns the child subtree for the given key.
+     * @throws {Error} if no child exists for the given key.
+     */
+    childAt(key: any): Tree;
+    /**
+     * Returns true if the given key is an immediate child of this tree.
+     */
+    hasChild(key: any): boolean;
+    /**
+     * Returns true if the given value appears as a key anywhere in this tree (recursive).
+     */
+    contains(value: any): boolean;
+    /**
+     * Recursively searches the tree for the first subtree rooted at key.
+     * @returns the matching subtree, or undefined if absent.
+     */
+    findSubtree(key: any): Tree | undefined;
+    /**
+     * Returns the existing child for key, or inserts and returns a new empty Tree if absent.
+     */
+    getOrCreateChild(key: any): Tree;
+    /**
+     * Returns true if this tree has no children. An empty tree is considered a leaf.
+     */
+    isLeaf(): boolean;
+    /**
+     * Returns the total number of nodes (keys) in the tree, counted recursively.
+     */
+    nodeCount(): number;
+    /**
+     * Returns the keys at the given depth. Depth 0 returns the root keys.
+     * Negative depths or depths beyond the tree's height return an empty array.
+     */
+    getNodesAtDepth(depth: number): any[];
+    /**
+     * Returns the trees at the given depth. Depth 0 returns a singleton list containing this tree.
+     * Negative depths or depths beyond the tree's height return an empty array.
+     */
+    getTreesAtDepth(depth: number): Tree[];
+    /**
+     * Returns all keys whose subtrees are leaves.
+     */
+    getLeafNodes(): any[];
+    private _collectLeafKeys;
+    /**
+     * Returns single-key trees representing each leaf key in this tree, preserving the original
+     * key-to-empty-subtree mapping.
+     */
+    getLeafTrees(): Tree[];
+    private _collectLeafTrees;
+    /**
+     * Recursively merges other into this tree. For overlapping keys, child subtrees are merged in turn.
+     * For keys present only in other, the corresponding subtree reference is adopted directly.
+     */
+    addTree(other: Tree): void;
+    /**
+     * Splits this tree into one tree per root key. If the tree has a single root, returns a singleton list
+     * containing this tree.
+     */
+    splitParents(): Tree[];
+    /**
+     * Produces a formatted string representation of the tree structure using a |-- ASCII style,
+     * Uses a |-- ASCII style with a 3-space indent per level and no trailing newline.
+     */
+    prettyPrint(): string;
+    private _prettyPrint;
+    /**
+     * Structural recursive equality. Order across siblings is irrelevant; two trees are equal if they have the
+     * same set of keys and each key's subtree is recursively equal.
+     */
+    equals(other: any): boolean;
+    toString(): string;
+}
 /**
  * Represents a walk through a graph as defined by a traversal.
  */
@@ -54,4 +155,22 @@ export declare class Path {
     toString(): string;
     equals(other: any): any;
 }
+/**
+ * Represents a composite Provider Defined Type (PDT).
+ */
+export declare class CompositePDT {
+    readonly name: string;
+    readonly fields: Readonly<Record<string, any>>;
+    constructor(name: string, fields?: Record<string, any>);
+    toString(): string;
+}
+/**
+ * Represents a primitive Provider Defined Type (PDT).
+ */
+export declare class PrimitivePDT {
+    readonly name: string;
+    readonly value: string;
+    constructor(name: string, value: string);
+    toString(): string;
+}
 export {};

package/build/cjs/structure/io/binary/GraphBinary.cjs

@@ -54,7 +54,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.graphBinaryWriter = exports.graphBinaryReader = exports.anySerializer = exports.numberSerializationStrategy = exports.enumSerializer = exports.unspecifiedNullSerializer = exports.markerSerializer = exports.booleanSerializer = exports.shortSerializer = exports.binarySerializer = exports.byteSerializer = exports.bigIntegerSerializer = exports.vertexPropertySerializer = exports.vertexSerializer = exports.propertySerializer = exports.pathSerializer = exports.edgeSerializer = exports.uuidSerializer = exports.setSerializer = exports.mapSerializer = exports.listSerializer = exports.floatSerializer = exports.doubleSerializer = exports.dateTimeSerializer = exports.stringSerializer = exports.longSerializer = exports.intSerializer = exports.serializers = exports.DataType = void 0;
+exports.graphBinaryWriter = exports.graphBinaryReader = exports.anySerializer = exports.numberSerializationStrategy = exports.treeSerializer = exports.primitivePDTSerializer = exports.compositePDTSerializer = exports.enumSerializer = exports.unspecifiedNullSerializer = exports.markerSerializer = exports.booleanSerializer = exports.shortSerializer = exports.binarySerializer = exports.byteSerializer = exports.bigIntegerSerializer = exports.graphSerializer = exports.vertexPropertySerializer = exports.vertexSerializer = exports.propertySerializer = exports.pathSerializer = exports.edgeSerializer = exports.uuidSerializer = exports.setSerializer = exports.mapSerializer = exports.listSerializer = exports.floatSerializer = exports.doubleSerializer = exports.dateTimeSerializer = exports.stringSerializer = exports.longSerializer = exports.intSerializer = exports.serializers = exports.DataType = void 0;
+exports.createPreciseReader = createPreciseReader;
 /**
  * GraphBinary 4.0 support implementation.
  *
@@ -68,7 +69,6 @@ exports.graphBinaryWriter = exports.graphBinaryReader = exports.anySerializer =
  * TODO: it has the following open topics:
  * Core Data Types support:
  * - [] 0x22: BigDecimal
- * - [] 0x2b: Tree
  * Extended Types support:
  * - [] 0x80: Char
  * - [] 0x81: Duration
@@ -90,9 +90,11 @@ const SetSerializer_js_1 = __importDefault(require("./internals/SetSerializer.cj
 const UuidSerializer_js_1 = __importDefault(require("./internals/UuidSerializer.cjs"));
 const EdgeSerializer_js_1 = __importDefault(require("./internals/EdgeSerializer.cjs"));
 const PathSerializer_js_1 = __importDefault(require("./internals/PathSerializer.cjs"));
+const TreeSerializer_js_1 = __importDefault(require("./internals/TreeSerializer.cjs"));
 const PropertySerializer_js_1 = __importDefault(require("./internals/PropertySerializer.cjs"));
 const VertexSerializer_js_1 = __importDefault(require("./internals/VertexSerializer.cjs"));
 const VertexPropertySerializer_js_1 = __importDefault(require("./internals/VertexPropertySerializer.cjs"));
+const GraphSerializer_js_1 = __importDefault(require("./internals/GraphSerializer.cjs"));
 const BigIntegerSerializer_js_1 = __importDefault(require("./internals/BigIntegerSerializer.cjs"));
 const ByteSerializer_js_1 = __importDefault(require("./internals/ByteSerializer.cjs"));
 const BinarySerializer_js_1 = __importDefault(require("./internals/BinarySerializer.cjs"));
@@ -102,47 +104,74 @@ const MarkerSerializer_js_1 = __importDefault(require("./internals/MarkerSeriali
 const UnspecifiedNullSerializer_js_1 = __importDefault(require("./internals/UnspecifiedNullSerializer.cjs"));
 const EnumSerializer_js_1 = __importDefault(require("./internals/EnumSerializer.cjs"));
 const StubSerializer_js_1 = __importDefault(require("./internals/StubSerializer.cjs"));
+const CompositePDTSerializer_js_1 = __importDefault(require("./internals/CompositePDTSerializer.cjs"));
+const PrimitivePDTSerializer_js_1 = __importDefault(require("./internals/PrimitivePDTSerializer.cjs"));
 const NumberSerializationStrategy_js_1 = __importDefault(require("./internals/NumberSerializationStrategy.cjs"));
 const AnySerializer_js_1 = __importDefault(require("./internals/AnySerializer.cjs"));
 const GraphBinaryReader_js_1 = __importDefault(require("./internals/GraphBinaryReader.cjs"));
 const GraphBinaryWriter_js_1 = __importDefault(require("./internals/GraphBinaryWriter.cjs"));
-const ioc = {};
-ioc.DataType = DataType_js_1.default;
-ioc.utils = utils;
-ioc.serializers = {};
-ioc.intSerializer = new IntSerializer_js_1.default(ioc);
-ioc.longSerializer = new LongSerializer_js_1.default(ioc);
-ioc.stringSerializer = new StringSerializer_js_1.default(ioc, ioc.DataType.STRING);
-ioc.dateTimeSerializer = new DateTimeSerializer_js_1.default(ioc);
-ioc.doubleSerializer = new DoubleSerializer_js_1.default(ioc);
-ioc.floatSerializer = new FloatSerializer_js_1.default(ioc);
-ioc.listSerializer = new ArraySerializer_js_1.default(ioc, ioc.DataType.LIST);
-ioc.mapSerializer = new MapSerializer_js_1.default(ioc);
-ioc.setSerializer = new SetSerializer_js_1.default(ioc, ioc.DataType.SET);
-ioc.uuidSerializer = new UuidSerializer_js_1.default(ioc);
-ioc.edgeSerializer = new EdgeSerializer_js_1.default(ioc);
-ioc.pathSerializer = new PathSerializer_js_1.default(ioc);
-ioc.propertySerializer = new PropertySerializer_js_1.default(ioc);
-ioc.vertexSerializer = new VertexSerializer_js_1.default(ioc);
-ioc.vertexPropertySerializer = new VertexPropertySerializer_js_1.default(ioc);
-ioc.bigIntegerSerializer = new BigIntegerSerializer_js_1.default(ioc);
-ioc.byteSerializer = new ByteSerializer_js_1.default(ioc);
-ioc.binarySerializer = new BinarySerializer_js_1.default(ioc);
-ioc.shortSerializer = new ShortSerializer_js_1.default(ioc);
-ioc.booleanSerializer = new BooleanSerializer_js_1.default(ioc);
-ioc.markerSerializer = new MarkerSerializer_js_1.default(ioc);
-ioc.unspecifiedNullSerializer = new UnspecifiedNullSerializer_js_1.default(ioc);
-ioc.enumSerializer = new EnumSerializer_js_1.default(ioc);
-// Register stub serializers for unimplemented v4 types
-new StubSerializer_js_1.default(ioc, ioc.DataType.TREE, 'Tree');
-new StubSerializer_js_1.default(ioc, ioc.DataType.GRAPH, 'Graph');
-new StubSerializer_js_1.default(ioc, ioc.DataType.COMPOSITEPDT, 'CompositePDT');
-new StubSerializer_js_1.default(ioc, ioc.DataType.PRIMITIVEPDT, 'PrimitivePDT');
-ioc.numberSerializationStrategy = new NumberSerializationStrategy_js_1.default(ioc);
-ioc.anySerializer = new AnySerializer_js_1.default(ioc);
-ioc.graphBinaryReader = new GraphBinaryReader_js_1.default(ioc);
-ioc.graphBinaryWriter = new GraphBinaryWriter_js_1.default(ioc);
+const utils_js_1 = require("../../../utils.cjs");
+function createIoc(anySerializerOptions) {
+    const ioc = {};
+    ioc.DataType = DataType_js_1.default;
+    ioc.utils = utils;
+    ioc.serializers = {};
+    ioc.intSerializer = new IntSerializer_js_1.default(ioc);
+    ioc.longSerializer = new LongSerializer_js_1.default(ioc);
+    ioc.stringSerializer = new StringSerializer_js_1.default(ioc, ioc.DataType.STRING);
+    ioc.dateTimeSerializer = new DateTimeSerializer_js_1.default(ioc);
+    ioc.doubleSerializer = new DoubleSerializer_js_1.default(ioc);
+    ioc.floatSerializer = new FloatSerializer_js_1.default(ioc);
+    ioc.listSerializer = new ArraySerializer_js_1.default(ioc, ioc.DataType.LIST);
+    ioc.mapSerializer = new MapSerializer_js_1.default(ioc);
+    ioc.setSerializer = new SetSerializer_js_1.default(ioc, ioc.DataType.SET);
+    ioc.uuidSerializer = new UuidSerializer_js_1.default(ioc);
+    ioc.edgeSerializer = new EdgeSerializer_js_1.default(ioc);
+    ioc.pathSerializer = new PathSerializer_js_1.default(ioc);
+    ioc.propertySerializer = new PropertySerializer_js_1.default(ioc);
+    ioc.vertexSerializer = new VertexSerializer_js_1.default(ioc);
+    ioc.vertexPropertySerializer = new VertexPropertySerializer_js_1.default(ioc);
+    ioc.graphSerializer = new GraphSerializer_js_1.default(ioc);
+    ioc.bigIntegerSerializer = new BigIntegerSerializer_js_1.default(ioc);
+    ioc.byteSerializer = new ByteSerializer_js_1.default(ioc);
+    ioc.binarySerializer = new BinarySerializer_js_1.default(ioc);
+    ioc.shortSerializer = new ShortSerializer_js_1.default(ioc);
+    ioc.booleanSerializer = new BooleanSerializer_js_1.default(ioc);
+    ioc.markerSerializer = new MarkerSerializer_js_1.default(ioc);
+    ioc.unspecifiedNullSerializer = new UnspecifiedNullSerializer_js_1.default(ioc);
+    ioc.enumSerializer = new EnumSerializer_js_1.default(ioc);
+    ioc.compositePDTSerializer = new CompositePDTSerializer_js_1.default(ioc);
+    ioc.primitivePDTSerializer = new PrimitivePDTSerializer_js_1.default(ioc);
+    ioc.treeSerializer = new TreeSerializer_js_1.default(ioc);
+    ioc.pdtRegistry = null;
+    ioc.numberSerializationStrategy = new NumberSerializationStrategy_js_1.default(ioc);
+    ioc.anySerializer = new AnySerializer_js_1.default(ioc, anySerializerOptions);
+    ioc.graphBinaryReader = new GraphBinaryReader_js_1.default(ioc);
+    ioc.graphBinaryWriter = new GraphBinaryWriter_js_1.default(ioc);
+    return ioc;
+}
+function createPreciseReader() {
+    const wrapperMap = new Map([
+        [DataType_js_1.default.INT, utils_js_1.Int],
+        [DataType_js_1.default.LONG, utils_js_1.Long],
+        [DataType_js_1.default.FLOAT, utils_js_1.Float],
+        [DataType_js_1.default.DOUBLE, utils_js_1.Double],
+        [DataType_js_1.default.SHORT, utils_js_1.Short],
+        [DataType_js_1.default.BYTE, utils_js_1.Byte],
+    ]);
+    const preciseIoc = createIoc({
+        postDeserialize(result, typeCode) {
+            const Wrapper = wrapperMap.get(typeCode);
+            if (Wrapper && result !== null && result !== undefined) {
+                return new Wrapper(result);
+            }
+            return result;
+        },
+    });
+    return preciseIoc.graphBinaryReader;
+}
+const ioc = createIoc();
 var DataType_js_2 = require("./internals/DataType.cjs");
 Object.defineProperty(exports, "DataType", { enumerable: true, get: function () { return __importDefault(DataType_js_2).default; } });
-exports.serializers = ioc.serializers, exports.intSerializer = ioc.intSerializer, exports.longSerializer = ioc.longSerializer, exports.stringSerializer = ioc.stringSerializer, exports.dateTimeSerializer = ioc.dateTimeSerializer, exports.doubleSerializer = ioc.doubleSerializer, exports.floatSerializer = ioc.floatSerializer, exports.listSerializer = ioc.listSerializer, exports.mapSerializer = ioc.mapSerializer, exports.setSerializer = ioc.setSerializer, exports.uuidSerializer = ioc.uuidSerializer, exports.edgeSerializer = ioc.edgeSerializer, exports.pathSerializer = ioc.pathSerializer, exports.propertySerializer = ioc.propertySerializer, exports.vertexSerializer = ioc.vertexSerializer, exports.vertexPropertySerializer = ioc.vertexPropertySerializer, exports.bigIntegerSerializer = ioc.bigIntegerSerializer, exports.byteSerializer = ioc.byteSerializer, exports.binarySerializer = ioc.binarySerializer, exports.shortSerializer = ioc.shortSerializer, exports.booleanSerializer = ioc.booleanSerializer, exports.markerSerializer = ioc.markerSerializer, exports.unspecifiedNullSerializer = ioc.unspecifiedNullSerializer, exports.enumSerializer = ioc.enumSerializer, exports.numberSerializationStrategy = ioc.numberSerializationStrategy, exports.anySerializer = ioc.anySerializer, exports.graphBinaryReader = ioc.graphBinaryReader, exports.graphBinaryWriter = ioc.graphBinaryWriter;
+exports.serializers = ioc.serializers, exports.intSerializer = ioc.intSerializer, exports.longSerializer = ioc.longSerializer, exports.stringSerializer = ioc.stringSerializer, exports.dateTimeSerializer = ioc.dateTimeSerializer, exports.doubleSerializer = ioc.doubleSerializer, exports.floatSerializer = ioc.floatSerializer, exports.listSerializer = ioc.listSerializer, exports.mapSerializer = ioc.mapSerializer, exports.setSerializer = ioc.setSerializer, exports.uuidSerializer = ioc.uuidSerializer, exports.edgeSerializer = ioc.edgeSerializer, exports.pathSerializer = ioc.pathSerializer, exports.propertySerializer = ioc.propertySerializer, exports.vertexSerializer = ioc.vertexSerializer, exports.vertexPropertySerializer = ioc.vertexPropertySerializer, exports.graphSerializer = ioc.graphSerializer, exports.bigIntegerSerializer = ioc.bigIntegerSerializer, exports.byteSerializer = ioc.byteSerializer, exports.binarySerializer = ioc.binarySerializer, exports.shortSerializer = ioc.shortSerializer, exports.booleanSerializer = ioc.booleanSerializer, exports.markerSerializer = ioc.markerSerializer, exports.unspecifiedNullSerializer = ioc.unspecifiedNullSerializer, exports.enumSerializer = ioc.enumSerializer, exports.compositePDTSerializer = ioc.compositePDTSerializer, exports.primitivePDTSerializer = ioc.primitivePDTSerializer, exports.treeSerializer = ioc.treeSerializer, exports.numberSerializationStrategy = ioc.numberSerializationStrategy, exports.anySerializer = ioc.anySerializer, exports.graphBinaryReader = ioc.graphBinaryReader, exports.graphBinaryWriter = ioc.graphBinaryWriter;
 exports.default = ioc;

package/build/cjs/structure/io/binary/GraphBinary.d.cts

@@ -1,3 +1,4 @@
+export function createPreciseReader(): GraphBinaryReader;
 export { default as DataType } from "./internals/DataType.cjs";
 export const serializers: {};
 export const intSerializer: IntSerializer;
@@ -15,6 +16,7 @@ export const pathSerializer: PathSerializer;
 export const propertySerializer: PropertySerializer;
 export const vertexSerializer: VertexSerializer;
 export const vertexPropertySerializer: VertexPropertySerializer;
+export const graphSerializer: GraphSerializer;
 export const bigIntegerSerializer: BigIntegerSerializer;
 export const byteSerializer: ByteSerializer;
 export const binarySerializer: BinarySerializer;
@@ -23,11 +25,15 @@ export const booleanSerializer: BooleanSerializer;
 export const markerSerializer: MarkerSerializer;
 export const unspecifiedNullSerializer: UnspecifiedNullSerializer;
 export const enumSerializer: EnumSerializer;
+export const compositePDTSerializer: CompositePDTSerializer;
+export const primitivePDTSerializer: PrimitivePDTSerializer;
+export const treeSerializer: TreeSerializer;
 export const numberSerializationStrategy: NumberSerializationStrategy;
 export const anySerializer: AnySerializer;
 export const graphBinaryReader: GraphBinaryReader;
 export const graphBinaryWriter: GraphBinaryWriter;
 export default ioc;
+import GraphBinaryReader from './internals/GraphBinaryReader.cjs';
 import IntSerializer from './internals/IntSerializer.cjs';
 import LongSerializer from './internals/LongSerializer.cjs';
 import StringSerializer from './internals/StringSerializer.cjs';
@@ -43,6 +49,7 @@ import PathSerializer from './internals/PathSerializer.cjs';
 import PropertySerializer from './internals/PropertySerializer.cjs';
 import VertexSerializer from './internals/VertexSerializer.cjs';
 import VertexPropertySerializer from './internals/VertexPropertySerializer.cjs';
+import GraphSerializer from './internals/GraphSerializer.cjs';
 import BigIntegerSerializer from './internals/BigIntegerSerializer.cjs';
 import ByteSerializer from './internals/ByteSerializer.cjs';
 import BinarySerializer from './internals/BinarySerializer.cjs';
@@ -51,9 +58,11 @@ import BooleanSerializer from './internals/BooleanSerializer.cjs';
 import MarkerSerializer from './internals/MarkerSerializer.cjs';
 import UnspecifiedNullSerializer from './internals/UnspecifiedNullSerializer.cjs';
 import EnumSerializer from './internals/EnumSerializer.cjs';
+import CompositePDTSerializer from './internals/CompositePDTSerializer.cjs';
+import PrimitivePDTSerializer from './internals/PrimitivePDTSerializer.cjs';
+import TreeSerializer from './internals/TreeSerializer.cjs';
 import NumberSerializationStrategy from './internals/NumberSerializationStrategy.cjs';
 import AnySerializer from './internals/AnySerializer.cjs';
-import GraphBinaryReader from './internals/GraphBinaryReader.cjs';
 import GraphBinaryWriter from './internals/GraphBinaryWriter.cjs';
 declare namespace ioc {
     export { DataType };
@@ -74,6 +83,7 @@ declare namespace ioc {
     export let propertySerializer: PropertySerializer;
     export let vertexSerializer: VertexSerializer;
     export let vertexPropertySerializer: VertexPropertySerializer;
+    export let graphSerializer: GraphSerializer;
     export let bigIntegerSerializer: BigIntegerSerializer;
     export let byteSerializer: ByteSerializer;
     export let binarySerializer: BinarySerializer;
@@ -82,6 +92,10 @@ declare namespace ioc {
     export let markerSerializer: MarkerSerializer;
     export let unspecifiedNullSerializer: UnspecifiedNullSerializer;
     export let enumSerializer: EnumSerializer;
+    export let compositePDTSerializer: CompositePDTSerializer;
+    export let primitivePDTSerializer: PrimitivePDTSerializer;
+    export let treeSerializer: TreeSerializer;
+    export let pdtRegistry: any;
     export let numberSerializationStrategy: NumberSerializationStrategy;
     export let anySerializer: AnySerializer;
     export let graphBinaryReader: GraphBinaryReader;

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

@@ -21,10 +21,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 /**
  * @author Igor Ostapenko
  */
-const buffer_1 = require("node:buffer");
 class AnySerializer {
-    constructor(ioc) {
+    constructor(ioc, { postDeserialize } = {}) {
         this.ioc = ioc;
+        this._postDeserialize = postDeserialize || null;
         // specifically ordered, the first canBeUsedFor=true wins
         this.serializers = [
             ioc.unspecifiedNullSerializer,
@@ -39,9 +39,13 @@ class AnySerializer {
             ioc.propertySerializer,
             ioc.vertexSerializer,
             ioc.vertexPropertySerializer,
+            ioc.graphSerializer,
             ioc.enumSerializer,
             ioc.stringSerializer,
             ioc.binarySerializer,
+            ioc.primitivePDTSerializer,
+            ioc.compositePDTSerializer,
+            ioc.treeSerializer,
             ioc.mapSerializer,
         ];
     }
@@ -56,25 +60,38 @@ class AnySerializer {
     serialize(item, fullyQualifiedFormat = true) {
         return this.getSerializerCanBeUsedFor(item).serialize(item, fullyQualifiedFormat);
     }
-    deserialize(buffer) {
-        // obviously, fullyQualifiedFormat always is true
+    /**
+     * Async deserialization from a StreamReader.
+     * Reads type_code + value_flag, then dispatches to the appropriate serializer's deserializeValue().
+     * @param {StreamReader} reader
+     * @returns {Promise<any>}
+     */
+    async deserialize(reader) {
+        const pos = reader.position;
+        const type_code = await reader.readUInt8();
+        const serializer = this.ioc.serializers[type_code];
+        if (!serializer) {
+            throw new Error(`AnySerializer: unknown {type_code}=0x${type_code.toString(16)} at position ${pos}`);
+        }
+        const value_flag = await reader.readUInt8();
+        if (value_flag === 0x01) {
+            return null;
+        }
+        if (value_flag !== 0x00 && value_flag !== 0x02) {
+            throw new Error(`AnySerializer: unexpected {value_flag}=0x${value_flag.toString(16)} at position ${pos}`);
+        }
+        let result;
         try {
-            if (buffer === undefined || buffer === null || !(buffer instanceof buffer_1.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);
+            result = await serializer.deserializeValue(reader, value_flag, type_code);
         }
         catch (err) {
-            throw this.ioc.utils.des_error({ serializer: this, args: arguments, err });
+            err.message = `${serializer.constructor.name}.deserializeValue() at position ${pos}: ${err.message}`;
+            throw err;
+        }
+        if (this._postDeserialize) {
+            return this._postDeserialize(result, type_code);
         }
+        return result;
     }
 }
 exports.default = AnySerializer;

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

@@ -1,8 +1,18 @@
+/**
+ * @author Igor Ostapenko
+ */
 export default class AnySerializer {
-    constructor(ioc: any);
+    constructor(ioc: any, { postDeserialize }?: {});
     ioc: any;
+    _postDeserialize: any;
     serializers: any[];
     getSerializerCanBeUsedFor(item: any): any;
     serialize(item: any, fullyQualifiedFormat?: boolean): any;
-    deserialize(buffer: any, ...args: any[]): any;
+    /**
+     * Async deserialization from a StreamReader.
+     * Reads type_code + value_flag, then dispatches to the appropriate serializer's deserializeValue().
+     * @param {StreamReader} reader
+     * @returns {Promise<any>}
+     */
+    deserialize(reader: StreamReader): Promise<any>;
 }

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

@@ -57,83 +57,52 @@ class ArraySerializer {
         }
         return buffer_1.Buffer.concat(bufs);
     }
-    deserialize(buffer, fullyQualifiedFormat = true) {
-        let len = 0;
-        let cursor = buffer;
-        let isBulked = false;
-        try {
-            if (buffer === undefined || buffer === null || !(buffer instanceof buffer_1.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 && value_flag !== 2) {
-                    throw new Error('unexpected {value_flag}');
-                }
-                isBulked = value_flag === 2;
-                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);
-            const v = [];
-            for (let i = 0; i < length; i++) {
-                let value, value_len;
-                try {
-                    ({ v: value, len: value_len } = this.ioc.anySerializer.deserialize(cursor));
-                    len += value_len;
-                }
-                catch (err) {
-                    err.message = `{item_${i}}: ` + err.message;
-                    throw err;
-                }
-                cursor = cursor.slice(value_len);
-                if (isBulked) {
-                    if (cursor.length < 8) {
-                        throw new Error(`{item_${i}}: bulk count is missing`);
-                    }
-                    const bulkCount = cursor.readBigInt64BE();
-                    len += 8;
-                    cursor = cursor.slice(8);
-                    for (let j = 0n; j < bulkCount; j++) {
-                        v.push(value);
-                    }
-                }
-                else {
+    /**
+     * Async deserialization of array value bytes from a StreamReader.
+     * @param {StreamReader} reader
+     * @param {number} valueFlag - 0x00 for normal, 0x02 for bulked
+     * @param {number} typeCode
+     * @returns {Promise<Array>}
+     */
+    async deserializeValue(reader, valueFlag, typeCode) {
+        const isBulked = valueFlag === 0x02;
+        const length = await this.ioc.intSerializer.deserializeBare(reader);
+        if (length < 0) {
+            throw new Error(`ArraySerializer: {length}=${length} is less than zero`);
+        }
+        const v = [];
+        for (let i = 0; i < length; i++) {
+            const value = await this.ioc.anySerializer.deserialize(reader);
+            if (isBulked) {
+                const bulkCount = await reader.readBigInt64BE();
+                for (let j = 0n; j < bulkCount; j++) {
                     v.push(value);
                 }
             }
-            return { v, len };
+            else {
+                v.push(value);
+            }
+        }
+        return v;
+    }
+    /**
+     * Async fully-qualified deserialization from a StreamReader.
+     * @param {StreamReader} reader
+     * @returns {Promise<Array|null>}
+     */
+    async deserialize(reader) {
+        const type_code = await reader.readUInt8();
+        if (type_code !== this.ID) {
+            throw new Error(`ArraySerializer: 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 && value_flag !== 0x02) {
+            throw new Error(`ArraySerializer: unexpected {value_flag}=0x${value_flag.toString(16)}`);
         }
+        return this.deserializeValue(reader, value_flag, type_code);
     }
 }
 exports.default = ArraySerializer;

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

@@ -4,12 +4,19 @@ export default class ArraySerializer {
     ID: any;
     canBeUsedFor(value: any): value is any[];
     serialize(item: any, fullyQualifiedFormat?: boolean): Buffer<ArrayBuffer>;
-    deserialize(buffer: any, fullyQualifiedFormat?: boolean, ...args: any[]): {
-        v: null;
-        len: number;
-    } | {
-        v: any[];
-        len: number;
-    };
+    /**
+     * Async deserialization of array value bytes from a StreamReader.
+     * @param {StreamReader} reader
+     * @param {number} valueFlag - 0x00 for normal, 0x02 for bulked
+     * @param {number} typeCode
+     * @returns {Promise<Array>}
+     */
+    deserializeValue(reader: StreamReader, valueFlag: number, typeCode: number): Promise<any[]>;
+    /**
+     * Async fully-qualified deserialization from a StreamReader.
+     * @param {StreamReader} reader
+     * @returns {Promise<Array|null>}
+     */
+    deserialize(reader: StreamReader): Promise<any[] | null>;
 }
 import { Buffer } from 'buffer';