@colyseus/schema 1.1.0-alpha.0 → 2.0.0

package/lib/types/CollectionSchema.d.ts

@@ -0,0 +1,35 @@
+import { ChangeTree } from "../changes/ChangeTree";
+import { SchemaDecoderCallbacks } from "../Schema";
+import { DataChange } from "..";
+declare type K = number;
+export declare class CollectionSchema<V = any> implements SchemaDecoderCallbacks {
+    protected $changes: ChangeTree;
+    protected $items: Map<number, V>;
+    protected $indexes: Map<number, number>;
+    protected $refId: number;
+    $callbacks: {
+        [operation: number]: Array<(item: V, key: string) => void>;
+    };
+    onAdd(callback: (item: V, key: string) => void, triggerAll?: boolean): () => boolean;
+    onRemove(callback: (item: V, key: string) => void): () => boolean;
+    onChange(callback: (item: V, key: string) => void): () => boolean;
+    static is(type: any): boolean;
+    constructor(initialValues?: Array<V>);
+    add(value: V): number;
+    at(index: number): V | undefined;
+    entries(): IterableIterator<[number, V]>;
+    delete(item: V): boolean;
+    clear(changes?: DataChange[]): void;
+    has(value: V): boolean;
+    forEach(callbackfn: (value: V, key: K, collection: CollectionSchema<V>) => void): void;
+    values(): IterableIterator<V>;
+    get size(): number;
+    protected setIndex(index: number, key: number): void;
+    protected getIndex(index: number): number;
+    protected getByIndex(index: number): V;
+    protected deleteByIndex(index: number): void;
+    toArray(): V[];
+    toJSON(): V[];
+    clone(isDecoding?: boolean): CollectionSchema<V>;
+}
+export {};

