@woosh/meep-engine 2.126.15 → 2.126.16

package/package.json

@@ -5,7 +5,7 @@
   "description": "Pure JavaScript game engine. Fully featured and production ready.",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.126.15",
+  "version": "2.126.16",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.d.ts

@@ -1,5 +1,8 @@
 /**
  * Defines how to serialize and deserialize an instance of a given class
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinaryClassSerializationAdapter {
     /**

package/src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinaryClassSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.js"],"names":[],"mappings":"AAAA;;GAEG;AACH;IAEI;;;;OAIG;IACH,iBAFU,KAAK,CAEF;IAEb;;;;;;OAMG;IACH,mBAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,SAHa,CAAC,KACD,KAAK,CAAC,CAAC,CAAC,CAIpB;IAED;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED,iCAEC;IAED;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,kBAHW,YAAY,oBAKtB;IAED;;;;OAIG;IACH,oBAHW,YAAY,oBAKtB;IAGL;;;OAGG;IACH,4CAFU,OAAO,CAE0D;CAN1E"}
+{"version":3,"file":"BinaryClassSerializationAdapter.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH;IAEI;;;;OAIG;IACH,iBAFU,KAAK,CAEF;IAEb;;;;;;OAMG;IACH,mBAFU,MAAM,CAEJ;IAEZ;;;OAGG;IACH,SAHa,CAAC,KACD,KAAK,CAAC,CAAC,CAAC,CAIpB;IAED;;;OAGG;IACH,cAFa,MAAM,CAIlB;IAED,iCAEC;IAED;;;OAGG;IACH,iBAEC;IAED;;;OAGG;IACH,kBAHW,YAAY,oBAKtB;IAED;;;;OAIG;IACH,oBAHW,YAAY,oBAKtB;IAGL;;;OAGG;IACH,4CAFU,OAAO,CAE0D;CAN1E"}

package/src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.js

@@ -1,5 +1,8 @@
 /**
  * Defines how to serialize and deserialize an instance of a given class
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinaryClassSerializationAdapter {
 

package/src/engine/ecs/storage/binary/BinaryClassUpgrader.d.ts

@@ -28,5 +28,10 @@ export class BinaryClassUpgrader {
      * @returns {void}
      */
     upgrade(source: BinaryBuffer, target: BinaryBuffer): void;
+    /**
+     * @readonly
+     * @type {boolean}
+     */
+    readonly isBinaryClassUpgrader: boolean;
 }
 //# sourceMappingURL=BinaryClassUpgrader.d.ts.map

package/src/engine/ecs/storage/binary/BinaryClassUpgrader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinaryClassUpgrader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassUpgrader.js"],"names":[],"mappings":"AAAA;IAEI;;;;OAIG;IACH,0BAHU,MAAM,CAGG;IACnB;;;;OAIG;IACH,2BAHU,MAAM,CAGI;IAEpB;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;IAED;;;;;OAKG;IACH,gBAJW,YAAY,UACZ,YAAY,GACV,IAAI,CAIhB;CACJ"}
+{"version":3,"file":"BinaryClassUpgrader.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinaryClassUpgrader.js"],"names":[],"mappings":"AAAA;IAEI;;;;OAIG;IACH,0BAHU,MAAM,CAGG;IACnB;;;;OAIG;IACH,2BAHU,MAAM,CAGI;IAEpB;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,oBAFa,MAAM,CAIlB;IAED;;;;;OAKG;IACH,gBAJW,YAAY,UACZ,YAAY,GACV,IAAI,CAIhB;IAGL;;;OAGG;IACH,gCAFU,OAAO,CAEkC;CANlD"}

package/src/engine/ecs/storage/binary/BinaryClassUpgrader.js

@@ -39,3 +39,9 @@ export class BinaryClassUpgrader {
         throw new Error('Not Implemented');
     }
 }
+
+/**
+ * @readonly
+ * @type {boolean}
+ */
+BinaryClassUpgrader.prototype.isBinaryClassUpgrader = true;

package/src/engine/ecs/storage/binary/BinarySerializationRegistry.d.ts

