@icazemier/gibbons 5.0.2 → 5.0.4

package/build/cjs/gibbon-processor.d.ts

@@ -1,8 +1,8 @@
 /**
  * Just a class to carry byte position and bit position around
  *
- * @param {Number} byteNo - unsigned integer value (0..n)
- * @param {Number} bitPos - unsigned integer value (0..n)
+ * @param {number} byteNo - unsigned integer value (0..n)
+ * @param {number} bitPos - unsigned integer value (0..n)
  */
 export declare class BitByte {
     byteNo: number;
@@ -22,7 +22,7 @@ export declare class GibbonProcessor {
      *
      * getByteNoAndBitPos(256); // returns { byteNo: 31, bitPos: 7}
      * ```
-     * @param {Number} position - Unsigned integer value (1..n)
+     * @param {number} position - Unsigned integer value (1..n)
      * @returns {BitByte} - A new a BitByte instance
      * @throws {Error} when position is <= 0
      */
@@ -106,8 +106,8 @@ export declare class GibbonProcessor {
      * // 0000 0001 === 0000 0001 (true)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isTrue(data?: number, index?: number): boolean;
@@ -126,8 +126,8 @@ export declare class GibbonProcessor {
      * // 0000 0001 === 0000 0000 (false)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isFalse(data?: number, index?: number): boolean;
@@ -143,9 +143,9 @@ export declare class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0001 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static setBit(data?: number, index?: number): number;
     /**
@@ -162,9 +162,9 @@ export declare class GibbonProcessor {
      * // ---------------- AND
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static clearBit(data?: number, index?: number): number;
     /**
@@ -189,10 +189,10 @@ export declare class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @param {boolean} value
-     * @returns {Number}
+     * @returns {number}
      */
     static changeBit(data: number | undefined, index: number | undefined, value: boolean): number;
     /**
@@ -207,9 +207,9 @@ export declare class GibbonProcessor {
      * // --------------- XOR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static toggleBit(data?: number, index?: number): number;
 }

package/build/cjs/gibbon-processor.js

@@ -4,8 +4,8 @@ exports.GibbonProcessor = exports.BitByte = void 0;
 /**
  * Just a class to carry byte position and bit position around
  *
- * @param {Number} byteNo - unsigned integer value (0..n)
- * @param {Number} bitPos - unsigned integer value (0..n)
+ * @param {number} byteNo - unsigned integer value (0..n)
+ * @param {number} bitPos - unsigned integer value (0..n)
  */
 class BitByte {
     constructor(byteNo, bitPos) {
@@ -27,12 +27,12 @@ class GibbonProcessor {
      *
      * getByteNoAndBitPos(256); // returns { byteNo: 31, bitPos: 7}
      * ```
-     * @param {Number} position - Unsigned integer value (1..n)
+     * @param {number} position - Unsigned integer value (1..n)
      * @returns {BitByte} - A new a BitByte instance
      * @throws {Error} when position is <= 0
      */
     static getByteNoAndBitPos(position = 0) {
-        if (position <= 0) {
+        if (!Number.isInteger(position) || position <= 0) {
             throw new Error("Illegal position");
         }
         const index = position - 1;
@@ -115,8 +115,8 @@ class GibbonProcessor {
      * // 0000 0001 === 0000 0001 (true)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isTrue(data = 0x0, index = 0) {
@@ -138,8 +138,8 @@ class GibbonProcessor {
      * // 0000 0001 === 0000 0000 (false)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isFalse(data = 0x0, index = 0) {
@@ -158,9 +158,9 @@ class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0001 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static setBit(data = 0x0, index = 0) {
         const mask = 1 << index;
@@ -180,9 +180,9 @@ class GibbonProcessor {
      * // ---------------- AND
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static clearBit(data = 0x0, index = 0) {
         const mask = 1 << index;
@@ -210,10 +210,10 @@ class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @param {boolean} value
-     * @returns {Number}
+     * @returns {number}
      */
     static changeBit(data = 0x0, index = 0, value) {
         const mask = 1 << index;
@@ -232,9 +232,9 @@ class GibbonProcessor {
      * // --------------- XOR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static toggleBit(data = 0x0, index = 0) {
         const mask = 1 << index;

package/build/cjs/gibbon.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 /**
  * A Gibbon
  * @param {ArrayBuffer} arrayBuffer - allocate this Gibbon with some working memory
@@ -45,15 +44,16 @@ export declare class Gibbon {
      * Set bit: true according to integer position in the Gibbon <br>
      * <i>Note: Starting from 1</i>
      * @throws {Error} Position can't exceed data view bounds.
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon} - For chaining purposes
      */
     setPosition(position: number): Gibbon;
     /**
      * Set bit: false according to integer position
      * Note: Starting from 1
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
+     * @throws {Error} Position can't exceed data view bounds.
      */
     clearPosition(position: number): Gibbon;
     /**
@@ -65,7 +65,7 @@ export declare class Gibbon {
      *
      * gibbon.isPosition(1); // true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
      */
     togglePosition(position: number): Gibbon;
@@ -80,7 +80,7 @@ export declare class Gibbon {
      * gibbon.isPosition(1); // returns true
      * ```
      *
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @param {boolean} [on] - Optional set true or false (default : false)
      * @returns {Gibbon} - Return itself for chaining purposes
      */
@@ -96,7 +96,7 @@ export declare class Gibbon {
      *
      * gibbon.isPosition(1); // returns true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {boolean} if membership is set
      */
     isPosition(position: number): boolean;
@@ -140,7 +140,7 @@ export declare class Gibbon {
      *  gibbon.hasAllFromPositions([-1, 2]); // true
      * ```
      *
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when all positions correspondent to the given indexes
      * @throws {TypeError} if positionArray is not an instance of array
      *
@@ -180,7 +180,7 @@ export declare class Gibbon {
      *
      *  gibbon.hasAllFromPositions([-1, 100]); // true
      * ```
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when one of these positions correspond
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -202,7 +202,7 @@ export declare class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([1]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {Error} When out of bounds
      */
@@ -226,7 +226,7 @@ export declare class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([2]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -268,7 +268,7 @@ export declare class Gibbon {
     static fromString(gibbonString: string): Gibbon;
     /**
      * Creates a new empty Gibbon from a given byte size
-     * @param {Number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
+     * @param {number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
      * @returns {Gibbon} - new instance of a Gibbon
      */
     static create(byteSize: number): Gibbon;

package/build/cjs/gibbon.js

@@ -87,7 +87,7 @@ class Gibbon {
      * Set bit: true according to integer position in the Gibbon <br>
      * <i>Note: Starting from 1</i>
      * @throws {Error} Position can't exceed data view bounds.
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon} - For chaining purposes
      */
     setPosition(position) {
@@ -108,11 +108,15 @@ class Gibbon {
     /**
      * Set bit: false according to integer position
      * Note: Starting from 1
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
+     * @throws {Error} Position can't exceed data view bounds.
      */
     clearPosition(position) {
         const bitBytePosition = gibbon_processor_js_1.GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         let byte = this.dataView.getUint8(bitBytePosition.byteNo);
         byte = gibbon_processor_js_1.GibbonProcessor.clearBit(byte, bitBytePosition.bitPos);
         this.dataView.setUint8(bitBytePosition.byteNo, byte);
@@ -127,11 +131,14 @@ class Gibbon {
      *
      * gibbon.isPosition(1); // true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
      */
     togglePosition(position) {
         const bitBytePosition = gibbon_processor_js_1.GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         let byte = this.dataView.getUint8(bitBytePosition.byteNo);
         byte = gibbon_processor_js_1.GibbonProcessor.toggleBit(byte, bitBytePosition.bitPos);
         this.dataView.setUint8(bitBytePosition.byteNo, byte);
@@ -148,12 +155,15 @@ class Gibbon {
      * gibbon.isPosition(1); // returns true
      * ```
      *
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @param {boolean} [on] - Optional set true or false (default : false)
      * @returns {Gibbon} - Return itself for chaining purposes
      */
     changePosition(position, on = false) {
         const bitBytePosition = gibbon_processor_js_1.GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         let byte = this.dataView.getUint8(bitBytePosition.byteNo);
         byte = gibbon_processor_js_1.GibbonProcessor.changeBit(byte, bitBytePosition.bitPos, on);
         this.dataView.setUint8(bitBytePosition.byteNo, byte);
@@ -170,11 +180,14 @@ class Gibbon {
      *
      * gibbon.isPosition(1); // returns true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {boolean} if membership is set
      */
     isPosition(position) {
         const bitBytePosition = gibbon_processor_js_1.GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         const byte = this.dataView.getUint8(bitBytePosition.byteNo);
         return gibbon_processor_js_1.GibbonProcessor.isTrue(byte, bitBytePosition.bitPos);
     }
@@ -243,7 +256,7 @@ class Gibbon {
      *  gibbon.hasAllFromPositions([-1, 2]); // true
      * ```
      *
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when all positions correspondent to the given indexes
      * @throws {TypeError} if positionArray is not an instance of array
      *
@@ -300,7 +313,7 @@ class Gibbon {
      *
      *  gibbon.hasAllFromPositions([-1, 100]); // true
      * ```
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when one of these positions correspond
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -328,7 +341,7 @@ class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([1]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {Error} When out of bounds
      */
@@ -369,7 +382,7 @@ class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([2]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -386,7 +399,10 @@ class Gibbon {
         if (data instanceof Buffer) {
             return Gibbon.fromBuffer(data);
         }
-        return Gibbon.fromString(data);
+        if (typeof data === "string") {
+            return Gibbon.fromString(data);
+        }
+        throw new TypeError(`Expected a string or Buffer for decoding, but received a: ${typeof data}`);
     }
     /**
      * Depending on the GIBBONS_ENCODE_FROM_TO_STRING environment variable if converts this
@@ -423,9 +439,12 @@ class Gibbon {
      * @override
      */
     toString() {
-        return String.fromCharCode.apply(null, 
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        new Uint16Array(this.arrayBuffer));
+        const view = new Uint16Array(this.arrayBuffer);
+        let result = "";
+        for (let i = 0; i < view.length; i++) {
+            result += String.fromCharCode(view[i]);
+        }
+        return result;
     }
     /**
      * Class method to create a new Gibbon from a string<br>
@@ -444,10 +463,13 @@ class Gibbon {
     }
     /**
      * Creates a new empty Gibbon from a given byte size
-     * @param {Number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
+     * @param {number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
      * @returns {Gibbon} - new instance of a Gibbon
      */
     static create(byteSize) {
+        if (!Number.isInteger(byteSize) || byteSize <= 0) {
+            throw new Error("byteSize must be a positive integer");
+        }
         const arrayBuffer = new ArrayBuffer(byteSize);
         return new Gibbon(arrayBuffer);
     }

package/build/esm/gibbon-processor.d.ts

@@ -1,8 +1,8 @@
 /**
  * Just a class to carry byte position and bit position around
  *
- * @param {Number} byteNo - unsigned integer value (0..n)
- * @param {Number} bitPos - unsigned integer value (0..n)
+ * @param {number} byteNo - unsigned integer value (0..n)
+ * @param {number} bitPos - unsigned integer value (0..n)
  */
 export declare class BitByte {
     byteNo: number;
@@ -22,7 +22,7 @@ export declare class GibbonProcessor {
      *
      * getByteNoAndBitPos(256); // returns { byteNo: 31, bitPos: 7}
      * ```
-     * @param {Number} position - Unsigned integer value (1..n)
+     * @param {number} position - Unsigned integer value (1..n)
      * @returns {BitByte} - A new a BitByte instance
      * @throws {Error} when position is <= 0
      */
@@ -106,8 +106,8 @@ export declare class GibbonProcessor {
      * // 0000 0001 === 0000 0001 (true)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isTrue(data?: number, index?: number): boolean;
@@ -126,8 +126,8 @@ export declare class GibbonProcessor {
      * // 0000 0001 === 0000 0000 (false)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isFalse(data?: number, index?: number): boolean;
@@ -143,9 +143,9 @@ export declare class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0001 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static setBit(data?: number, index?: number): number;
     /**
@@ -162,9 +162,9 @@ export declare class GibbonProcessor {
      * // ---------------- AND
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static clearBit(data?: number, index?: number): number;
     /**
@@ -189,10 +189,10 @@ export declare class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @param {boolean} value
-     * @returns {Number}
+     * @returns {number}
      */
     static changeBit(data: number | undefined, index: number | undefined, value: boolean): number;
     /**
@@ -207,9 +207,9 @@ export declare class GibbonProcessor {
      * // --------------- XOR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static toggleBit(data?: number, index?: number): number;
 }

package/build/esm/gibbon-processor.js

@@ -1,8 +1,8 @@
 /**
  * Just a class to carry byte position and bit position around
  *
- * @param {Number} byteNo - unsigned integer value (0..n)
- * @param {Number} bitPos - unsigned integer value (0..n)
+ * @param {number} byteNo - unsigned integer value (0..n)
+ * @param {number} bitPos - unsigned integer value (0..n)
  */
 export class BitByte {
     byteNo;
@@ -25,12 +25,12 @@ export class GibbonProcessor {
      *
      * getByteNoAndBitPos(256); // returns { byteNo: 31, bitPos: 7}
      * ```
-     * @param {Number} position - Unsigned integer value (1..n)
+     * @param {number} position - Unsigned integer value (1..n)
      * @returns {BitByte} - A new a BitByte instance
      * @throws {Error} when position is <= 0
      */
     static getByteNoAndBitPos(position = 0) {
-        if (position <= 0) {
+        if (!Number.isInteger(position) || position <= 0) {
             throw new Error("Illegal position");
         }
         const index = position - 1;
@@ -113,8 +113,8 @@ export class GibbonProcessor {
      * // 0000 0001 === 0000 0001 (true)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isTrue(data = 0x0, index = 0) {
@@ -136,8 +136,8 @@ export class GibbonProcessor {
      * // 0000 0001 === 0000 0000 (false)
      * //
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @returns {boolean}
      */
     static isFalse(data = 0x0, index = 0) {
@@ -156,9 +156,9 @@ export class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0001 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static setBit(data = 0x0, index = 0) {
         const mask = 1 << index;
@@ -178,9 +178,9 @@ export class GibbonProcessor {
      * // ---------------- AND
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static clearBit(data = 0x0, index = 0) {
         const mask = 1 << index;
@@ -208,10 +208,10 @@ export class GibbonProcessor {
      * // ---------------- OR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
      * @param {boolean} value
-     * @returns {Number}
+     * @returns {number}
      */
     static changeBit(data = 0x0, index = 0, value) {
         const mask = 1 << index;
@@ -230,9 +230,9 @@ export class GibbonProcessor {
      * // --------------- XOR
      * // 0000 0000 result
      * ```
-     * @param {Number} data - Unsigned integer value
-     * @param {Number} index - Unsigned integer value (0..7)
-     * @returns {Number}
+     * @param {number} data - Unsigned integer value
+     * @param {number} index - Unsigned integer value (0..7)
+     * @returns {number}
      */
     static toggleBit(data = 0x0, index = 0) {
         const mask = 1 << index;

package/build/esm/gibbon.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" resolution-mode="require"/>
 /**
  * A Gibbon
  * @param {ArrayBuffer} arrayBuffer - allocate this Gibbon with some working memory
@@ -45,15 +44,16 @@ export declare class Gibbon {
      * Set bit: true according to integer position in the Gibbon <br>
      * <i>Note: Starting from 1</i>
      * @throws {Error} Position can't exceed data view bounds.
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon} - For chaining purposes
      */
     setPosition(position: number): Gibbon;
     /**
      * Set bit: false according to integer position
      * Note: Starting from 1
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
+     * @throws {Error} Position can't exceed data view bounds.
      */
     clearPosition(position: number): Gibbon;
     /**
@@ -65,7 +65,7 @@ export declare class Gibbon {
      *
      * gibbon.isPosition(1); // true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
      */
     togglePosition(position: number): Gibbon;
@@ -80,7 +80,7 @@ export declare class Gibbon {
      * gibbon.isPosition(1); // returns true
      * ```
      *
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @param {boolean} [on] - Optional set true or false (default : false)
      * @returns {Gibbon} - Return itself for chaining purposes
      */
@@ -96,7 +96,7 @@ export declare class Gibbon {
      *
      * gibbon.isPosition(1); // returns true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {boolean} if membership is set
      */
     isPosition(position: number): boolean;
@@ -140,7 +140,7 @@ export declare class Gibbon {
      *  gibbon.hasAllFromPositions([-1, 2]); // true
      * ```
      *
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when all positions correspondent to the given indexes
      * @throws {TypeError} if positionArray is not an instance of array
      *
@@ -180,7 +180,7 @@ export declare class Gibbon {
      *
      *  gibbon.hasAllFromPositions([-1, 100]); // true
      * ```
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when one of these positions correspond
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -202,7 +202,7 @@ export declare class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([1]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {Error} When out of bounds
      */
@@ -226,7 +226,7 @@ export declare class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([2]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -268,7 +268,7 @@ export declare class Gibbon {
     static fromString(gibbonString: string): Gibbon;
     /**
      * Creates a new empty Gibbon from a given byte size
-     * @param {Number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
+     * @param {number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
      * @returns {Gibbon} - new instance of a Gibbon
      */
     static create(byteSize: number): Gibbon;

package/build/esm/gibbon.js

@@ -86,7 +86,7 @@ export class Gibbon {
      * Set bit: true according to integer position in the Gibbon <br>
      * <i>Note: Starting from 1</i>
      * @throws {Error} Position can't exceed data view bounds.
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon} - For chaining purposes
      */
     setPosition(position) {
@@ -107,11 +107,15 @@ export class Gibbon {
     /**
      * Set bit: false according to integer position
      * Note: Starting from 1
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
+     * @throws {Error} Position can't exceed data view bounds.
      */
     clearPosition(position) {
         const bitBytePosition = GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         let byte = this.dataView.getUint8(bitBytePosition.byteNo);
         byte = GibbonProcessor.clearBit(byte, bitBytePosition.bitPos);
         this.dataView.setUint8(bitBytePosition.byteNo, byte);
@@ -126,11 +130,14 @@ export class Gibbon {
      *
      * gibbon.isPosition(1); // true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {Gibbon}
      */
     togglePosition(position) {
         const bitBytePosition = GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         let byte = this.dataView.getUint8(bitBytePosition.byteNo);
         byte = GibbonProcessor.toggleBit(byte, bitBytePosition.bitPos);
         this.dataView.setUint8(bitBytePosition.byteNo, byte);
@@ -147,12 +154,15 @@ export class Gibbon {
      * gibbon.isPosition(1); // returns true
      * ```
      *
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @param {boolean} [on] - Optional set true or false (default : false)
      * @returns {Gibbon} - Return itself for chaining purposes
      */
     changePosition(position, on = false) {
         const bitBytePosition = GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         let byte = this.dataView.getUint8(bitBytePosition.byteNo);
         byte = GibbonProcessor.changeBit(byte, bitBytePosition.bitPos, on);
         this.dataView.setUint8(bitBytePosition.byteNo, byte);
@@ -169,11 +179,14 @@ export class Gibbon {
      *
      * gibbon.isPosition(1); // returns true
      * ```
-     * @param {Number} position - unsigned integer value
+     * @param {number} position - unsigned integer value
      * @returns {boolean} if membership is set
      */
     isPosition(position) {
         const bitBytePosition = GibbonProcessor.getByteNoAndBitPos(position);
+        if (bitBytePosition.byteNo >= this.dataView.byteLength) {
+            throw new Error("Illegal position");
+        }
         const byte = this.dataView.getUint8(bitBytePosition.byteNo);
         return GibbonProcessor.isTrue(byte, bitBytePosition.bitPos);
     }
@@ -242,7 +255,7 @@ export class Gibbon {
      *  gibbon.hasAllFromPositions([-1, 2]); // true
      * ```
      *
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when all positions correspondent to the given indexes
      * @throws {TypeError} if positionArray is not an instance of array
      *
@@ -299,7 +312,7 @@ export class Gibbon {
      *
      *  gibbon.hasAllFromPositions([-1, 100]); // true
      * ```
-     * @param {Array<Number>} positionArray - containing signed integer values (representing bit positions)
+     * @param {Array<number>} positionArray - containing signed integer values (representing bit positions)
      * @return {boolean} true when one of these positions correspond
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -327,7 +340,7 @@ export class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([1]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {Error} When out of bounds
      */
@@ -368,7 +381,7 @@ export class Gibbon {
      *  gibbon.setAllFromPositions([1, -2]);
      *  gibbon.hasAllFromPositions([2]); // returns true
      * ```
-     * @param {Array<Number>} positionArray - Array with integer values starting from 1.
+     * @param {Array<number>} positionArray - Array with integer values starting from 1.
      * @returns {Gibbon} - For chaining purposes
      * @throws {TypeError} if positionArray is not an instance of array
      */
@@ -385,7 +398,10 @@ export class Gibbon {
         if (data instanceof Buffer) {
             return Gibbon.fromBuffer(data);
         }
-        return Gibbon.fromString(data);
+        if (typeof data === "string") {
+            return Gibbon.fromString(data);
+        }
+        throw new TypeError(`Expected a string or Buffer for decoding, but received a: ${typeof data}`);
     }
     /**
      * Depending on the GIBBONS_ENCODE_FROM_TO_STRING environment variable if converts this
@@ -422,9 +438,12 @@ export class Gibbon {
      * @override
      */
     toString() {
-        return String.fromCharCode.apply(null, 
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        new Uint16Array(this.arrayBuffer));
+        const view = new Uint16Array(this.arrayBuffer);
+        let result = "";
+        for (let i = 0; i < view.length; i++) {
+            result += String.fromCharCode(view[i]);
+        }
+        return result;
     }
     /**
      * Class method to create a new Gibbon from a string<br>
@@ -443,10 +462,13 @@ export class Gibbon {
     }
     /**
      * Creates a new empty Gibbon from a given byte size
-     * @param {Number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
+     * @param {number} byteSize - Allocate this Gibbon with a unsigned integer value (size in bytes)
      * @returns {Gibbon} - new instance of a Gibbon
      */
     static create(byteSize) {
+        if (!Number.isInteger(byteSize) || byteSize <= 0) {
+            throw new Error("byteSize must be a positive integer");
+        }
         const arrayBuffer = new ArrayBuffer(byteSize);
         return new Gibbon(arrayBuffer);
     }

package/package.json

@@ -2,8 +2,8 @@
   "name": "@icazemier/gibbons",
   "type": "module",
   "private": false,
-  "version": "5.0.2",
-  "description": "Gibbons is a Node.js module which helps in managing user groups and user permissions with `bitwise` effiency.",
+  "version": "5.0.4",
+  "description": "Gibbons is a Node.js module which helps in managing user groups and user permissions with `bitwise` efficiency.",
   "contributors": [
     {
       "name": "Ivo Cazemier",
@@ -17,7 +17,9 @@
     "bitwise"
   ],
   "files": [
-    "build/"
+    "build/",
+    "README.md",
+    "LICENSE"
   ],
   "main": "./build/cjs/index.js",
   "module": "./build/esm/index.js",
@@ -29,7 +31,7 @@
   },
   "types": "./build/esm/index.d.ts",
   "engines": {
-    "node": "^12.20.0 || ^14.13.1 || >=16.0.0"
+    "node": "^16.0.0 || ^18.0.0 || >=20.0.0"
   },
   "os": [
     "darwin",
@@ -37,10 +39,11 @@
     "win32"
   ],
   "scripts": {
-    "test": "cross-env NODE_ENV=test c8 ava",
-    "build:esm": "tsc -p tsconfig.json",
-    "build:cjs": "tsc -p tsconfig-cjs.json",
-    "build": "rimraf build && npm run build:esm && npm run build:cjs && node ./fixup.mjs",
+    "test": "cross-env NODE_ENV=test vitest run --coverage",
+    "build:esm": "tsc -p tsconfig-build-esm.json",
+    "build:cjs": "tsc -p tsconfig-build-cjs.json",
+    "build": "rimraf build && npm run build:esm && npm run build:cjs && npm run fixup",
+    "fixup": "node ./fixup.mjs",
     "lint": "eslint . --ext .ts",
     "lint:fix": "eslint . --ext .ts --fix",
     "prepublishOnly": "npm run lint",
@@ -54,16 +57,17 @@
   "homepage": "https://icazemier.github.io/gibbons/",
   "license": "MIT",
   "devDependencies": {
-    "@types/node": "^18.13.0",
-    "@typescript-eslint/eslint-plugin": "^5.51.0",
-    "@typescript-eslint/parser": "^5.51.0",
-    "ava": "^5.2.0",
-    "c8": "^7.12.0",
+    "@eslint/js": "^9.26.0",
+    "@types/node": "^22.15.3",
+    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/ui": "^4.0.18",
     "cross-env": "^7.0.3",
-    "eslint": "^8.34.0",
-    "rimraf": "^4.1.2",
-    "ts-node": "^10.9.1",
-    "typedoc": "^0.23.25",
-    "typescript": "^4.9.5"
+    "eslint": "^9.26.0",
+    "rimraf": "^6.0.1",
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.28.3",
+    "typescript": "^5.8.3",
+    "typescript-eslint": "^8.31.1",
+    "vitest": "^4.0.18"
   }
 }