package/lib/types/CollectionSchema.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectionSchema = void 0;
+var ChangeTree_1 = require("../changes/ChangeTree");
+var spec_1 = require("../spec");
+var utils_1 = require("./utils");
+var CollectionSchema = /** @class */ (function () {
+    function CollectionSchema(initialValues) {
+        var _this = this;
+        this.$changes = new ChangeTree_1.ChangeTree(this);
+        this.$items = new Map();
+        this.$indexes = new Map();
+        this.$refId = 0;
+        if (initialValues) {
+            initialValues.forEach(function (v) { return _this.add(v); });
+        }
+    }
+    CollectionSchema.prototype.onAdd = function (callback, triggerAll) {
+        if (triggerAll === void 0) { triggerAll = true; }
+        return utils_1.addCallback((this.$callbacks || (this.$callbacks = [])), spec_1.OPERATION.ADD, callback, (triggerAll)
+            ? this.$items
+            : undefined);
+    };
+    CollectionSchema.prototype.onRemove = function (callback) { return utils_1.addCallback(this.$callbacks || (this.$callbacks = []), spec_1.OPERATION.DELETE, callback); };
+    CollectionSchema.prototype.onChange = function (callback) { return utils_1.addCallback(this.$callbacks || (this.$callbacks = []), spec_1.OPERATION.REPLACE, callback); };
+    CollectionSchema.is = function (type) {
+        return type['collection'] !== undefined;
+    };
+    CollectionSchema.prototype.add = function (value) {
+        // set "index" for reference.
+        var index = this.$refId++;
+        var isRef = (value['$changes']) !== undefined;
+        if (isRef) {
+            value['$changes'].setParent(this, this.$changes.root, index);
+        }
+        this.$changes.indexes[index] = index;
+        this.$indexes.set(index, index);
+        this.$items.set(index, value);
+        this.$changes.change(index);
+        return index;
+    };
+    CollectionSchema.prototype.at = function (index) {
+        var key = Array.from(this.$items.keys())[index];
+        return this.$items.get(key);
+    };
+    CollectionSchema.prototype.entries = function () {
+        return this.$items.entries();
+    };
+    CollectionSchema.prototype.delete = function (item) {
+        var entries = this.$items.entries();
+        var index;
+        var entry;
+        while (entry = entries.next()) {
+            if (entry.done) {
+                break;
+            }
+            if (item === entry.value[1]) {
+                index = entry.value[0];
+                break;
+            }
+        }
+        if (index === undefined) {
+            return false;
+        }
+        this.$changes.delete(index);
+        this.$indexes.delete(index);
+        return this.$items.delete(index);
+    };
+    CollectionSchema.prototype.clear = function (changes) {
+        // discard previous operations.
+        this.$changes.discard(true, true);
+        this.$changes.indexes = {};
+        // clear previous indexes
+        this.$indexes.clear();
+        //
+        // When decoding:
+        // - enqueue items for DELETE callback.
+        // - flag child items for garbage collection.
+        //
+        if (changes) {
+            utils_1.removeChildRefs.call(this, changes);
+        }
+        // clear items
+        this.$items.clear();
+        this.$changes.operation({ index: 0, op: spec_1.OPERATION.CLEAR });
+        // touch all structures until reach root
+        this.$changes.touchParents();
+    };
+    CollectionSchema.prototype.has = function (value) {
+        return Array.from(this.$items.values()).some(function (v) { return v === value; });
+    };
+    CollectionSchema.prototype.forEach = function (callbackfn) {
+        var _this = this;
+        this.$items.forEach(function (value, key, _) { return callbackfn(value, key, _this); });
+    };
+    CollectionSchema.prototype.values = function () {
+        return this.$items.values();
+    };
+    Object.defineProperty(CollectionSchema.prototype, "size", {
+        get: function () {
+            return this.$items.size;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    CollectionSchema.prototype.setIndex = function (index, key) {
+        this.$indexes.set(index, key);
+    };
+    CollectionSchema.prototype.getIndex = function (index) {
+        return this.$indexes.get(index);
+    };
+    CollectionSchema.prototype.getByIndex = function (index) {
+        return this.$items.get(this.$indexes.get(index));
+    };
+    CollectionSchema.prototype.deleteByIndex = function (index) {
+        var key = this.$indexes.get(index);
+        this.$items.delete(key);
+        this.$indexes.delete(index);
+    };
+    CollectionSchema.prototype.toArray = function () {
+        return Array.from(this.$items.values());
+    };
+    CollectionSchema.prototype.toJSON = function () {
+        var values = [];
+        this.forEach(function (value, key) {
+            values.push((typeof (value['toJSON']) === "function")
+                ? value['toJSON']()
+                : value);
+        });
+        return values;
+    };
+    //
+    // Decoding utilities
+    //
+    CollectionSchema.prototype.clone = function (isDecoding) {
+        var cloned;
+        if (isDecoding) {
+            // client-side
+            cloned = Object.assign(new CollectionSchema(), this);
+        }
+        else {
+            // server-side
+            cloned = new CollectionSchema();
+            this.forEach(function (value) {
+                if (value['$changes']) {
+                    cloned.add(value['clone']());
+                }
+                else {
+                    cloned.add(value);
+                }
+            });
+        }
+        return cloned;
+    };
+    return CollectionSchema;
+}());
+exports.CollectionSchema = CollectionSchema;
+//# sourceMappingURL=CollectionSchema.js.map

package/lib/types/CollectionSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollectionSchema.js","sourceRoot":"","sources":["../../src/types/CollectionSchema.ts"],"names":[],"mappings":";;;AAAA,oDAAmD;AACnD,gCAAoC;AAEpC,iCAAuD;AAKvD;IA6BI,0BAAa,aAAwB;QAArC,iBAIC;QAhCS,aAAQ,GAAe,IAAI,uBAAU,CAAC,IAAI,CAAC,CAAC;QAE5C,WAAM,GAAmB,IAAI,GAAG,EAAa,CAAC;QAC9C,aAAQ,GAAwB,IAAI,GAAG,EAAkB,CAAC;QAE1D,WAAM,GAAW,CAAC,CAAC;QAwBzB,IAAI,aAAa,EAAE;YACf,aAAa,CAAC,OAAO,CAAC,UAAC,CAAC,IAAK,OAAA,KAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAX,CAAW,CAAC,CAAC;SAC7C;IACL,CAAC;IArBM,gCAAK,GAAZ,UAAa,QAAwC,EAAE,UAA0B;QAA1B,2BAAA,EAAA,iBAA0B;QAC7E,OAAO,mBAAW,CACd,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC,EAC3C,gBAAS,CAAC,GAAG,EACb,QAAQ,EACR,CAAC,UAAU,CAAC;YACR,CAAC,CAAC,IAAI,CAAC,MAAM;YACb,CAAC,CAAC,SAAS,CAClB,CAAC;IACN,CAAC;IACM,mCAAQ,GAAf,UAAgB,QAAwC,IAAI,OAAO,mBAAW,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,EAAE,gBAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACjJ,mCAAQ,GAAf,UAAgB,QAAwC,IAAI,OAAO,mBAAW,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,EAAE,gBAAS,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAElJ,mBAAE,GAAT,UAAU,IAAS;QACf,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,SAAS,CAAC;IAC5C,CAAC;IAQD,8BAAG,GAAH,UAAI,KAAQ;QACR,6BAA6B;QAC7B,IAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAE5B,IAAM,KAAK,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,SAAS,CAAC;QAChD,IAAI,KAAK,EAAE;YACN,KAAK,CAAC,UAAU,CAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;SAChF;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QAErC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE9B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,6BAAE,GAAF,UAAG,KAAa;QACZ,IAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,kCAAO,GAAP;QACI,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,iCAAM,GAAN,UAAO,IAAO;QACV,IAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAEtC,IAAI,KAAQ,CAAC;QACb,IAAI,KAAkC,CAAC;QACvC,OAAO,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE;YAC3B,IAAI,KAAK,CAAC,IAAI,EAAE;gBAAE,MAAM;aAAE;YAE1B,IAAI,IAAI,KAAK,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;gBACzB,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM;aACT;SACJ;QAED,IAAI,KAAK,KAAK,SAAS,EAAE;YACrB,OAAO,KAAK,CAAC;SAChB;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAE5B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,gCAAK,GAAL,UAAM,OAAsB;QACxB,+BAA+B;QAC/B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,QAAQ,CAAC,OAAO,GAAG,EAAE,CAAC;QAE3B,yBAAyB;QACzB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QAEtB,EAAE;QACF,iBAAiB;QACjB,uCAAuC;QACvC,6CAA6C;QAC7C,EAAE;QACF,IAAI,OAAO,EAAE;YACT,uBAAe,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SACvC;QAED,cAAc;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAEpB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,gBAAS,CAAC,KAAK,EAAE,CAAC,CAAC;QAE3D,wCAAwC;QACxC,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;IACjC,CAAC;IAED,8BAAG,GAAH,UAAK,KAAQ;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,UAAC,CAAC,IAAK,OAAA,CAAC,KAAK,KAAK,EAAX,CAAW,CAAC,CAAC;IACrE,CAAC;IAED,kCAAO,GAAP,UAAQ,UAAuE;QAA/E,iBAEC;QADG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAC,KAAK,EAAE,GAAG,EAAE,CAAC,IAAK,OAAA,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,KAAI,CAAC,EAA5B,CAA4B,CAAC,CAAC;IACzE,CAAC;IAED,iCAAM,GAAN;QACI,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IAChC,CAAC;IAED,sBAAI,kCAAI;aAAR;YACI,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,CAAC;;;OAAA;IAES,mCAAQ,GAAlB,UAAmB,KAAa,EAAE,GAAW;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAClC,CAAC;IAES,mCAAQ,GAAlB,UAAmB,KAAa;QAC5B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAES,qCAAU,GAApB,UAAqB,KAAa;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,CAAC;IAES,wCAAa,GAAvB,UAAwB,KAAa;QACjC,IAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,kCAAO,GAAP;QACI,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,iCAAM,GAAN;QACI,IAAM,MAAM,GAAQ,EAAE,CAAC;QAEvB,IAAI,CAAC,OAAO,CAAC,UAAC,KAAK,EAAE,GAAG;YACpB,MAAM,CAAC,IAAI,CACP,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,UAAU,CAAC;gBACrC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE;gBACnB,CAAC,CAAC,KAAK,CACd,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,EAAE;IACF,qBAAqB;IACrB,EAAE;IACF,gCAAK,GAAL,UAAM,UAAoB;QACtB,IAAI,MAAwB,CAAC;QAE7B,IAAI,UAAU,EAAE;YACZ,cAAc;YACd,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,gBAAgB,EAAE,EAAE,IAAI,CAAC,CAAC;SAExD;aAAM;YACH,cAAc;YACd,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,UAAC,KAAK;gBACf,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE;oBACnB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;iBAChC;qBAAM;oBACH,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;iBACrB;YACL,CAAC,CAAC,CAAA;SACL;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAEL,uBAAC;AAAD,CAAC,AA9LD,IA8LC;AA9LY,4CAAgB","sourcesContent":["import { ChangeTree } from \"../changes/ChangeTree\";\nimport { OPERATION } from \"../spec\";\nimport { SchemaDecoderCallbacks } from \"../Schema\";\nimport { addCallback, removeChildRefs } from \"./utils\";\nimport { DataChange } from \"..\";\n\ntype K = number; // TODO: allow to specify K generic on MapSchema.\n\nexport class CollectionSchema<V=any> implements SchemaDecoderCallbacks {\n    protected $changes: ChangeTree = new ChangeTree(this);\n\n    protected $items: Map<number, V> = new Map<number, V>();\n    protected $indexes: Map<number, number> = new Map<number, number>();\n\n    protected $refId: number = 0;\n\n    //\n    // Decoding callbacks\n    //\n    public $callbacks: { [operation: number]: Array<(item: V, key: string) => void> };\n    public onAdd(callback: (item: V, key: string) => void, triggerAll: boolean = true) {\n        return addCallback(\n            (this.$callbacks || (this.$callbacks = [])),\n            OPERATION.ADD,\n            callback,\n            (triggerAll)\n                ? this.$items\n                : undefined\n        );\n    }\n    public onRemove(callback: (item: V, key: string) => void) { return addCallback(this.$callbacks || (this.$callbacks = []), OPERATION.DELETE, callback); }\n    public onChange(callback: (item: V, key: string) => void) { return addCallback(this.$callbacks || (this.$callbacks = []), OPERATION.REPLACE, callback); }\n\n    static is(type: any) {\n        return type['collection'] !== undefined;\n    }\n\n    constructor (initialValues?: Array<V>) {\n        if (initialValues) {\n            initialValues.forEach((v) => this.add(v));\n        }\n    }\n\n    add(value: V) {\n        // set \"index\" for reference.\n        const index = this.$refId++;\n\n        const isRef = (value['$changes']) !== undefined;\n        if (isRef) {\n            (value['$changes'] as ChangeTree).setParent(this, this.$changes.root, index);\n        }\n\n        this.$changes.indexes[index] = index;\n\n        this.$indexes.set(index, index);\n        this.$items.set(index, value);\n\n        this.$changes.change(index);\n\n        return index;\n    }\n\n    at(index: number): V | undefined {\n        const key = Array.from(this.$items.keys())[index];\n        return this.$items.get(key);\n    }\n\n    entries() {\n        return this.$items.entries();\n    }\n\n    delete(item: V) {\n        const entries = this.$items.entries();\n\n        let index: K;\n        let entry: IteratorResult<[number, V]>;\n        while (entry = entries.next()) {\n            if (entry.done) { break; }\n\n            if (item === entry.value[1]) {\n                index = entry.value[0];\n                break;\n            }\n        }\n\n        if (index === undefined) {\n            return false;\n        }\n\n        this.$changes.delete(index);\n        this.$indexes.delete(index);\n\n        return this.$items.delete(index);\n    }\n\n    clear(changes?: DataChange[]) {\n        // discard previous operations.\n        this.$changes.discard(true, true);\n        this.$changes.indexes = {};\n\n        // clear previous indexes\n        this.$indexes.clear();\n\n        //\n        // When decoding:\n        // - enqueue items for DELETE callback.\n        // - flag child items for garbage collection.\n        //\n        if (changes) {\n            removeChildRefs.call(this, changes);\n        }\n\n        // clear items\n        this.$items.clear();\n\n        this.$changes.operation({ index: 0, op: OPERATION.CLEAR });\n\n        // touch all structures until reach root\n        this.$changes.touchParents();\n    }\n\n    has (value: V): boolean {\n        return Array.from(this.$items.values()).some((v) => v === value);\n    }\n\n    forEach(callbackfn: (value: V, key: K, collection: CollectionSchema<V>) => void) {\n        this.$items.forEach((value, key, _) => callbackfn(value, key, this));\n    }\n\n    values() {\n        return this.$items.values();\n    }\n\n    get size () {\n        return this.$items.size;\n    }\n\n    protected setIndex(index: number, key: number) {\n        this.$indexes.set(index, key);\n    }\n\n    protected getIndex(index: number) {\n        return this.$indexes.get(index);\n    }\n\n    protected getByIndex(index: number) {\n        return this.$items.get(this.$indexes.get(index));\n    }\n\n    protected deleteByIndex(index: number) {\n        const key = this.$indexes.get(index);\n        this.$items.delete(key);\n        this.$indexes.delete(index);\n    }\n\n    toArray() {\n        return Array.from(this.$items.values());\n    }\n\n    toJSON() {\n        const values: V[] = [];\n\n        this.forEach((value, key) => {\n            values.push(\n                (typeof (value['toJSON']) === \"function\")\n                    ? value['toJSON']()\n                    : value\n            );\n        });\n\n        return values;\n    }\n\n    //\n    // Decoding utilities\n    //\n    clone(isDecoding?: boolean): CollectionSchema<V> {\n        let cloned: CollectionSchema;\n\n        if (isDecoding) {\n            // client-side\n            cloned = Object.assign(new CollectionSchema(), this);\n\n        } else {\n            // server-side\n            cloned = new CollectionSchema();\n            this.forEach((value) => {\n                if (value['$changes']) {\n                    cloned.add(value['clone']());\n                } else {\n                    cloned.add(value);\n                }\n            })\n        }\n\n        return cloned;\n    }\n\n}\n"]}

package/lib/types/HelperTypes.d.ts

@@ -0,0 +1,28 @@
+declare type Bool = 'true' | 'false';
+declare type Key = string | number | symbol;
+declare type Not<X extends Bool> = {
+    true: 'false';
+    false: 'true';
+}[X];
+declare type HaveIntersection<S1 extends string, S2 extends string> = ({
+    [K in S1]: 'true';
+} & {
+    [key: string]: 'false';
+})[S2];
+declare type IsNeverWorker<S extends Key> = ({
+    [K in S]: 'false';
+} & {
+    [key: string]: 'true';
+})[S];
+declare type IsNever<T extends Key> = Not<HaveIntersection<IsNeverWorker<T>, 'false'>>;
+declare type IsFunction<T> = IsNever<keyof T>;
+export declare type NonFunctionProps<T> = {
+    [K in keyof T]: {
+        'false': K;
+        'true': never;
+    }[IsFunction<T[K]>];
+}[keyof T];
+export declare type NonFunctionPropNames<T> = {
+    [K in keyof T]: T[K] extends Function ? never : K;
+}[keyof T];
+export {};

package/lib/types/HelperTypes.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=HelperTypes.js.map

package/lib/types/HelperTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HelperTypes.js","sourceRoot":"","sources":["../../src/types/HelperTypes.ts"],"names":[],"mappings":"","sourcesContent":["type Bool = 'true' | 'false'\ntype Key = string | number | symbol;\n\ntype Not<X extends Bool> = {\n    true: 'false',\n    false: 'true'\n}[X]\n\ntype HaveIntersection<S1 extends string, S2 extends string> = (\n    { [K in S1]: 'true' } &\n    { [key: string]: 'false' }\n)[S2]\n\ntype IsNeverWorker<S extends Key> = (\n    { [K in S]: 'false' } &\n    { [key: string]: 'true' }\n)[S]\n\n// Worker needed because of https://github.com/Microsoft/TypeScript/issues/18118\ntype IsNever<T extends Key> = Not<HaveIntersection<IsNeverWorker<T>, 'false'>>\n\ntype IsFunction<T> = IsNever<keyof T>\n\nexport type NonFunctionProps<T> = {\n    [K in keyof T]: {\n        'false': K,\n        'true': never\n    }[IsFunction<T[K]>]\n}[keyof T];\n\nexport type NonFunctionPropNames<T> = {\n    [K in keyof T]: T[K] extends Function ? never : K\n}[keyof T];\n\n"]}

package/lib/types/MapSchema.d.ts

@@ -0,0 +1,37 @@
+import { ChangeTree } from "../changes/ChangeTree";
+import { SchemaDecoderCallbacks } from "../Schema";
+import { DataChange } from "..";
+export declare function getMapProxy(value: MapSchema): MapSchema<any>;
+export declare class MapSchema<V = any> implements Map<string, V>, SchemaDecoderCallbacks {
+    protected $changes: ChangeTree;
+    protected $items: Map<string, V>;
+    protected $indexes: Map<number, string>;
+    protected $refId: number;
+    $callbacks: {
+        [operation: number]: Array<(item: V, key: string) => void>;
+    };
+    onAdd(callback: (item: V, key: string) => void, triggerAll?: boolean): () => boolean;
+    onRemove(callback: (item: V, key: string) => void): () => boolean;
+    onChange(callback: (item: V, key: string) => void): () => boolean;
+    static is(type: any): boolean;
+    constructor(initialValues?: Map<string, V> | any);
+    /** Iterator */
+    [Symbol.iterator](): IterableIterator<[string, V]>;
+    get [Symbol.toStringTag](): string;
+    set(key: string, value: V): this;
+    get(key: string): V | undefined;
+    delete(key: string): boolean;
+    clear(changes?: DataChange[]): void;
+    has(key: string): boolean;
+    forEach(callbackfn: (value: V, key: string, map: Map<string, V>) => void): void;
+    entries(): IterableIterator<[string, V]>;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<V>;
+    get size(): number;
+    protected setIndex(index: number, key: string): void;
+    protected getIndex(index: number): string;
+    protected getByIndex(index: number): V;
+    protected deleteByIndex(index: number): void;
+    toJSON(): any;
+    clone(isDecoding?: boolean): MapSchema<V>;
+}

package/lib/types/MapSchema.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapSchema = exports.getMapProxy = void 0;
+var ChangeTree_1 = require("../changes/ChangeTree");
+var spec_1 = require("../spec");
+var utils_1 = require("./utils");
+function getMapProxy(value) {
+    value['$proxy'] = true;
+    value = new Proxy(value, {
+        get: function (obj, prop) {
+            if (typeof (prop) !== "symbol" && // accessing properties
+                typeof (obj[prop]) === "undefined") {
+                return obj.get(prop);
+            }
+            else {
+                return obj[prop];
+            }
+        },
+        set: function (obj, prop, setValue) {
+            if (typeof (prop) !== "symbol" &&
+                (prop.indexOf("$") === -1 &&
+                    prop !== "onAdd" &&
+                    prop !== "onRemove" &&
+                    prop !== "onChange")) {
+                obj.set(prop, setValue);
+            }
+            else {
+                obj[prop] = setValue;
+            }
+            return true;
+        },
+        deleteProperty: function (obj, prop) {
+            obj.delete(prop);
+            return true;
+        },
+    });
+    return value;
+}
+exports.getMapProxy = getMapProxy;
+var MapSchema = /** @class */ (function () {
+    function MapSchema(initialValues) {
+        var _this = this;
+        this.$changes = new ChangeTree_1.ChangeTree(this);
+        this.$items = new Map();
+        this.$indexes = new Map();
+        this.$refId = 0;
+        if (initialValues) {
+            if (initialValues instanceof Map) {
+                initialValues.forEach(function (v, k) { return _this.set(k, v); });
+            }
+            else {
+                for (var k in initialValues) {
+                    this.set(k, initialValues[k]);
+                }
+            }
+        }
+    }
+    MapSchema.prototype.onAdd = function (callback, triggerAll) {
+        if (triggerAll === void 0) { triggerAll = true; }
+        return utils_1.addCallback((this.$callbacks || (this.$callbacks = [])), spec_1.OPERATION.ADD, callback, (triggerAll)
+            ? this.$items
+            : undefined);
+    };
+    MapSchema.prototype.onRemove = function (callback) { return utils_1.addCallback(this.$callbacks || (this.$callbacks = []), spec_1.OPERATION.DELETE, callback); };
+    MapSchema.prototype.onChange = function (callback) { return utils_1.addCallback(this.$callbacks || (this.$callbacks = []), spec_1.OPERATION.REPLACE, callback); };
+    MapSchema.is = function (type) {
+        return type['map'] !== undefined;
+    };
+    /** Iterator */
+    MapSchema.prototype[Symbol.iterator] = function () { return this.$items[Symbol.iterator](); };
+    Object.defineProperty(MapSchema.prototype, Symbol.toStringTag, {
+        get: function () { return this.$items[Symbol.toStringTag]; },
+        enumerable: false,
+        configurable: true
+    });
+    MapSchema.prototype.set = function (key, value) {
+        if (value === undefined || value === null) {
+            throw new Error("MapSchema#set('" + key + "', " + value + "): trying to set " + value + " value on '" + key + "'.");
+        }
+        // get "index" for this value.
+        var hasIndex = typeof (this.$changes.indexes[key]) !== "undefined";
+        var index = (hasIndex)
+            ? this.$changes.indexes[key]
+            : this.$refId++;
+        var operation = (hasIndex)
+            ? spec_1.OPERATION.REPLACE
+            : spec_1.OPERATION.ADD;
+        var isRef = (value['$changes']) !== undefined;
+        if (isRef) {
+            value['$changes'].setParent(this, this.$changes.root, index);
+        }
+        //
+        // (encoding)
+        // set a unique id to relate directly with this key/value.
+        //
+        if (!hasIndex) {
+            this.$changes.indexes[key] = index;
+            this.$indexes.set(index, key);
+        }
+        else if (isRef && // if is schema, force ADD operation if value differ from previous one.
+            this.$items.get(key) !== value) {
+            operation = spec_1.OPERATION.ADD;
+        }
+        this.$items.set(key, value);
+        this.$changes.change(key, operation);
+        return this;
+    };
+    MapSchema.prototype.get = function (key) {
+        return this.$items.get(key);
+    };
+    MapSchema.prototype.delete = function (key) {
+        //
+        // TODO: add a "purge" method after .encode() runs, to cleanup removed `$indexes`
+        //
+        // We don't remove $indexes to allow setting the same key in the same patch
+        // (See "should allow to remove and set an item in the same place" test)
+        //
+        // // const index = this.$changes.indexes[key];
+        // // this.$indexes.delete(index);
+        this.$changes.delete(key);
+        return this.$items.delete(key);
+    };
+    MapSchema.prototype.clear = function (changes) {
+        // discard previous operations.
+        this.$changes.discard(true, true);
+        this.$changes.indexes = {};
+        // clear previous indexes
+        this.$indexes.clear();
+        //
+        // When decoding:
+        // - enqueue items for DELETE callback.
+        // - flag child items for garbage collection.
+        //
+        if (changes) {
+            utils_1.removeChildRefs.call(this, changes);
+        }
+        // clear items
+        this.$items.clear();
+        this.$changes.operation({ index: 0, op: spec_1.OPERATION.CLEAR });
+        // touch all structures until reach root
+        this.$changes.touchParents();
+    };
+    MapSchema.prototype.has = function (key) {
+        return this.$items.has(key);
+    };
+    MapSchema.prototype.forEach = function (callbackfn) {
+        this.$items.forEach(callbackfn);
+    };
+    MapSchema.prototype.entries = function () {
+        return this.$items.entries();
+    };
+    MapSchema.prototype.keys = function () {
+        return this.$items.keys();
+    };
+    MapSchema.prototype.values = function () {
+        return this.$items.values();
+    };
+    Object.defineProperty(MapSchema.prototype, "size", {
+        get: function () {
+            return this.$items.size;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    MapSchema.prototype.setIndex = function (index, key) {
+        this.$indexes.set(index, key);
+    };
+    MapSchema.prototype.getIndex = function (index) {
+        return this.$indexes.get(index);
+    };
+    MapSchema.prototype.getByIndex = function (index) {
+        return this.$items.get(this.$indexes.get(index));
+    };
+    MapSchema.prototype.deleteByIndex = function (index) {
+        var key = this.$indexes.get(index);
+        this.$items.delete(key);
+        this.$indexes.delete(index);
+    };
+    MapSchema.prototype.toJSON = function () {
+        var map = {};
+        this.forEach(function (value, key) {
+            map[key] = (typeof (value['toJSON']) === "function")
+                ? value['toJSON']()
+                : value;
+        });
+        return map;
+    };
+    //
+    // Decoding utilities
+    //
+    MapSchema.prototype.clone = function (isDecoding) {
+        var cloned;
+        if (isDecoding) {
+            // client-side
+            cloned = Object.assign(new MapSchema(), this);
+        }
+        else {
+            // server-side
+            cloned = new MapSchema();
+            this.forEach(function (value, key) {
+                if (value['$changes']) {
+                    cloned.set(key, value['clone']());
+                }
+                else {
+                    cloned.set(key, value);
+                }
+            });
+        }
+        return cloned;
+    };
+    return MapSchema;
+}());
+exports.MapSchema = MapSchema;
+//# sourceMappingURL=MapSchema.js.map

package/lib/types/MapSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapSchema.js","sourceRoot":"","sources":["../../src/types/MapSchema.ts"],"names":[],"mappings":"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","sourcesContent":["import { ChangeTree } from \"../changes/ChangeTree\";\nimport { OPERATION } from \"../spec\";\nimport { SchemaDecoderCallbacks, Schema } from \"../Schema\";\nimport { addCallback, removeChildRefs } from \"./utils\";\nimport { DataChange } from \"..\";\n\nexport function getMapProxy(value: MapSchema) {\n    value['$proxy'] = true;\n\n    value = new Proxy(value, {\n        get: (obj, prop) => {\n            if (\n                typeof (prop) !== \"symbol\" && // accessing properties\n                typeof (obj[prop]) === \"undefined\"\n            ) {\n                return obj.get(prop as string);\n\n            } else {\n                return obj[prop];\n            }\n        },\n\n        set: (obj, prop, setValue) => {\n            if (\n                typeof (prop) !== \"symbol\" &&\n                (\n                    (prop as string).indexOf(\"$\") === -1 &&\n                    prop !== \"onAdd\" &&\n                    prop !== \"onRemove\" &&\n                    prop !== \"onChange\"\n                )\n            ) {\n                obj.set(prop as string, setValue);\n\n            } else {\n                obj[prop] = setValue;\n            }\n            return true;\n        },\n\n        deleteProperty: (obj, prop) => {\n            obj.delete(prop as string);\n            return true;\n        },\n    });\n\n    return value;\n}\n\nexport class MapSchema<V=any> implements Map<string, V>, SchemaDecoderCallbacks {\n    protected $changes: ChangeTree = new ChangeTree(this);\n\n    protected $items: Map<string, V> = new Map<string, V>();\n    protected $indexes: Map<number, string> = new Map<number, string>();\n\n    protected $refId: number = 0;\n\n    //\n    // Decoding callbacks\n    //\n    public $callbacks: { [operation: number]: Array<(item: V, key: string) => void> };\n    public onAdd(callback: (item: V, key: string) => void, triggerAll: boolean = true) {\n        return addCallback(\n            (this.$callbacks || (this.$callbacks = [])),\n            OPERATION.ADD,\n            callback,\n            (triggerAll)\n                ? this.$items\n                : undefined\n        );\n    }\n    public onRemove(callback: (item: V, key: string) => void) { return addCallback(this.$callbacks || (this.$callbacks = []), OPERATION.DELETE, callback); }\n    public onChange(callback: (item: V, key: string) => void) { return addCallback(this.$callbacks || (this.$callbacks = []), OPERATION.REPLACE, callback); }\n\n    static is(type: any) {\n        return type['map'] !== undefined;\n    }\n\n    constructor (initialValues?: Map<string, V> | any) {\n        if (initialValues) {\n            if (initialValues instanceof Map) {\n                initialValues.forEach((v, k) => this.set(k, v));\n\n            } else {\n                for (const k in initialValues) {\n                    this.set(k, initialValues[k]);\n                }\n            }\n        }\n    }\n\n    /** Iterator */\n    [Symbol.iterator](): IterableIterator<[string, V]> { return this.$items[Symbol.iterator](); }\n    get [Symbol.toStringTag]() { return this.$items[Symbol.toStringTag] }\n\n    set(key: string, value: V) {\n        if (value === undefined || value === null) {\n            throw new Error(`MapSchema#set('${key}', ${value}): trying to set ${value} value on '${key}'.`);\n        }\n\n        // get \"index\" for this value.\n        const hasIndex = typeof(this.$changes.indexes[key]) !== \"undefined\";\n        const index = (hasIndex)\n            ? this.$changes.indexes[key]\n            : this.$refId++;\n\n        let operation: OPERATION = (hasIndex)\n            ? OPERATION.REPLACE\n            : OPERATION.ADD;\n\n        const isRef = (value['$changes']) !== undefined;\n        if (isRef) {\n            (value['$changes'] as ChangeTree).setParent(\n                this,\n                this.$changes.root,\n                index\n            );\n        }\n\n        //\n        // (encoding)\n        // set a unique id to relate directly with this key/value.\n        //\n        if (!hasIndex) {\n            this.$changes.indexes[key] = index;\n            this.$indexes.set(index, key);\n\n        } else if (\n            isRef && // if is schema, force ADD operation if value differ from previous one.\n            this.$items.get(key) !== value\n        ) {\n            operation = OPERATION.ADD;\n        }\n\n        this.$items.set(key, value);\n\n        this.$changes.change(key, operation);\n\n        return this;\n    }\n\n    get(key: string): V | undefined {\n        return this.$items.get(key);\n    }\n\n    delete(key: string) {\n        //\n        // TODO: add a \"purge\" method after .encode() runs, to cleanup removed `$indexes`\n        //\n        // We don't remove $indexes to allow setting the same key in the same patch\n        // (See \"should allow to remove and set an item in the same place\" test)\n        //\n        // // const index = this.$changes.indexes[key];\n        // // this.$indexes.delete(index);\n\n        this.$changes.delete(key);\n        return this.$items.delete(key);\n    }\n\n    clear(changes?: DataChange[]) {\n        // discard previous operations.\n        this.$changes.discard(true, true);\n        this.$changes.indexes = {};\n\n        // clear previous indexes\n        this.$indexes.clear();\n\n        //\n        // When decoding:\n        // - enqueue items for DELETE callback.\n        // - flag child items for garbage collection.\n        //\n        if (changes) {\n            removeChildRefs.call(this, changes);\n        }\n\n        // clear items\n        this.$items.clear();\n\n        this.$changes.operation({ index: 0, op: OPERATION.CLEAR });\n\n        // touch all structures until reach root\n        this.$changes.touchParents();\n    }\n\n    has (key: string) {\n        return this.$items.has(key);\n    }\n\n    forEach(callbackfn: (value: V, key: string, map: Map<string, V>) => void) {\n        this.$items.forEach(callbackfn);\n    }\n\n    entries () {\n        return this.$items.entries();\n    }\n\n    keys () {\n        return this.$items.keys();\n    }\n\n    values() {\n        return this.$items.values();\n    }\n\n    get size () {\n        return this.$items.size;\n    }\n\n    protected setIndex(index: number, key: string) {\n        this.$indexes.set(index, key);\n    }\n\n    protected getIndex(index: number) {\n        return this.$indexes.get(index);\n    }\n\n    protected getByIndex(index: number) {\n        return this.$items.get(this.$indexes.get(index));\n    }\n\n    protected deleteByIndex(index: number) {\n        const key = this.$indexes.get(index);\n        this.$items.delete(key);\n        this.$indexes.delete(index);\n    }\n\n    toJSON() {\n        const map: any = {};\n\n        this.forEach((value, key) => {\n            map[key] = (typeof (value['toJSON']) === \"function\")\n                ? value['toJSON']()\n                : value;\n        });\n\n        return map;\n    }\n\n    //\n    // Decoding utilities\n    //\n    clone(isDecoding?: boolean): MapSchema<V> {\n        let cloned: MapSchema;\n\n        if (isDecoding) {\n            // client-side\n            cloned = Object.assign(new MapSchema(), this);\n\n        } else {\n            // server-side\n            cloned = new MapSchema();\n            this.forEach((value, key) => {\n                if (value['$changes']) {\n                    cloned.set(key, value['clone']());\n                } else {\n                    cloned.set(key, value);\n                }\n            })\n        }\n\n        return cloned;\n    }\n\n}\n"]}

package/lib/types/SetSchema.d.ts

@@ -0,0 +1,32 @@
+import { ChangeTree } from "../changes/ChangeTree";
+import { SchemaDecoderCallbacks } from "../Schema";
+import { DataChange } from "..";
+export declare class SetSchema<V = any> implements SchemaDecoderCallbacks {
+    protected $changes: ChangeTree;
+    protected $items: Map<number, V>;
+    protected $indexes: Map<number, number>;
+    protected $refId: number;
+    $callbacks: {
+        [operation: number]: Array<(item: V, key: string) => void>;
+    };
+    onAdd(callback: (item: V, key: string) => void, triggerAll?: boolean): () => boolean;
+    onRemove(callback: (item: V, key: string) => void): () => boolean;
+    onChange(callback: (item: V, key: string) => void): () => boolean;
+    static is(type: any): boolean;
+    constructor(initialValues?: Array<V>);
+    add(value: V): number | false;
+    entries(): IterableIterator<[number, V]>;
+    delete(item: V): boolean;
+    clear(changes?: DataChange[]): void;
+    has(value: V): boolean;
+    forEach(callbackfn: (value: V, key: number, collection: SetSchema<V>) => void): void;
+    values(): IterableIterator<V>;
+    get size(): number;
+    protected setIndex(index: number, key: number): void;
+    protected getIndex(index: number): number;
+    protected getByIndex(index: number): V;
+    protected deleteByIndex(index: number): void;
+    toArray(): V[];
+    toJSON(): V[];
+    clone(isDecoding?: boolean): SetSchema<V>;
+}