@nejs/basic-extensions 2.5.0 → 2.6.0

package/dist/cjs/arrayextensions.js

@@ -11,61 +11,63 @@ const extension_1 = require("@nejs/extension");
  * operations on arrays and makes code more expressive and concise.
  */
 exports.ArrayPrototypeExtensions = new extension_1.Patch(Array.prototype, {
-    /**
-     * Sometimes defining even a short function for the invocation of `find`
-     * can be troublesome. This helper function performs that job for you. If
-     * the specified element is in the array, `true` will be returned.
-     *
-     * @param {*} value the value to search for. This value must triple equals
-     * the array element in order to return true.
-     * @returns true if the exact element exists in the array, false otherwise
-     */
-    contains(value) {
-        return !!this.find(entry => entry === value);
-    },
-    /**
-     * The `findEntry` function searches the entries of the object and returns
-     * the `[index, value]` entry array for the first matching value found.
-     *
-     * @param {function} findFn a function that takes the element to be checked
-     * and returns a boolean value
-     * @returns if `findFn` returns `true`, an array with two elements, the first
-     * being the index, the second being the value, is returned.
-     */
-    findEntry(findFn) {
-        const entries = this.entries();
-        const VALUE = 1;
-        for (let entry of entries) {
-            if (findFn(entry[VALUE])) {
-                return entry;
+    [extension_1.Patch.kMutablyHidden]: {
+        /**
+         * Sometimes defining even a short function for the invocation of `find`
+         * can be troublesome. This helper function performs that job for you. If
+         * the specified element is in the array, `true` will be returned.
+         *
+         * @param {*} value the value to search for. This value must triple equals
+         * the array element in order to return true.
+         * @returns true if the exact element exists in the array, false otherwise
+         */
+        contains(value) {
+            return !!this.find(entry => entry === value);
+        },
+        /**
+         * The `findEntry` function searches the entries of the object and returns
+         * the `[index, value]` entry array for the first matching value found.
+         *
+         * @param {function} findFn a function that takes the element to be checked
+         * and returns a boolean value
+         * @returns if `findFn` returns `true`, an array with two elements, the first
+         * being the index, the second being the value, is returned.
+         */
+        findEntry(findFn) {
+            const entries = this.entries();
+            const VALUE = 1;
+            for (let entry of entries) {
+                if (findFn(entry[VALUE])) {
+                    return entry;
+                }
             }
-        }
-        return undefined;
-    },
-    /**
-     * A getter property that returns the first element of the array. If the
-     * array is empty, it returns `undefined`. This property is useful for
-     * scenarios where you need to quickly access the first item of an array
-     * without the need for additional checks or method calls.
-     *
-     * @returns {*} The first element of the array or `undefined` if the array
-     * is empty.
-     */
-    get first() {
-        return this[0];
-    },
-    /**
-     * A getter property that returns the last element of the array. It
-     * calculates the last index based on the array's length. If the array is
-     * empty, it returns `undefined`. This property is beneficial when you need
-     * to access the last item in an array, improving code readability and
-     * avoiding manual index calculation.
-     *
-     * @returns {*} The last element of the array or `undefined` if the
-     * array is empty.
-     */
-    get last() {
-        return this[this.length - 1];
+            return undefined;
+        },
+        /**
+         * A getter property that returns the first element of the array. If the
+         * array is empty, it returns `undefined`. This property is useful for
+         * scenarios where you need to quickly access the first item of an array
+         * without the need for additional checks or method calls.
+         *
+         * @returns {*} The first element of the array or `undefined` if the array
+         * is empty.
+         */
+        get first() {
+            return this[0];
+        },
+        /**
+         * A getter property that returns the last element of the array. It
+         * calculates the last index based on the array's length. If the array is
+         * empty, it returns `undefined`. This property is beneficial when you need
+         * to access the last item in an array, improving code readability and
+         * avoiding manual index calculation.
+         *
+         * @returns {*} The last element of the array or `undefined` if the
+         * array is empty.
+         */
+        get last() {
+            return this[this.length - 1];
+        },
     },
 });
 //# sourceMappingURL=arrayextensions.js.map

package/dist/cjs/arrayextensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"arrayextensions.js","sourceRoot":"","sources":["../../src/arrayextensions.js"],"names":[],"mappings":";;;AAAA,+CAAuC;AAEvC;;;;;;;GAOG;AACU,QAAA,wBAAwB,GAAG,IAAI,iBAAK,CAAC,KAAK,CAAC,SAAS,EAAE;IACjE;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK;QACZ,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IAC9C,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;QAC9B,MAAM,KAAK,GAAG,CAAC,CAAA;QAEf,KAAK,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACzB,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;CAEF,CAAC,CAAA"}
+{"version":3,"file":"arrayextensions.js","sourceRoot":"","sources":["../../src/arrayextensions.js"],"names":[],"mappings":";;;AAAA,+CAAuC;AAEvC;;;;;;;GAOG;AACU,QAAA,wBAAwB,GAAG,IAAI,iBAAK,CAAC,KAAK,CAAC,SAAS,EAAE;IACjE,CAAC,iBAAK,CAAC,cAAc,CAAC,EAAE;QACtB;;;;;;;;WAQG;QACH,QAAQ,CAAC,KAAK;YACZ,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;QAC9C,CAAC;QAED;;;;;;;;WAQG;QACH,SAAS,CAAC,MAAM;YACd,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,CAAA;YAC9B,MAAM,KAAK,GAAG,CAAC,CAAA;YAEf,KAAK,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;oBACzB,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAA;QAClB,CAAC;QAED;;;;;;;;WAQG;QACH,IAAI,KAAK;YACP,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;QAED;;;;;;;;;WASG;QACH,IAAI,IAAI;YACN,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;KACF;CACF,CAAC,CAAA"}

package/dist/cjs/functionextensions.js

@@ -116,85 +116,87 @@ exports.FunctionExtensions = new extension_1.Patch(Function, {
     },
 });
 exports.FunctionPrototypeExtensions = new extension_1.Patch(Function.prototype, {
-    /**
-     * Determines if a given value is an asynchronous function. It checks if the
-     * value is an instance of `Function` and if its string representation
-     * includes the keyword 'Async'. This method is particularly useful for
-     * identifying async functions.
-     *
-     * @returns {boolean} Returns `true` if the value is an async function,
-     * otherwise `false`.
-     */
-    get isAsync() {
-        return Function.isAsync(this);
-    },
-    /**
-     * The function checks if a given value is an async generator function
-     *
-     * @returns {boolean} `true` if the value is an instance of a function and
-     * its string tag is 'AsyncGeneratorFunction', otherwise it returns `false`.
-     */
-    get isAsyncGenerator() {
-        return Function.isAsyncGenerator(this);
-    },
-    /**
-     * Checks if a given value is an arrow function. It verifies if the value is
-     * an instance of `Function`, if its string representation includes the '=>'
-     * symbol, and if it lacks a prototype, which is a characteristic of arrow
-     * functions in JavaScript.
-     *
-     * @returns {boolean} Returns `true` if the value is an arrow function,
-     * otherwise `false`.
-     */
-    get isBigArrow() {
-        return Function.isBigArrow(this);
-    },
-    /**
-     * Determines if a given value is a bound function. Bound functions are
-     * created using the `Function.prototype.bind` method, which allows setting
-     * the `this` value at the time of binding. This method checks if the value
-     * is an instance of `Function`, if its string representation starts with
-     * 'bound', and if it lacks a `prototype` property. These characteristics
-     * are indicative of bound functions in JavaScript.
-     *
-     * @returns {boolean} Returns `true` if the value is a bound function,
-     * otherwise `false`. Bound functions have a specific format in their
-     * string representation and do not have their own `prototype` property.
-     */
-    get isBound() {
-        return Function.isBound(this);
-    },
-    /**
-     * Determines if a given value is a class. It checks if the value is an
-     * instance of `Function` and if its string representation includes the
-     * keyword 'class'. This method is useful for distinguishing classes from
-     * other function types in JavaScript.
-     *
-     * @returns {boolean} Returns `true` if the value is a class, otherwise
-     * `false`.
-     */
-    get isClass() {
-        return Function.isClass(this);
-    },
-    /**
-     * Checks if a given value is a regular function. This method verifies if
-     * the value is an instance of `Function`, which includes regular functions,
-     * classes, and async functions but excludes arrow functions.
-     *
-     * @returns {boolean} Returns `true` if the value is a regular function,
-     * otherwise `false`.
-     */
-    get isFunction() {
-        return Function.isFunction(this);
-    },
-    /**
-     * The function checks if a given value is a generator function
-     *
-     * @returns {boolean} `true` if the value is an instance of a function and
-     * its string tag is 'GeneratorFunction', otherwise it returns `false`.
-     */
-    get isGenerator() {
-        return Function.isGenerator(this);
+    [extension_1.Patch.kMutablyHidden]: {
+        /**
+         * Determines if a given value is an asynchronous function. It checks if the
+         * value is an instance of `Function` and if its string representation
+         * includes the keyword 'Async'. This method is particularly useful for
+         * identifying async functions.
+         *
+         * @returns {boolean} Returns `true` if the value is an async function,
+         * otherwise `false`.
+         */
+        get isAsync() {
+            return Function.isAsync(this);
+        },
+        /**
+         * The function checks if a given value is an async generator function
+         *
+         * @returns {boolean} `true` if the value is an instance of a function and
+         * its string tag is 'AsyncGeneratorFunction', otherwise it returns `false`.
+         */
+        get isAsyncGenerator() {
+            return Function.isAsyncGenerator(this);
+        },
+        /**
+         * Checks if a given value is an arrow function. It verifies if the value is
+         * an instance of `Function`, if its string representation includes the '=>'
+         * symbol, and if it lacks a prototype, which is a characteristic of arrow
+         * functions in JavaScript.
+         *
+         * @returns {boolean} Returns `true` if the value is an arrow function,
+         * otherwise `false`.
+         */
+        get isBigArrow() {
+            return Function.isBigArrow(this);
+        },
+        /**
+         * Determines if a given value is a bound function. Bound functions are
+         * created using the `Function.prototype.bind` method, which allows setting
+         * the `this` value at the time of binding. This method checks if the value
+         * is an instance of `Function`, if its string representation starts with
+         * 'bound', and if it lacks a `prototype` property. These characteristics
+         * are indicative of bound functions in JavaScript.
+         *
+         * @returns {boolean} Returns `true` if the value is a bound function,
+         * otherwise `false`. Bound functions have a specific format in their
+         * string representation and do not have their own `prototype` property.
+         */
+        get isBound() {
+            return Function.isBound(this);
+        },
+        /**
+         * Determines if a given value is a class. It checks if the value is an
+         * instance of `Function` and if its string representation includes the
+         * keyword 'class'. This method is useful for distinguishing classes from
+         * other function types in JavaScript.
+         *
+         * @returns {boolean} Returns `true` if the value is a class, otherwise
+         * `false`.
+         */
+        get isClass() {
+            return Function.isClass(this);
+        },
+        /**
+         * Checks if a given value is a regular function. This method verifies if
+         * the value is an instance of `Function`, which includes regular functions,
+         * classes, and async functions but excludes arrow functions.
+         *
+         * @returns {boolean} Returns `true` if the value is a regular function,
+         * otherwise `false`.
+         */
+        get isFunction() {
+            return Function.isFunction(this);
+        },
+        /**
+         * The function checks if a given value is a generator function
+         *
+         * @returns {boolean} `true` if the value is an instance of a function and
+         * its string tag is 'GeneratorFunction', otherwise it returns `false`.
+         */
+        get isGenerator() {
+            return Function.isGenerator(this);
+        },
     },
 });
 //# sourceMappingURL=functionextensions.js.map

package/dist/cjs/functionextensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functionextensions.js","sourceRoot":"","sources":["../../src/functionextensions.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"functionextensions.js","sourceRoot":"","sources":["../../src/functionextensions.js"],"names":[],"mappings":"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"}

