@colyseus/schema 3.0.75 → 4.0.0

package/lib/Reflection.d.ts

@@ -1,24 +1,12 @@
-import { ArraySchema } from "./types/custom/ArraySchema";
+import { schema, SchemaType } from "./annotations";
 import { Iterator } from "./encoding/decode";
 import { Encoder } from "./encoder/Encoder";
 import { Decoder } from "./decoder/Decoder";
 import { Schema } from "./Schema";
 /**
- * Reflection
+ * Static methods available on Reflection
  */
-export declare class ReflectionField extends Schema {
-    name: string;
-    type: string;
-    referencedType: number;
-}
-export declare class ReflectionType extends Schema {
-    id: number;
-    extendsId: number;
-    fields: ArraySchema<ReflectionField>;
-}
-export declare class Reflection extends Schema {
-    types: ArraySchema<ReflectionType>;
-    rootType: number;
+interface ReflectionStatic {
     /**
      * Encodes the TypeContext of an Encoder into a buffer.
      *
@@ -26,7 +14,7 @@ export declare class Reflection extends Schema {
      * @param it
      * @returns
      */
-    static encode(encoder: Encoder, it?: Iterator): Buffer;
+    encode: (encoder: Encoder, it?: Iterator) => Uint8Array;
     /**
      * Decodes the TypeContext from a buffer into a Decoder instance.
      *
@@ -34,5 +22,50 @@ export declare class Reflection extends Schema {
      * @param it
      * @returns Decoder instance
      */
-    static decode<T extends Schema = Schema>(bytes: Buffer, it?: Iterator): Decoder<T>;
+    decode: <T extends Schema = Schema>(bytes: Uint8Array, it?: Iterator) => Decoder<T>;
 }
+/**
+ * Reflection
+ */
+export declare const ReflectionField: import("./annotations").SchemaWithExtendsConstructor<{
+    name: "string";
+    type: "string";
+    referencedType: "number";
+}, import(".").AssignableProps<import(".").InferSchemaInstanceType<{
+    name: "string";
+    type: "string";
+    referencedType: "number";
+}>>, typeof Schema>;
+export type ReflectionField = SchemaType<typeof ReflectionField>;
+export declare const ReflectionType: import("./annotations").SchemaWithExtendsConstructor<{
+    id: "number";
+    extendsId: "number";
+    fields: import("./annotations").SchemaWithExtendsConstructor<{
+        name: "string";
+        type: "string";
+        referencedType: "number";
+    }, import(".").AssignableProps<import(".").InferSchemaInstanceType<{
+        name: "string";
+        type: "string";
+        referencedType: "number";
+    }>>, typeof Schema>[];
+}, import(".").AssignableProps<import(".").InferSchemaInstanceType<{
+    id: "number";
+    extendsId: "number";
+    fields: import("./annotations").SchemaWithExtendsConstructor<{
+        name: "string";
+        type: "string";
+        referencedType: "number";
+    }, import(".").AssignableProps<import(".").InferSchemaInstanceType<{
+        name: "string";
+        type: "string";
+        referencedType: "number";
+    }>>, typeof Schema>[];
+}>>, typeof Schema>;
+export type ReflectionType = SchemaType<typeof ReflectionType>;
+export declare const Reflection: ReturnType<typeof schema<{
+    types: [typeof ReflectionType];
+    rootType: "number";
+}>> & ReflectionStatic;
+export type Reflection = SchemaType<typeof Reflection>;
+export {};

package/lib/Reflection.js

@@ -1,233 +1,182 @@
 "use strict";
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Reflection = exports.ReflectionType = exports.ReflectionField = void 0;
 const annotations_1 = require("./annotations");
 const TypeContext_1 = require("./types/TypeContext");
 const Metadata_1 = require("./Metadata");
-const ArraySchema_1 = require("./types/custom/ArraySchema");
 const Encoder_1 = require("./encoder/Encoder");
 const Decoder_1 = require("./decoder/Decoder");
 const Schema_1 = require("./Schema");
 /**
  * Reflection
  */
-class ReflectionField extends Schema_1.Schema {
-}
-exports.ReflectionField = ReflectionField;
-__decorate([
-    (0, annotations_1.type)("string")
-], ReflectionField.prototype, "name", void 0);
-__decorate([
-    (0, annotations_1.type)("string")
-], ReflectionField.prototype, "type", void 0);
-__decorate([
-    (0, annotations_1.type)("number")
-], ReflectionField.prototype, "referencedType", void 0);
-class ReflectionType extends Schema_1.Schema {
-    constructor() {
-        super(...arguments);
-        this.fields = new ArraySchema_1.ArraySchema();
-    }
-}
-exports.ReflectionType = ReflectionType;
-__decorate([
-    (0, annotations_1.type)("number")
-], ReflectionType.prototype, "id", void 0);
-__decorate([
-    (0, annotations_1.type)("number")
-], ReflectionType.prototype, "extendsId", void 0);
-__decorate([
-    (0, annotations_1.type)([ReflectionField])
-], ReflectionType.prototype, "fields", void 0);
-class Reflection extends Schema_1.Schema {
-    constructor() {
-        super(...arguments);
-        this.types = new ArraySchema_1.ArraySchema();
+exports.ReflectionField = (0, annotations_1.schema)({
+    name: "string",
+    type: "string",
+    referencedType: "number",
+});
+exports.ReflectionType = (0, annotations_1.schema)({
+    id: "number",
+    extendsId: "number",
+    fields: [exports.ReflectionField],
+});
+exports.Reflection = (0, annotations_1.schema)({
+    types: [exports.ReflectionType],
+    rootType: "number",
+});
+exports.Reflection.encode = function (encoder, it = { offset: 0 }) {
+    const context = encoder.context;
+    const reflection = new exports.Reflection();
+    const reflectionEncoder = new Encoder_1.Encoder(reflection);
+    // rootType is usually the first schema passed to the Encoder
+    // (unless it inherits from another schema)
+    const rootType = context.schemas.get(encoder.state.constructor);
+    if (rootType > 0) {
+        reflection.rootType = rootType;
     }
-    /**
-     * Encodes the TypeContext of an Encoder into a buffer.
-     *
-     * @param encoder Encoder instance
-     * @param it
-     * @returns
-     */
-    static encode(encoder, it = { offset: 0 }) {
-        const context = encoder.context;
-        const reflection = new Reflection();
-        const reflectionEncoder = new Encoder_1.Encoder(reflection);
-        // rootType is usually the first schema passed to the Encoder
-        // (unless it inherits from another schema)
-        const rootType = context.schemas.get(encoder.state.constructor);
-        if (rootType > 0) {
-            reflection.rootType = rootType;
+    const includedTypeIds = new Set();
+    const pendingReflectionTypes = {};
+    // add type to reflection in a way that respects inheritance
+    // (parent types should be added before their children)
+    const addType = (type) => {
+        if (type.extendsId === undefined || includedTypeIds.has(type.extendsId)) {
+            includedTypeIds.add(type.id);
+            reflection.types.push(type);
+            const deps = pendingReflectionTypes[type.id];
+            if (deps !== undefined) {
+                delete pendingReflectionTypes[type.id];
+                deps.forEach((childType) => addType(childType));
+            }
         }
-        const includedTypeIds = new Set();
-        const pendingReflectionTypes = {};
-        // add type to reflection in a way that respects inheritance
-        // (parent types should be added before their children)
-        const addType = (type) => {
-            if (type.extendsId === undefined || includedTypeIds.has(type.extendsId)) {
-                includedTypeIds.add(type.id);
-                reflection.types.push(type);
-                const deps = pendingReflectionTypes[type.id];
-                if (deps !== undefined) {
-                    delete pendingReflectionTypes[type.id];
-                    deps.forEach((childType) => addType(childType));
-                }
+        else {
+            if (pendingReflectionTypes[type.extendsId] === undefined) {
+                pendingReflectionTypes[type.extendsId] = [];
             }
-            else {
-                if (pendingReflectionTypes[type.extendsId] === undefined) {
-                    pendingReflectionTypes[type.extendsId] = [];
+            pendingReflectionTypes[type.extendsId].push(type);
+        }
+    };
+    context.schemas.forEach((typeid, klass) => {
+        const type = new exports.ReflectionType();
+        type.id = Number(typeid);
+        // support inheritance
+        const inheritFrom = Object.getPrototypeOf(klass);
+        if (inheritFrom !== Schema_1.Schema) {
+            type.extendsId = context.schemas.get(inheritFrom);
+        }
+        const metadata = klass[Symbol.metadata];
+        //
+        // FIXME: this is a workaround for inherited types without additional fields
+        // if metadata is the same reference as the parent class - it means the class has no own metadata
+        //
+        if (metadata !== inheritFrom[Symbol.metadata]) {
+            for (const fieldIndex in metadata) {
+                const index = Number(fieldIndex);
+                const fieldName = metadata[index].name;
+                // skip fields from parent classes
+                if (!Object.prototype.hasOwnProperty.call(metadata, fieldName)) {
+                    continue;
                 }
-                pendingReflectionTypes[type.extendsId].push(type);
-            }
-        };
-        context.schemas.forEach((typeid, klass) => {
-            const type = new ReflectionType();
-            type.id = Number(typeid);
-            // support inheritance
-            const inheritFrom = Object.getPrototypeOf(klass);
-            if (inheritFrom !== Schema_1.Schema) {
-                type.extendsId = context.schemas.get(inheritFrom);
-            }
-            const metadata = klass[Symbol.metadata];
-            //
-            // FIXME: this is a workaround for inherited types without additional fields
-            // if metadata is the same reference as the parent class - it means the class has no own metadata
-            //
-            if (metadata !== inheritFrom[Symbol.metadata]) {
-                for (const fieldIndex in metadata) {
-                    const index = Number(fieldIndex);
-                    const fieldName = metadata[index].name;
-                    // skip fields from parent classes
-                    if (!Object.prototype.hasOwnProperty.call(metadata, fieldName)) {
-                        continue;
-                    }
-                    const reflectionField = new ReflectionField();
-                    reflectionField.name = fieldName;
-                    let fieldType;
-                    const field = metadata[index];
-                    if (typeof (field.type) === "string") {
-                        fieldType = field.type;
+                const reflectionField = new exports.ReflectionField();
+                reflectionField.name = fieldName;
+                let fieldType;
+                const field = metadata[index];
+                if (typeof (field.type) === "string") {
+                    fieldType = field.type;
+                }
+                else {
+                    let childTypeSchema;
+                    //
+                    // TODO: refactor below.
+                    //
+                    if (Schema_1.Schema.is(field.type)) {
+                        fieldType = "ref";
+                        childTypeSchema = field.type;
                     }
                     else {
-                        let childTypeSchema;
-                        //
-                        // TODO: refactor below.
-                        //
-                        if (Schema_1.Schema.is(field.type)) {
-                            fieldType = "ref";
-                            childTypeSchema = field.type;
+                        fieldType = Object.keys(field.type)[0];
+                        if (typeof (field.type[fieldType]) === "string") {
+                            fieldType += ":" + field.type[fieldType]; // array:string
                         }
                         else {
-                            fieldType = Object.keys(field.type)[0];
-                            if (typeof (field.type[fieldType]) === "string") {
-                                fieldType += ":" + field.type[fieldType]; // array:string
-                            }
-                            else {
-                                childTypeSchema = field.type[fieldType];
-                            }
+                            childTypeSchema = field.type[fieldType];
                         }
-                        reflectionField.referencedType = (childTypeSchema)
-                            ? context.getTypeId(childTypeSchema)
-                            : -1;
                     }
-                    reflectionField.type = fieldType;
-                    type.fields.push(reflectionField);
+                    reflectionField.referencedType = (childTypeSchema)
+                        ? context.getTypeId(childTypeSchema)
+                        : -1;
                 }
+                reflectionField.type = fieldType;
+                type.fields.push(reflectionField);
             }
-            addType(type);
-        });
-        // in case there are types that were not added due to inheritance
-        for (const typeid in pendingReflectionTypes) {
-            pendingReflectionTypes[typeid].forEach((type) => reflection.types.push(type));
         }
-        const buf = reflectionEncoder.encodeAll(it);
-        return buf.slice(0, it.offset);
-        // return Buffer.from(buf, 0, it.offset);
+        addType(type);
+    });
+    // in case there are types that were not added due to inheritance
+    for (const typeid in pendingReflectionTypes) {
+        pendingReflectionTypes[typeid].forEach((type) => reflection.types.push(type));
     }
-    /**
-     * Decodes the TypeContext from a buffer into a Decoder instance.
-     *
-     * @param bytes Reflection.encode() output
-     * @param it
-     * @returns Decoder instance
-     */
-    static decode(bytes, it) {
-        const reflection = new Reflection();
-        const reflectionDecoder = new Decoder_1.Decoder(reflection);
-        reflectionDecoder.decode(bytes, it);
-        const typeContext = new TypeContext_1.TypeContext();
-        // 1st pass, initialize metadata + inheritance
-        reflection.types.forEach((reflectionType) => {
-            const parentClass = typeContext.get(reflectionType.extendsId) ?? Schema_1.Schema;
-            const schema = class _ extends parentClass {
-            };
-            // register for inheritance support
-            TypeContext_1.TypeContext.register(schema);
-            // // for inheritance support
-            // Metadata.initialize(schema);
-            typeContext.add(schema, reflectionType.id);
-        }, {});
-        // define fields
-        const addFields = (metadata, reflectionType, parentFieldIndex) => {
-            reflectionType.fields.forEach((field, i) => {
-                const fieldIndex = parentFieldIndex + i;
-                if (field.referencedType !== undefined) {
-                    let fieldType = field.type;
-                    let refType = typeContext.get(field.referencedType);
-                    // map or array of primitive type (-1)
-                    if (!refType) {
-                        const typeInfo = field.type.split(":");
-                        fieldType = typeInfo[0];
-                        refType = typeInfo[1]; // string
-                    }
-                    if (fieldType === "ref") {
-                        Metadata_1.Metadata.addField(metadata, fieldIndex, field.name, refType);
-                    }
-                    else {
-                        Metadata_1.Metadata.addField(metadata, fieldIndex, field.name, { [fieldType]: refType });
-                    }
+    const buf = reflectionEncoder.encodeAll(it);
+    return buf.slice(0, it.offset);
+};
+exports.Reflection.decode = function (bytes, it) {
+    const reflection = new exports.Reflection();
+    const reflectionDecoder = new Decoder_1.Decoder(reflection);
+    reflectionDecoder.decode(bytes, it);
+    const typeContext = new TypeContext_1.TypeContext();
+    // 1st pass, initialize metadata + inheritance
+    reflection.types.forEach((reflectionType) => {
+        const parentClass = typeContext.get(reflectionType.extendsId) ?? Schema_1.Schema;
+        const schema = class _ extends parentClass {
+        };
+        // register for inheritance support
+        TypeContext_1.TypeContext.register(schema);
+        typeContext.add(schema, reflectionType.id);
+    }, {});
+    // define fields
+    const addFields = (metadata, reflectionType, parentFieldIndex) => {
+        reflectionType.fields.forEach((field, i) => {
+            const fieldIndex = parentFieldIndex + i;
+            if (field.referencedType !== undefined) {
+                let fieldType = field.type;
+                let refType = typeContext.get(field.referencedType);
+                // map or array of primitive type (-1)
+                if (!refType) {
+                    const typeInfo = field.type.split(":");
+                    fieldType = typeInfo[0];
+                    refType = typeInfo[1]; // string
+                }
+                if (fieldType === "ref") {
+                    Metadata_1.Metadata.addField(metadata, fieldIndex, field.name, refType);
                 }
                 else {
-                    Metadata_1.Metadata.addField(metadata, fieldIndex, field.name, field.type);
+                    Metadata_1.Metadata.addField(metadata, fieldIndex, field.name, { [fieldType]: refType });
                 }
-            });
-        };
-        // 2nd pass, set fields
-        reflection.types.forEach((reflectionType) => {
-            const schema = typeContext.get(reflectionType.id);
-            // for inheritance support
-            const metadata = Metadata_1.Metadata.initialize(schema);
-            const inheritedTypes = [];
-            let parentType = reflectionType;
-            do {
-                inheritedTypes.push(parentType);
-                parentType = reflection.types.find((t) => t.id === parentType.extendsId);
-            } while (parentType);
-            let parentFieldIndex = 0;
-            inheritedTypes.reverse().forEach((reflectionType) => {
-                // add fields from all inherited classes
-                // TODO: refactor this to avoid adding fields from parent classes
-                addFields(metadata, reflectionType, parentFieldIndex);
-                parentFieldIndex += reflectionType.fields.length;
-            });
+            }
+            else {
+                Metadata_1.Metadata.addField(metadata, fieldIndex, field.name, field.type);
+            }
         });
-        const state = new (typeContext.get(reflection.rootType || 0))();
-        return new Decoder_1.Decoder(state, typeContext);
-    }
-}
-exports.Reflection = Reflection;
-__decorate([
-    (0, annotations_1.type)([ReflectionType])
-], Reflection.prototype, "types", void 0);
-__decorate([
-    (0, annotations_1.type)("number")
-], Reflection.prototype, "rootType", void 0);
+    };
+    // 2nd pass, set fields
+    reflection.types.forEach((reflectionType) => {
+        const schema = typeContext.get(reflectionType.id);
+        // for inheritance support
+        const metadata = Metadata_1.Metadata.initialize(schema);
+        const inheritedTypes = [];
+        let parentType = reflectionType;
+        do {
+            inheritedTypes.push(parentType);
+            parentType = reflection.types.find((t) => t.id === parentType.extendsId);
+        } while (parentType);
+        let parentFieldIndex = 0;
+        inheritedTypes.reverse().forEach((reflectionType) => {
+            // add fields from all inherited classes
+            // TODO: refactor this to avoid adding fields from parent classes
+            addFields(metadata, reflectionType, parentFieldIndex);
+            parentFieldIndex += reflectionType.fields.length;
+        });
+    });
+    const state = new (typeContext.get(reflection.rootType || 0))();
+    return new Decoder_1.Decoder(state, typeContext);
+};
 //# sourceMappingURL=Reflection.js.map

package/lib/Reflection.js.map

@@ -1 +1 @@
-{"version":3,"file":"Reflection.js","sourceRoot":"","sources":["../src/Reflection.ts"],"names":[],"mappings":"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","sourcesContent":["import { type, PrimitiveType } from \"./annotations\";\nimport { TypeContext } from \"./types/TypeContext\";\nimport { Metadata } from \"./Metadata\";\nimport { ArraySchema } from \"./types/custom/ArraySchema\";\nimport { Iterator } from \"./encoding/decode\";\nimport { Encoder } from \"./encoder/Encoder\";\nimport { Decoder } from \"./decoder/Decoder\";\nimport { Schema } from \"./Schema\";\n\n/**\n * Reflection\n */\nexport class ReflectionField extends Schema {\n    @type(\"string\") name: string;\n    @type(\"string\") type: string;\n    @type(\"number\") referencedType: number;\n}\n\nexport class ReflectionType extends Schema {\n    @type(\"number\") id: number;\n    @type(\"number\") extendsId: number;\n    @type([ ReflectionField ]) fields = new ArraySchema<ReflectionField>();\n}\n\nexport class Reflection extends Schema {\n    @type([ReflectionType]) types: ArraySchema<ReflectionType> = new ArraySchema<ReflectionType>();\n    @type(\"number\") rootType: number;\n\n    /**\n     * Encodes the TypeContext of an Encoder into a buffer.\n     *\n     * @param encoder Encoder instance\n     * @param it\n     * @returns\n     */\n    static encode(encoder: Encoder, it: Iterator = { offset: 0 }) {\n        const context = encoder.context;\n\n        const reflection = new Reflection();\n        const reflectionEncoder = new Encoder(reflection);\n\n        // rootType is usually the first schema passed to the Encoder\n        // (unless it inherits from another schema)\n        const rootType = context.schemas.get(encoder.state.constructor);\n        if (rootType > 0) { reflection.rootType = rootType; }\n\n        const includedTypeIds = new Set<number>();\n        const pendingReflectionTypes: { [typeid: number]: ReflectionType[] } = {};\n\n        // add type to reflection in a way that respects inheritance\n        // (parent types should be added before their children)\n        const addType = (type: ReflectionType) => {\n            if (type.extendsId === undefined || includedTypeIds.has(type.extendsId)) {\n                includedTypeIds.add(type.id);\n\n                reflection.types.push(type);\n\n                const deps = pendingReflectionTypes[type.id];\n                if (deps !== undefined) {\n                    delete pendingReflectionTypes[type.id];\n                    deps.forEach((childType) => addType(childType));\n                }\n            } else {\n                if (pendingReflectionTypes[type.extendsId] === undefined) {\n                    pendingReflectionTypes[type.extendsId] = [];\n                }\n                pendingReflectionTypes[type.extendsId].push(type);\n            }\n        };\n\n        context.schemas.forEach((typeid, klass) => {\n            const type = new ReflectionType();\n            type.id = Number(typeid);\n\n            // support inheritance\n            const inheritFrom = Object.getPrototypeOf(klass);\n            if (inheritFrom !== Schema) {\n                type.extendsId = context.schemas.get(inheritFrom);\n            }\n\n            const metadata = klass[Symbol.metadata];\n\n            //\n            // FIXME: this is a workaround for inherited types without additional fields\n            // if metadata is the same reference as the parent class - it means the class has no own metadata\n            //\n            if (metadata !== inheritFrom[Symbol.metadata]) {\n                for (const fieldIndex in metadata) {\n                    const index = Number(fieldIndex);\n                    const fieldName = metadata[index].name;\n\n                    // skip fields from parent classes\n                    if (!Object.prototype.hasOwnProperty.call(metadata, fieldName)) {\n                        continue;\n                    }\n\n                    const reflectionField = new ReflectionField();\n                    reflectionField.name = fieldName;\n\n                    let fieldType: string;\n\n                    const field = metadata[index];\n\n                    if (typeof (field.type) === \"string\") {\n                        fieldType = field.type;\n\n                    } else {\n                        let childTypeSchema: typeof Schema;\n\n                        //\n                        // TODO: refactor below.\n                        //\n                        if (Schema.is(field.type)) {\n                            fieldType = \"ref\";\n                            childTypeSchema = field.type as typeof Schema;\n\n                        } else {\n                            fieldType = Object.keys(field.type)[0];\n\n                            if (typeof (field.type[fieldType as keyof typeof field.type]) === \"string\") {\n                                fieldType += \":\" + field.type[fieldType as keyof typeof field.type]; // array:string\n\n                            } else {\n                                childTypeSchema = field.type[fieldType as keyof typeof field.type];\n                            }\n                        }\n\n                        reflectionField.referencedType = (childTypeSchema)\n                            ? context.getTypeId(childTypeSchema)\n                            : -1;\n                    }\n\n                    reflectionField.type = fieldType;\n                    type.fields.push(reflectionField);\n                }\n            }\n\n            addType(type);\n        });\n\n        // in case there are types that were not added due to inheritance\n        for (const typeid in pendingReflectionTypes) {\n            pendingReflectionTypes[typeid].forEach((type) =>\n                reflection.types.push(type))\n        }\n\n        const buf = reflectionEncoder.encodeAll(it);\n        return buf.slice(0, it.offset)\n        // return Buffer.from(buf, 0, it.offset);\n    }\n\n    /**\n     * Decodes the TypeContext from a buffer into a Decoder instance.\n     *\n     * @param bytes Reflection.encode() output\n     * @param it\n     * @returns Decoder instance\n     */\n    static decode<T extends Schema = Schema>(bytes: Buffer, it?: Iterator): Decoder<T> {\n        const reflection = new Reflection();\n\n        const reflectionDecoder = new Decoder(reflection);\n        reflectionDecoder.decode(bytes, it);\n\n        const typeContext = new TypeContext();\n\n        // 1st pass, initialize metadata + inheritance\n        reflection.types.forEach((reflectionType) => {\n            const parentClass: typeof Schema = typeContext.get(reflectionType.extendsId) ?? Schema;\n            const schema: typeof Schema = class _ extends parentClass {};\n\n            // register for inheritance support\n            TypeContext.register(schema);\n\n            // // for inheritance support\n            // Metadata.initialize(schema);\n\n            typeContext.add(schema, reflectionType.id);\n        }, {});\n\n        // define fields\n        const addFields = (metadata: Metadata, reflectionType: ReflectionType, parentFieldIndex: number) => {\n            reflectionType.fields.forEach((field, i) => {\n                const fieldIndex = parentFieldIndex + i;\n\n                if (field.referencedType !== undefined) {\n                    let fieldType = field.type;\n                    let refType: PrimitiveType = typeContext.get(field.referencedType);\n\n                    // map or array of primitive type (-1)\n                    if (!refType) {\n                        const typeInfo = field.type.split(\":\");\n                        fieldType = typeInfo[0];\n                        refType = typeInfo[1] as PrimitiveType; // string\n                    }\n\n                    if (fieldType === \"ref\") {\n                        Metadata.addField(metadata, fieldIndex, field.name, refType);\n\n                    } else {\n                        Metadata.addField(metadata, fieldIndex, field.name, { [fieldType]: refType });\n                    }\n\n                } else {\n                    Metadata.addField(metadata, fieldIndex, field.name, field.type as PrimitiveType);\n                }\n            });\n        };\n\n        // 2nd pass, set fields\n        reflection.types.forEach((reflectionType) => {\n            const schema = typeContext.get(reflectionType.id);\n\n            // for inheritance support\n            const metadata = Metadata.initialize(schema);\n\n            const inheritedTypes: ReflectionType[] = [];\n\n            let parentType: ReflectionType = reflectionType;\n            do {\n                inheritedTypes.push(parentType);\n                parentType = reflection.types.find((t) => t.id === parentType.extendsId);\n            } while (parentType);\n\n            let parentFieldIndex = 0;\n\n            inheritedTypes.reverse().forEach((reflectionType) => {\n                // add fields from all inherited classes\n                // TODO: refactor this to avoid adding fields from parent classes\n                addFields(metadata, reflectionType, parentFieldIndex);\n                parentFieldIndex += reflectionType.fields.length;\n            });\n        });\n\n        const state: T = new (typeContext.get(reflection.rootType || 0) as unknown as any)();\n\n        return new Decoder<T>(state, typeContext);\n    }\n}\n"]}
+{"version":3,"file":"Reflection.js","sourceRoot":"","sources":["../src/Reflection.ts"],"names":[],"mappings":"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","sourcesContent":["import { PrimitiveType, schema, SchemaType } from \"./annotations\";\nimport { TypeContext } from \"./types/TypeContext\";\nimport { Metadata } from \"./Metadata\";\nimport { Iterator } from \"./encoding/decode\";\nimport { Encoder } from \"./encoder/Encoder\";\nimport { Decoder } from \"./decoder/Decoder\";\nimport { Schema } from \"./Schema\";\n\n/**\n * Static methods available on Reflection\n */\ninterface ReflectionStatic {\n    /**\n     * Encodes the TypeContext of an Encoder into a buffer.\n     *\n     * @param encoder Encoder instance\n     * @param it\n     * @returns\n     */\n    encode: (encoder: Encoder, it?: Iterator) => Uint8Array;\n\n    /**\n     * Decodes the TypeContext from a buffer into a Decoder instance.\n     *\n     * @param bytes Reflection.encode() output\n     * @param it\n     * @returns Decoder instance\n     */\n    decode: <T extends Schema = Schema>(bytes: Uint8Array, it?: Iterator) => Decoder<T>;\n}\n\n/**\n * Reflection\n */\nexport const ReflectionField = schema({\n    name: \"string\",\n    type: \"string\",\n    referencedType: \"number\",\n})\nexport type ReflectionField = SchemaType<typeof ReflectionField>;\n\nexport const ReflectionType = schema({\n    id: \"number\",\n    extendsId: \"number\",\n    fields: [ ReflectionField ],\n})\nexport type ReflectionType = SchemaType<typeof ReflectionType>;\n\nexport const Reflection = schema({\n    types: [ ReflectionType ],\n    rootType: \"number\",\n}) as ReturnType<typeof schema<{\n    types: [typeof ReflectionType];\n    rootType: \"number\";\n}>> & ReflectionStatic;\n\nexport type Reflection = SchemaType<typeof Reflection>;\n\nReflection.encode = function (encoder: Encoder, it: Iterator = { offset: 0 }) {\n    const context = encoder.context;\n\n    const reflection = new Reflection();\n    const reflectionEncoder = new Encoder(reflection);\n\n    // rootType is usually the first schema passed to the Encoder\n    // (unless it inherits from another schema)\n    const rootType = context.schemas.get(encoder.state.constructor);\n    if (rootType > 0) { reflection.rootType = rootType; }\n\n    const includedTypeIds = new Set<number>();\n    const pendingReflectionTypes: { [typeid: number]: ReflectionType[] } = {};\n\n    // add type to reflection in a way that respects inheritance\n    // (parent types should be added before their children)\n    const addType = (type: ReflectionType) => {\n        if (type.extendsId === undefined || includedTypeIds.has(type.extendsId)) {\n            includedTypeIds.add(type.id);\n\n            reflection.types.push(type);\n\n            const deps = pendingReflectionTypes[type.id];\n            if (deps !== undefined) {\n                delete pendingReflectionTypes[type.id];\n                deps.forEach((childType) => addType(childType));\n            }\n        } else {\n            if (pendingReflectionTypes[type.extendsId] === undefined) {\n                pendingReflectionTypes[type.extendsId] = [];\n            }\n            pendingReflectionTypes[type.extendsId].push(type);\n        }\n    };\n\n    context.schemas.forEach((typeid, klass) => {\n        const type = new ReflectionType();\n        type.id = Number(typeid);\n\n        // support inheritance\n        const inheritFrom = Object.getPrototypeOf(klass);\n        if (inheritFrom !== Schema) {\n            type.extendsId = context.schemas.get(inheritFrom);\n        }\n\n        const metadata = klass[Symbol.metadata];\n\n        //\n        // FIXME: this is a workaround for inherited types without additional fields\n        // if metadata is the same reference as the parent class - it means the class has no own metadata\n        //\n        if (metadata !== inheritFrom[Symbol.metadata]) {\n            for (const fieldIndex in metadata) {\n                const index = Number(fieldIndex);\n                const fieldName = metadata[index].name;\n\n                // skip fields from parent classes\n                if (!Object.prototype.hasOwnProperty.call(metadata, fieldName)) {\n                    continue;\n                }\n\n                const reflectionField = new ReflectionField();\n                reflectionField.name = fieldName;\n\n                let fieldType: string;\n\n                const field = metadata[index];\n\n                if (typeof (field.type) === \"string\") {\n                    fieldType = field.type;\n\n                } else {\n                    let childTypeSchema: typeof Schema;\n\n                    //\n                    // TODO: refactor below.\n                    //\n                    if (Schema.is(field.type)) {\n                        fieldType = \"ref\";\n                        childTypeSchema = field.type as typeof Schema;\n\n                    } else {\n                        fieldType = Object.keys(field.type)[0];\n\n                        if (typeof (field.type[fieldType as keyof typeof field.type]) === \"string\") {\n                            fieldType += \":\" + field.type[fieldType as keyof typeof field.type]; // array:string\n\n                        } else {\n                            childTypeSchema = field.type[fieldType as keyof typeof field.type];\n                        }\n                    }\n\n                    reflectionField.referencedType = (childTypeSchema)\n                        ? context.getTypeId(childTypeSchema)\n                        : -1;\n                }\n\n                reflectionField.type = fieldType;\n                type.fields.push(reflectionField);\n            }\n        }\n\n        addType(type);\n    });\n\n    // in case there are types that were not added due to inheritance\n    for (const typeid in pendingReflectionTypes) {\n        pendingReflectionTypes[typeid].forEach((type) =>\n            reflection.types.push(type))\n    }\n\n    const buf = reflectionEncoder.encodeAll(it);\n    return buf.slice(0, it.offset);\n};\n\nReflection.decode = function <T extends Schema = Schema>(bytes: Uint8Array, it?: Iterator): Decoder<T> {\n    const reflection = new Reflection();\n\n    const reflectionDecoder = new Decoder(reflection);\n    reflectionDecoder.decode(bytes, it);\n\n    const typeContext = new TypeContext();\n\n    // 1st pass, initialize metadata + inheritance\n    reflection.types.forEach((reflectionType) => {\n        const parentClass: typeof Schema = typeContext.get(reflectionType.extendsId) ?? Schema;\n        const schema: typeof Schema = class _ extends parentClass { };\n\n        // register for inheritance support\n        TypeContext.register(schema);\n\n        typeContext.add(schema, reflectionType.id);\n    }, {});\n\n    // define fields\n    const addFields = (metadata: Metadata, reflectionType: ReflectionType, parentFieldIndex: number) => {\n        reflectionType.fields.forEach((field, i) => {\n            const fieldIndex = parentFieldIndex + i;\n\n            if (field.referencedType !== undefined) {\n                let fieldType = field.type;\n                let refType: PrimitiveType = typeContext.get(field.referencedType);\n\n                // map or array of primitive type (-1)\n                if (!refType) {\n                    const typeInfo = field.type.split(\":\");\n                    fieldType = typeInfo[0];\n                    refType = typeInfo[1] as PrimitiveType; // string\n                }\n\n                if (fieldType === \"ref\") {\n                    Metadata.addField(metadata, fieldIndex, field.name, refType);\n\n                } else {\n                    Metadata.addField(metadata, fieldIndex, field.name, { [fieldType]: refType });\n                }\n\n            } else {\n                Metadata.addField(metadata, fieldIndex, field.name, field.type as PrimitiveType);\n            }\n        });\n    };\n\n    // 2nd pass, set fields\n    reflection.types.forEach((reflectionType) => {\n        const schema = typeContext.get(reflectionType.id);\n\n        // for inheritance support\n        const metadata = Metadata.initialize(schema);\n\n        const inheritedTypes: ReflectionType[] = [];\n\n        let parentType: ReflectionType = reflectionType;\n        do {\n            inheritedTypes.push(parentType);\n            parentType = reflection.types.find((t) => t.id === parentType.extendsId);\n        } while (parentType);\n\n        let parentFieldIndex = 0;\n\n        inheritedTypes.reverse().forEach((reflectionType) => {\n            // add fields from all inherited classes\n            // TODO: refactor this to avoid adding fields from parent classes\n            addFields(metadata, reflectionType, parentFieldIndex);\n            parentFieldIndex += reflectionType.fields.length;\n        });\n    });\n\n    const state: T = new (typeContext.get(reflection.rootType || 0) as unknown as any)();\n\n    return new Decoder<T>(state, typeContext);\n}"]}

package/lib/Schema.d.ts

@@ -2,7 +2,7 @@ import { OPERATION } from './encoding/spec';
 import { type DefinitionType } from "./annotations";
 import { AssignableProps, NonFunctionPropNames, ToJSON } from './types/HelperTypes';
 import { ChangeSetName, ChangeTree, IRef, Ref } from './encoder/ChangeTree';
-import { $decoder, $deleteByIndex, $encoder, $filter, $getByIndex, $track } from './types/symbols';
+import { $decoder, $deleteByIndex, $encoder, $filter, $getByIndex, $refId, $track } from './types/symbols';
 import { StateView } from './encoder/StateView';
 import type { Decoder } from './decoder/Decoder';
 import type { Metadata } from './Metadata';
@@ -13,6 +13,7 @@ export declare class Schema<C = any> implements IRef {
     static [Symbol.metadata]: Metadata;
     static [$encoder]: import("./encoder/EncodeOperation").EncodeOperation<any>;
     static [$decoder]: import("./decoder/DecodeOperation").DecodeOperation<any>;
+    [$refId]?: number;
     /**
      * Assign the property descriptors required to track changes on this instance.
      * @param instance
@@ -34,7 +35,18 @@ export declare class Schema<C = any> implements IRef {
      */
     static [$filter](ref: Schema, index: number, view: StateView): boolean;
     constructor(arg?: C);
+    /**
+     * Assign properties to the instance.
+     * @param props Properties to assign to the instance
+     * @returns
+     */
     assign<T extends Partial<this>>(props: AssignableProps<T>): this;
+    /**
+     * Restore the instance from JSON data.
+     * @param jsonData JSON data to restore the instance from
+     * @returns
+     */
+    restore(jsonData: ToJSON<this>): this;
     /**
      * (Server-side): Flag a property to be encoded for the next patch.
      * @param instance Schema instance