@@ -1,5 +1,8 @@
 /**
  * Contains serializers for various data types as well as data upgraders which enable support for serialization format changes
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinarySerializationRegistry {
     /**
@@ -21,17 +24,18 @@ export class BinarySerializationRegistry {
     registerAdapters(adapters: BinaryClassSerializationAdapter[]): void;
     /**
      *
-     * @param {string} [className]
      * @param {BinaryClassSerializationAdapter} adapter
-     * @returns {boolean}
+     * @param {string} [className] if not specified, will be taken from the {@link BinaryClassSerializationAdapter.klass.typeName}
+     * @returns {boolean} true if added, false if adapter already existed
+     * @throws {Error} if `className` could not be inferred
      */
     registerAdapter(adapter: BinaryClassSerializationAdapter, className?: string): boolean;
     /**
      *
      * @param {string} className
-     * @returns {BinaryClassSerializationAdapter}
+     * @returns {BinaryClassSerializationAdapter|undefined}
      */
-    removeAdapter(className: string): BinaryClassSerializationAdapter;
+    removeAdapter(className: string): BinaryClassSerializationAdapter | undefined;
     /**
      *
      * @param {string} className
@@ -42,7 +46,7 @@ export class BinarySerializationRegistry {
      *
      * @param {string} className
      * @param {BinaryClassUpgrader} upgrader
-     * @returns {boolean}
+     * @returns {boolean} true iff added, false if already exists
      */
     registerUpgrader(className: string, upgrader: BinaryClassUpgrader): boolean;
     /**

package/src/engine/ecs/storage/binary/BinarySerializationRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinarySerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinarySerializationRegistry.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAEI;;;;OAIG;IACH,2BAAsB;IACtB;;;;OAIG;IACH,6BAAwB;IAExB;;;OAGG;IACH,2BAFW,+BAA+B,EAAE,QAM3C;IAED;;;;;OAKG;IACH,yBAHW,+BAA+B,cAD/B,MAAM,GAEJ,OAAO,CA6BnB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,+BAA+B,CAU3C;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,+BAA+B,GAAC,SAAS,CAIrD;IAED;;;;;OAKG;IACH,4BAJW,MAAM,YACN,mBAAmB,GACjB,OAAO,CAyCnB;IAED;;;;;;OAMG;IACH,6BALW,MAAM,gBACN,MAAM,eACN,MAAM,GACJ,mBAAmB,EAAE,GAAC,IAAI,CAsDtC;IAIL;;;OAGG;IACH,wCAFU,OAAO,CAEkD;CANlE"}
+{"version":3,"file":"BinarySerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/BinarySerializationRegistry.js"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH;IAEI;;;;OAIG;IACH,2BAAsB;IACtB;;;;OAIG;IACH,6BAAwB;IAExB;;;OAGG;IACH,2BAFW,+BAA+B,EAAE,QAM3C;IAED;;;;;;OAMG;IACH,yBALW,+BAA+B,cAC/B,MAAM,GACJ,OAAO,CAkCnB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,+BAA+B,GAAC,SAAS,CAYrD;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACJ,+BAA+B,GAAC,SAAS,CAMrD;IAED;;;;;OAKG;IACH,4BAJW,MAAM,YACN,mBAAmB,GACjB,OAAO,CA6CnB;IAED;;;;;;OAMG;IACH,6BALW,MAAM,gBACN,MAAM,eACN,MAAM,GACJ,mBAAmB,EAAE,GAAC,IAAI,CA0DtC;IAIL;;;OAGG;IACH,wCAFU,OAAO,CAEkD;CANlE"}

package/src/engine/ecs/storage/binary/BinarySerializationRegistry.js

@@ -3,6 +3,9 @@ import { Graph } from "../../../../core/graph/v2/Graph.js";
 
 /**
  * Contains serializers for various data types as well as data upgraders which enable support for serialization format changes
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
  */
 export class BinarySerializationRegistry {
 
@@ -31,9 +34,10 @@ export class BinarySerializationRegistry {
 
     /**
      *
-     * @param {string} [className]
      * @param {BinaryClassSerializationAdapter} adapter
-     * @returns {boolean}
+     * @param {string} [className] if not specified, will be taken from the {@link BinaryClassSerializationAdapter.klass.typeName}
+     * @returns {boolean} true if added, false if adapter already existed
+     * @throws {Error} if `className` could not be inferred
      */
     registerAdapter(adapter, className) {
         assert.defined(adapter, 'adapter');
@@ -44,15 +48,19 @@ export class BinarySerializationRegistry {
         if (_className === undefined) {
             const klass = adapter.getClass();
 
-            if (typeof klass.typeName === "string") {
-                _className = klass.typeName;
+            const typeName = klass.typeName;
+
+            if (typeof typeName === "string") {
+                _className = typeName;
             } else {
                 throw new Error(`className not specified, could not infer class name from the class itself`);
             }
         }
 
+        assert.isString(_className, 'className');
+
         if (this.serializers.has(_className)) {
-            //a serializer already exists
+            // a serializer already exists
 
             console.warn(`Serializer for class '${_className}' already exists, ignoring request`);
 
@@ -67,9 +75,11 @@ export class BinarySerializationRegistry {
     /**
      *
      * @param {string} className
-     * @returns {BinaryClassSerializationAdapter}
+     * @returns {BinaryClassSerializationAdapter|undefined}
      */
     removeAdapter(className) {
+        assert.isString(className, 'className');
+
         const adapter = this.serializers.get(className);
 
         if (adapter !== undefined) {
@@ -85,6 +95,8 @@ export class BinarySerializationRegistry {
      * @returns {BinaryClassSerializationAdapter|undefined}
      */
     getAdapter(className) {
+        assert.isString(className, 'className');
+
         return this.serializers.get(className);
     }
 
@@ -92,9 +104,13 @@ export class BinarySerializationRegistry {
      *
      * @param {string} className
      * @param {BinaryClassUpgrader} upgrader
-     * @returns {boolean}
+     * @returns {boolean} true iff added, false if already exists
      */
     registerUpgrader(className, upgrader) {
+        assert.isString(className, 'className');
+        assert.defined(upgrader, 'upgrader');
+        assert.notNull(upgrader, 'upgrader');
+        assert.equal(upgrader.isBinaryClassUpgrader, true, 'upgrader.isBinaryClassUpgrader !== true');
 
         if (upgrader.getStartVersion() === upgrader.getTargetVersion()) {
             throw new Error(`Upgrader for '${className}' start(=${upgrader.getStartVersion()}) and target(=${upgrader.getTargetVersion()}) versions are the same, must be different`);
@@ -113,13 +129,13 @@ export class BinarySerializationRegistry {
         }
 
         if (classUpgraders.hasNode(upgrader)) {
-            //upgrader already registered
+            // upgrader already registered
             return false;
         }
 
         classUpgraders.addNode(upgrader);
 
-        //find other upgraders that would connect to this upgrader
+        // find other upgraders that would connect to this upgrader
         classUpgraders.traverseNodes(u => {
             if (u === upgrader) {
                 return;
@@ -143,6 +159,10 @@ export class BinarySerializationRegistry {
      * @returns {BinaryClassUpgrader[]|null} sequential shortest chain of upgraders or null if no valid chain exists
      */
     getUpgradersChain(className, startVersion, goalVersion) {
+        assert.isString(className, 'className');
+        assert.isNumber(startVersion, 'startVersion');
+        assert.isNumber(goalVersion, 'goalVersion');
+
         if (startVersion === goalVersion) {
             //already at the goal version
             return [];

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts

@@ -1,3 +1,8 @@
+/**
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
 export class BinaryCollectionDeSerializer {
     /**
      * @private

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BinaryCollectionDeSerializer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js"],"names":[],"mappings":"AAmBA;IAEQ;;;OAGG;IACH,iBAAoB;IAEpB;;;OAGG;IACH,eAAkB;IAElB;;;;OAIG;IACH,4BAAgC;IAChC;;;;OAIG;IACH,0BAA8B;IAE9B;;;OAGG;IACH,qBAAqB;IAErB;;;OAGG;IACH,qBAAqB;IAErB;;;OAGG;IACH,qBAAqB;IAErB;;;OAGG;IACH,gBAAmB;IAEnB;;;OAGG;IACH,kBAAqB;IAErB;;;;OAIG;IACH,yBAA0C;IAC1C;;;;OAIG;IACH,yBAA0C;IAE1C;;;OAGG;IACH,cAA0B;IAI9B;;;OAGG;IACH,sBAFW,2BAA2B,QAOrC;IAED;;;OAGG;IACH,eAFa,2BAA2B,CAIvC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,KAAK,CAAC,CAAC,CAAC,GAAC,IAAI,CAUzB;IAED;;;OAGG;IACH,wCAFW,CAAS,IAAM,EAAN,MAAM,EAAC,IAAK,EAAL,KAAK,EAAE,IAA+B,EAA/B,+BAA+B,KAAE,EAAE,QAgFpE;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH,KAHa,CAAC,KACD;QAAC,KAAK,EAAE,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CA8DnC;CAEJ;6BApV4B,4CAA4C"}
+{"version":3,"file":"BinaryCollectionDeSerializer.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js"],"names":[],"mappings":"AAkBA;;;;GAIG;AACH;IAEI;;;OAGG;IACH,iBAAgB;IAEhB;;;OAGG;IACH,eAAc;IAEd;;;;OAIG;IACH,4BAA4B;IAC5B;;;;OAIG;IACH,0BAA0B;IAE1B;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,qBAAiB;IAEjB;;;OAGG;IACH,gBAAe;IAEf;;;OAGG;IACH,kBAAiB;IAEjB;;;;OAIG;IACH,yBAAsC;IACtC;;;;OAIG;IACH,yBAAsC;IAEtC;;;OAGG;IACH,cAAsB;IAGtB;;;OAGG;IACH,sBAFW,2BAA2B,QAOrC;IAED;;;OAGG;IACH,eAFa,2BAA2B,CAIvC;IAED;;;OAGG;IACH,kBAFW,YAAY,QAOtB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,MAAM,CAIlB;IAED;;;OAGG;IACH,mBAFa,KAAK,CAAC,CAAC,CAAC,GAAC,IAAI,CAUzB;IAED;;;OAGG;IACH,wCAFW,CAAS,IAAM,EAAN,MAAM,EAAC,IAAK,EAAL,KAAK,EAAE,IAA+B,EAA/B,+BAA+B,KAAE,EAAE,QAgFpE;IAED,iBAWC;IAED;;;OAGG;IACH,uBAeC;IAED;;;OAGG;IACH,KAHa,CAAC,KACD;QAAC,KAAK,EAAE,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAC,CA8DnC;CAEJ;6BAvV4B,4CAA4C"}

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js

@@ -16,83 +16,86 @@ const State = {
     Ready: 1
 };
 
-
+/**
+ *
+ * @author Alex Goldring
+ * @copyright Company Named Limited (c) 2025
+ */
 export class BinaryCollectionDeSerializer {
-    constructor() {
-        /**
-         * @private
-         * @type {BinarySerializationRegistry}
-         */
-        this.registry = null;
-
-        /**
-         * @private
-         * @type {BinaryBuffer}
-         */
-        this.buffer = null;
-
-        /**
-         *
-         * @type {boolean}
-         * @private
-         */
-        this.__dictionaryEnabled = false;
-        /**
-         *
-         * @type {boolean}
-         * @private
-         */
-        this.__upgradeRequired = false;
-
-        /**
-         * @private
-         * @type {number}
-         */
-        this.elementCount = 0;
-
-        /**
-         * @private
-         * @type {number}
-         */
-        this.elementIndex = 0;
 
-        /**
-         * @private
-         * @type {number}
-         */
-        this.startAddress = 0;
-
-        /**
-         * @private
-         * @type {BinaryClassSerializationAdapter}
-         */
-        this.adapter = null;
-
-        /**
-         * @private
-         * @type {BinaryClassUpgrader[]}
-         */
-        this.upgraders = null;
-
-        /**
-         *
-         * @type {BinaryBuffer}
-         * @private
-         */
-        this.__upgradeBuffer0 = new BinaryBuffer();
-        /**
-         *
-         * @type {BinaryBuffer}
-         * @private
-         */
-        this.__upgradeBuffer1 = new BinaryBuffer();
-
-        /**
-         * @private
-         * @type {State}
-         */
-        this.state = State.Initial;
-    }
+    /**
+     * @private
+     * @type {BinarySerializationRegistry}
+     */
+    registry = null;
+
+    /**
+     * @private
+     * @type {BinaryBuffer}
+     */
+    buffer = null;
+
+    /**
+     *
+     * @type {boolean}
+     * @private
+     */
+    __dictionaryEnabled = false;
+    /**
+     *
+     * @type {boolean}
+     * @private
+     */
+    __upgradeRequired = false;
+
+    /**
+     * @private
+     * @type {number}
+     */
+    elementCount = 0;
+
+    /**
+     * @private
+     * @type {number}
+     */
+    elementIndex = 0;
+
+    /**
+     * @private
+     * @type {number}
+     */
+    startAddress = 0;
+
+    /**
+     * @private
+     * @type {BinaryClassSerializationAdapter}
+     */
+    adapter = null;
+
+    /**
+     * @private
+     * @type {BinaryClassUpgrader[]}
+     */
+    upgraders = null;
+
+    /**
+     *
+     * @type {BinaryBuffer}
+     * @private
+     */
+    __upgradeBuffer0 = new BinaryBuffer();
+    /**
+     *
+     * @type {BinaryBuffer}
+     * @private
+     */
+    __upgradeBuffer1 = new BinaryBuffer();
+
+    /**
+     * @private
+     * @type {State}
+     */
+    state = State.Initial;
 
 
     /**

package/src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.d.ts

@@ -1,10 +1,10 @@
 /**
- * Upgrade binary data by executing a sequnece of upgraders on it
+ * Upgrade binary data by executing a sequence of upgraders on it
  * @param {BinaryClassUpgrader[]} upgraders
- * @param {BinaryBuffer} buffer
+ * @param {BinaryBuffer} buffer input data
  * @param {BinaryBuffer} tempBuffer0
  * @param {BinaryBuffer} tempBuffer1
- * @return {BinaryBuffer} new buffer with upgraded data
+ * @return {BinaryBuffer} buffer with upgraded data, this will be either {@link tempBuffer0} or {@link tempBuffer1}
  */
 export function executeBinaryClassUpgraderChain(upgraders: BinaryClassUpgrader[], buffer: BinaryBuffer, tempBuffer0: BinaryBuffer, tempBuffer1: BinaryBuffer): BinaryBuffer;
 //# sourceMappingURL=executeBinaryClassUpgraderChain.d.ts.map

package/src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executeBinaryClassUpgraderChain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,2DANW,mBAAmB,EAAE,UACrB,YAAY,eACZ,YAAY,eACZ,YAAY,GACX,YAAY,CAqCvB"}
+{"version":3,"file":"executeBinaryClassUpgraderChain.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.js"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,2DANW,mBAAmB,EAAE,UACrB,YAAY,eACZ,YAAY,eACZ,YAAY,GACX,YAAY,CA2CvB"}

package/src/engine/ecs/storage/binary/executeBinaryClassUpgraderChain.js

@@ -1,16 +1,22 @@
 import { assert } from "../../../../core/assert.js";
 
 /**
- * Upgrade binary data by executing a sequnece of upgraders on it
+ * Upgrade binary data by executing a sequence of upgraders on it
  * @param {BinaryClassUpgrader[]} upgraders
- * @param {BinaryBuffer} buffer
+ * @param {BinaryBuffer} buffer input data
  * @param {BinaryBuffer} tempBuffer0
  * @param {BinaryBuffer} tempBuffer1
- * @return {BinaryBuffer} new buffer with upgraded data
+ * @return {BinaryBuffer} buffer with upgraded data, this will be either {@link tempBuffer0} or {@link tempBuffer1}
  */
-export function executeBinaryClassUpgraderChain(upgraders, buffer, tempBuffer0, tempBuffer1) {
-    assert.ok(Array.isArray(upgraders), 'upgraders must be an array, instead was something else');
-    assert.defined(buffer);
+export function executeBinaryClassUpgraderChain(
+    upgraders,
+    buffer,
+    tempBuffer0,
+    tempBuffer1
+) {
+    assert.isArray(upgraders, 'upgraders');
+    assert.defined(buffer, 'buffer');
+
     assert.defined(tempBuffer0);
     assert.defined(tempBuffer1);