package/dist/cjs/mapextensions.js

@@ -3,28 +3,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapPrototypeExtensions = void 0;
 const extension_1 = require("@nejs/extension");
 exports.MapPrototypeExtensions = new extension_1.Patch(Map.prototype, {
-    /**
-     * The function `getKey` returns the key associated with a given value
-     * in a map.
-     *
-     * @param {any} value - The value parameter is the value that you want to
-     * find the corresponding key for in the map.
-     * @param [strict=true] - The "strict" parameter is a boolean value that
-     * determines whether strict equality (===) or loose equality (==) should
-     * be used when comparing the "value" parameter with the values in the
-     * entries of the object. If "strict" is set to true, strict equality will
-     * be used.
-     * @returns the key associated with the given value. If a matching key is
-     * found, it is returned. If no matching key is found, null is returned.
-     */
-    getKey(value, strict = true) {
-        for (const [key, entryValue] of this) {
-            if ((strict && value === entryValue) &&
-                (!strict && value == entryValue)) {
-                return key;
+    [extension_1.Patch.kMutablyHidden]: {
+        /**
+         * The function `getKey` returns the key associated with a given value
+         * in a map.
+         *
+         * @param {any} value - The value parameter is the value that you want to
+         * find the corresponding key for in the map.
+         * @param [strict=true] - The "strict" parameter is a boolean value that
+         * determines whether strict equality (===) or loose equality (==) should
+         * be used when comparing the "value" parameter with the values in the
+         * entries of the object. If "strict" is set to true, strict equality will
+         * be used.
+         * @returns the key associated with the given value. If a matching key is
+         * found, it is returned. If no matching key is found, null is returned.
+         */
+        getKey(value, strict = true) {
+            for (const [key, entryValue] of this) {
+                if ((strict && value === entryValue) &&
+                    (!strict && value == entryValue)) {
+                    return key;
+                }
+                return null;
             }
-            return null;
-        }
+        },
     },
 });
 //# sourceMappingURL=mapextensions.js.map

package/dist/cjs/mapextensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapextensions.js","sourceRoot":"","sources":["../../src/mapextensions.js"],"names":[],"mappings":";;;AAAA,+CAAwC;AAE3B,QAAA,sBAAsB,GAAG,IAAI,iBAAK,CAAC,GAAG,CAAC,SAAS,EAAE;IAC7D;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;QACzB,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;YACrC,IACE,CAAC,MAAM,IAAI,KAAK,KAAK,UAAU,CAAC;gBAChC,CAAC,CAAC,MAAM,IAAI,KAAK,IAAI,UAAU,CAAC,EAChC,CAAC;gBACD,OAAO,GAAG,CAAA;YACZ,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"mapextensions.js","sourceRoot":"","sources":["../../src/mapextensions.js"],"names":[],"mappings":";;;AAAA,+CAAwC;AAE3B,QAAA,sBAAsB,GAAG,IAAI,iBAAK,CAAC,GAAG,CAAC,SAAS,EAAE;IAC7D,CAAC,iBAAK,CAAC,cAAc,CAAC,EAAE;QACtB;;;;;;;;;;;;;WAaG;QACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;YACzB,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrC,IACE,CAAC,MAAM,IAAI,KAAK,KAAK,UAAU,CAAC;oBAChC,CAAC,CAAC,MAAM,IAAI,KAAK,IAAI,UAAU,CAAC,EAChC,CAAC;oBACD,OAAO,GAAG,CAAA;gBACZ,CAAC;gBAED,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC;KACF;CACF,CAAC,CAAA"}

package/dist/cjs/objectextensions.js

@@ -178,23 +178,55 @@ exports.ObjectExtensions = new extension_1.Patch(Object, {
         return result;
     },
 });
+const staticPatches = exports.ObjectExtensions.patches;
 exports.ObjectPrototypeExtensions = new extension_1.Patch(Object.prototype, {
-    /**
-     * Strips an object down to only the keys specified. Optionally, any
-     * accessors can be made to retain their context on the source object.
-     * This is a passthrough to the static {@link Object.stripTo} function
-     *
-     * @param {Array<string|symbol>} keys the keys that should appear in the
-     * final reduced object
-     * @param {boolean} [bindAccessors = true] if this value is true then any
-     * accessors from the source object will continue to have their `this`
-     * value bound to the source. If the getter or setter on that object is
-     * defined using an arrow function, this will not work as intended.
-     * @returns {object} an object containing only the keys and symbols
-     * specified in the `keys` parameter.
-     */
-    stripTo(keys, bindAccessors = true) {
-        return Object.stripTo(this, keys, bindAccessors);
-    }
+    [extension_1.Patch.kMutablyHidden](store) {
+        return {
+            /**
+             * Checks to see if the supplied `value` is both an object, and has the
+             * appropriate symbol defined.
+             *
+             * @param {any} value the value to determine if it contains a defined
+             * `Symbol.toStringTag` defined.
+             * @returns true if the symbol is defined, false otherwise
+             */
+            get hasStringTag() {
+                return staticPatches.hasStringTag(this);
+            },
+            /**
+             * Retrieves the string tag of an object. The string tag is a representation
+             * of the object's type, as defined by its `Object.prototype.toString`
+             * method. This utility method is helpful for getting a more descriptive
+             * type of an object than what is returned by the `typeof` operator,
+             * especially for custom objects.
+             *
+             * @param {*} value - The object whose string tag is to be retrieved.
+             * @param {boolean} strict - if this is set to true, undefined will be
+             * returned whenever a supplied object does not have a
+             * `Symbol.toStringTag` defined, period. if false, the default,
+             * @returns {string} - The string tag of the object, indicating its type.
+             */
+            getStringTag(strict = false) {
+                return staticPatches.getStringTag(this, strict);
+            },
+            /**
+             * Strips an object down to only the keys specified. Optionally, any
+             * accessors can be made to retain their context on the source object.
+             * This is a passthrough to the static {@link Object.stripTo} function
+             *
+             * @param {Array<string|symbol>} keys the keys that should appear in the
+             * final reduced object
+             * @param {boolean} [bindAccessors = true] if this value is true then any
+             * accessors from the source object will continue to have their `this`
+             * value bound to the source. If the getter or setter on that object is
+             * defined using an arrow function, this will not work as intended.
+             * @returns {object} an object containing only the keys and symbols
+             * specified in the `keys` parameter.
+             */
+            stripTo(keys, bindAccessors = true) {
+                return Object.stripTo(this, keys, bindAccessors);
+            }
+        };
+    },
 });
 //# sourceMappingURL=objectextensions.js.map

package/dist/cjs/objectextensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"objectextensions.js","sourceRoot":"","sources":["../../src/objectextensions.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"objectextensions.js","sourceRoot":"","sources":["../../src/objectextensions.js"],"names":[],"mappings":"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"}