@nejs/basic-extensions 1.6.1 → 1.7.0

package/dist/mjs/index.d.ts

@@ -1,19 +1,10 @@
-export function enableAll(owners: any): void;
-export function enableNetNew(): void;
-export function disableAll(owners: any): void;
-export function disableNetNew(): void;
-export const all: {};
-import { ObjectExtensions } from './objectextensions.js';
-import { FunctionExtensions } from './functionextensions.js';
-import { ReflectExtensions } from './reflectextensions.js';
-import { StringExtensions } from './stringextensions.js';
-import { SymbolExtensions } from './symbolextensions.js';
-import { ArrayPrototypeExtensions } from './arrayextensions.js';
-import { GlobalFunctionsAndProps } from './globals.js';
-import { DescriptorExtensions } from './descriptor.js';
-import { AsyncIterableExtensions } from './asyncIterable.js';
-import { AsyncIteratorExtensions } from './asyncIterable.js';
-import { IterableExtensions } from './iterable.js';
-import { IteratorExtensions } from './iterable.js';
-import { RefSetExtensions } from './refset.js';
-export { ObjectExtensions, FunctionExtensions, ReflectExtensions, StringExtensions, SymbolExtensions, ArrayPrototypeExtensions, GlobalFunctionsAndProps, DescriptorExtensions, AsyncIterableExtensions, AsyncIteratorExtensions, IterableExtensions, IteratorExtensions, RefSetExtensions };
+export const all: any;
+export default results;
+declare namespace results {
+    export { Extensions as extensions };
+    export { Patches as patches };
+    export { all };
+}
+export const Extensions: {};
+export const Patches: Map<Object, import("@nejs/extension").Patch>;
+export const Controls: {};

package/dist/mjs/index.js

@@ -1,76 +1,83 @@
 import { FunctionExtensions } from './functionextensions.js';
-import { ObjectExtensions } from './objectextensions.js';
+import { ObjectExtensions, ObjectPrototypeExtensions } from './objectextensions.js';
+import { MapPrototypeExtensions } from './mapextensions.js';
 import { ReflectExtensions } from './reflectextensions.js';
 import { StringExtensions } from './stringextensions.js';
 import { SymbolExtensions } from './symbolextensions.js';
 import { ArrayPrototypeExtensions } from './arrayextensions.js';
-import { DescriptorExtensions } from './descriptor.js';
+import { DescriptorExtensions, Descriptor } from './newClasses/descriptor.js';
 import { GlobalFunctionsAndProps } from './globals.js';
-import { RefSetExtensions } from './refset.js';
-import { AsyncIteratorExtensions, AsyncIterableExtensions } from './asyncIterable.js';
-import { IteratorExtensions, IterableExtensions } from './iterable.js';
-import { Patch } from '@nejs/extension';
-const Owners = [
-    Object,
-    Function,
-    Reflect,
-    String,
-    Symbol,
-    Array.prototype,
-];
-const NetNew = [
-    GlobalFunctionsAndProps,
-    DescriptorExtensions,
-    AsyncIterableExtensions,
-    AsyncIteratorExtensions,
-    IterableExtensions,
-    IteratorExtensions,
-    RefSetExtensions,
-];
-export function enableAll(owners) {
-    const list = owners || Owners;
-    if (!list) {
-        throw new Error('Unable to enable features without owners list');
-    }
-    list.forEach(owner => {
-        Patch.enableFor(owner);
-    });
-    enableNetNew();
-}
-export function enableNetNew() {
-    NetNew.forEach(extension => { extension.apply(); });
-}
-export function disableAll(owners) {
-    const list = owners || Owners;
-    if (!list) {
-        throw new Error('Unable to disable features without owners list');
-    }
-    list.forEach(owner => {
-        Patch.disableFor(owner);
-    });
-    disableNetNew();
-}
-export function disableNetNew() {
-    NetNew.forEach(extension => { extension.revert(); });
-}
+import { RefSetExtensions } from './newClasses/refset.js';
+import { RefMapExtensions } from './newClasses/refmap.js';
+import { AsyncIteratorExtensions, AsyncIterableExtensions } from './newClasses/asyncIterable.js';
+import { IteratorExtensions, IterableExtensions } from './newClasses/iterable.js';
+const Patches = new Map([
+    [Object, ObjectExtensions],
+    [Function, FunctionExtensions],
+    [Reflect, ReflectExtensions],
+    [String, StringExtensions],
+    [Symbol, SymbolExtensions],
+    [Object.prototype, ObjectPrototypeExtensions],
+    [Array.prototype, ArrayPrototypeExtensions],
+    [Map.prototype, MapPrototypeExtensions],
+    [globalThis, GlobalFunctionsAndProps],
+]);
+const Extensions = {
+    [DescriptorExtensions.key]: DescriptorExtensions,
+    [AsyncIterableExtensions.key]: AsyncIterableExtensions,
+    [AsyncIteratorExtensions.key]: AsyncIteratorExtensions,
+    [IterableExtensions.key]: IterableExtensions,
+    [IteratorExtensions.key]: IteratorExtensions,
+    [RefSetExtensions.key]: RefSetExtensions,
+    [RefMapExtensions.key]: RefMapExtensions,
+};
+const Controls = {};
+Object.assign(Controls, {
+    enableAll() {
+        Controls.enablePatches();
+        Controls.enableExtensions();
+    },
+    enablePatches() {
+        Patches.forEach((extension) => { extension.apply(); });
+    },
+    enableExtensions() {
+        Object.values(Extensions).forEach((extension) => { extension.apply(); });
+    },
+    disableAll(owners) {
+        Controls.disablePatches();
+        Controls.disableExtensions();
+    },
+    disablePatches() {
+        Patches.forEach((extension) => { extension.revert(); });
+    },
+    disableExtensions() {
+        Object.values(Extensions).forEach((extension) => { extension.revert(); });
+    },
+});
 export const all = (() => {
-    let extensions = [
-        ObjectExtensions,
-        FunctionExtensions,
-        ReflectExtensions,
-        StringExtensions,
-        SymbolExtensions,
-        ArrayPrototypeExtensions,
-        GlobalFunctionsAndProps,
-        DescriptorExtensions,
+    const extensions = [
+        ...Array.from(Patches.values()),
+        ...Array.from(Object.values(Extensions)),
     ];
     const dest = extensions.reduce((accumulator, extension) => {
         Reflect.ownKeys(extension.patchEntries).reduce((_, key) => {
-            accumulator[key] = extension.patchEntries[key].computed;
+            const entry = extension.patchEntries[key];
+            if (entry.isAccessor)
+                accumulator[key] = new Descriptor(entry.descriptor);
+            else
+                accumulator[key] = entry.computed;
             return accumulator;
         }, accumulator);
         return accumulator;
     }, {});
     return dest;
 })();
-export { ObjectExtensions, FunctionExtensions, ReflectExtensions, StringExtensions, SymbolExtensions, ArrayPrototypeExtensions, GlobalFunctionsAndProps, DescriptorExtensions, AsyncIterableExtensions, AsyncIteratorExtensions, IterableExtensions, IteratorExtensions, RefSetExtensions, };
+const results = {
+    ...Controls,
+    extensions: Extensions,
+    patches: Patches,
+    all,
+};
+export default results;
+export { Extensions, Patches, Controls, };
+//# sourceMappingURL=index.js.map

package/dist/mjs/index.js.map

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

package/dist/mjs/mapextensions.d.ts

@@ -0,0 +1,2 @@
+export const MapPrototypeExtensions: Patch;
+import { Patch } from '@nejs/extension';

package/dist/mjs/mapextensions.js

@@ -0,0 +1,27 @@
+import { Patch } from '@nejs/extension';
+export const MapPrototypeExtensions = new 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;
+            }
+            return null;
+        }
+    },
+});
+//# sourceMappingURL=mapextensions.js.map

package/dist/mjs/mapextensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapextensions.js","sourceRoot":"","sources":["../../src/mapextensions.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,KAAK,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"}

package/dist/mjs/newClasses/asyncIterable.d.ts

@@ -0,0 +1,123 @@
+/**
+ * The AsyncIterable class extends the concept of Iterable to asynchronous
+ * operations. It allows creating iterable objects where each element can be
+ * an asynchronous entity, like a Promise. This class is particularly useful
+ * when dealing with asynchronous data sources, such as API responses, file
+ * reading in chunks, or any other data that is not immediately available but
+ * arrives over time.
+ */
+export class AsyncIterable {
+    /**
+     * Checks if a given value is an async iterable. This method determines if
+     * the provided value has a `Symbol.asyncIterator` property that is an async
+     * generator function. It's a precise way to identify if the value conforms
+     * to the async iterable protocol using an async generator function.
+     *
+     * Note: This method specifically checks for async generator functions. Some
+     * async iterables might use regular async functions that return an async
+     * iterator, which this method won't identify.
+     *
+     * @param {*} value - The value to be checked for async iterability.
+     * @returns {boolean} - Returns true if the value is an async iterable
+     * implemented using an async generator function, false otherwise.
+     */
+    static isAsyncIterable(value: any): boolean;
+    /**
+     * Constructs an instance of AsyncIterable. Similar to Iterable, it can be
+     * initialized with either an iterable object or individual elements. The
+     * elements can be promises, direct values, or a mix of both. If the first
+     * argument is an iterable, the instance is initialized with the elements
+     * from the iterable, followed by any additional arguments. If the first
+     * argument is not an iterable, all arguments are treated as individual
+     * elements.
+     *
+     * @param {Iterable|Promise|*} elementsOrFirstElement - An iterable object,
+     * a Promise, or the first element.
+     * @param {...Promise|*} moreElements - Additional elements if the first
+     * argument is not an iterable.
+     */
+    constructor(elementsOrFirstElement: Iterable<any> | Promise<any> | any, ...moreElements: (Promise<any> | any)[]);
+    /**
+     * Implements the async iterable protocol. When an instance of AsyncIterable
+     * is used in a `for await...of` loop, this async generator function is
+     * invoked. It yields each element as a Promise, allowing asynchronous
+     * iteration. Elements that are not Promises are automatically wrapped in
+     * a resolved Promise to ensure consistency.
+     *
+     * @returns {AsyncGenerator} An async generator that yields each element as
+     * a Promise.
+     */
+    [Symbol.asyncIterator](): AsyncGenerator;
+    /**
+     * Ensures that the constructor of this object instance's name
+     * is returned if the string tag for this instance is queried
+     *
+     * @returns {string} the name of the class
+     */
+    get [Symbol.toStringTag](): string;
+    #private;
+}
+/**
+ * Being able to create a compliant `AsyncIterator` around any type of
+ * iterable object. This can be wrapped around any type of object that
+ * has a `[Symbol.asyncIterator]` property assigned to a generator
+ * function.
+ */
+export class AsyncIterator {
+    /**
+     * Creates a new `AsyncIterator` object instance.
+     *
+     * @param {object} asyncIterable any object that has a
+     * `[Symbol.asyncIterable]` property assigned to a generator function.
+     */
+    constructor(asyncIterable: object);
+    /**
+     * Returns a new `Array` derived from the iterable this object
+     * wraps.
+     *
+     * @returns {array} a new `Array` generated from the wrapped
+     * iterable. The method is generated from using an async for of
+     * loop.
+     */
+    asArray(): any[];
+    /**
+     * Returns the actual iterable object passed to the constructor that
+     * created this instance.
+     *
+     * @returns {object} the object containing the `[Symbol.iterator]`
+     */
+    get asyncIterable(): object;
+    /**
+     * The function retrieves the next value in the iterator. If the
+     * the iterator has run its course, `reset()` can be invoked to
+     * reset the pointer to the beginning of the iteration.
+     *
+     * @returns {any} the next value
+     */
+    next(): any;
+    /**
+     * Resets the async iterator to the beginning allowing it to be
+     * iterated over again.
+     */
+    reset(): Promise<void>;
+    /**
+     * The existence of this symbol on the object instances, indicates that
+     * it can be used in `for(.. of ..)` loops and its values can be
+     * extracted from calls to `Array.from()`
+     *
+     * @returns {AsyncIterable} this is returned since this object is already
+     * conforming to the expected JavaScript AsyncIterator interface
+     */
+    [Symbol.asyncIterator](): AsyncIterable;
+    /**
+     * Ensures that the constructor of this object instance's name
+     * is returned if the string tag for this instance is queried
+     *
+     * @returns {string} the name of the class
+     */
+    get [Symbol.toStringTag](): string;
+    #private;
+}
+export const AsyncIterableExtensions: Extension;
+export const AsyncIteratorExtensions: Extension;
+import { Extension } from '@nejs/extension';

package/dist/mjs/{asyncIterable.js → newClasses/asyncIterable.js}

@@ -7,7 +7,7 @@ import { Extension } from '@nejs/extension';
  * reading in chunks, or any other data that is not immediately available but
  * arrives over time.
  */
-class AsyncIterable {
+export class AsyncIterable {
     /**
      * Private field to store the elements of the async iterable.
      * @private
@@ -62,109 +62,6 @@ class AsyncIterable {
     get [Symbol.toStringTag]() {
         return this.constructor.name;
     }
-    /**
-     * Being able to create a compliant `AsyncIterator` around any type of
-     * iterable object. This can be wrapped around any type of object that
-     * has a `[Symbol.asyncIterator]` property assigned to a generator
-     * function.
-     */
-    static AsyncIterator = class AsyncIterator {
-        /**
-         * Creates a new `AsyncIterator` object instance.
-         *
-         * @param {object} asyncIterable any object that has a
-         * `[Symbol.asyncIterable]` property assigned to a generator function.
-         */
-        constructor(asyncIterable) {
-            if (!asyncIterable || !Reflect.has(asyncIterable, Symbol.asyncIterator)) {
-                throw new TypeError('Value used to instantiate AsyncIterator is not an async iterable');
-            }
-            this.#asyncIterable = asyncIterable;
-            this.#asyncIterator = asyncIterable[Symbol.asyncIterator]();
-        }
-        /**
-         * Returns a new `Array` derived from the iterable this object
-         * wraps.
-         *
-         * @returns {array} a new `Array` generated from the wrapped
-         * iterable. The method is generated from using an async for of
-         * loop.
-         */
-        async asArray() {
-            const array = [];
-            for await (const value of this) {
-                array.push(value);
-            }
-            return array;
-        }
-        /**
-         * Returns the actual iterable object passed to the constructor that
-         * created this instance.
-         *
-         * @returns {object} the object containing the `[Symbol.iterator]`
-         */
-        get asyncIterable() {
-            return this.#asyncIterable;
-        }
-        /**
-         * The function retrieves the next value in the iterator. If the
-         * the iterator has run its course, `reset()` can be invoked to
-         * reset the pointer to the beginning of the iteration.
-         *
-         * @returns {any} the next value
-         */
-        async next() {
-            const result = await this.#asyncIterator.next();
-            if (result.done) {
-                return { value: undefined, done: true };
-            }
-            else {
-                return { value: result.value, done: false };
-            }
-        }
-        /**
-         * Resets the async iterator to the beginning allowing it to be
-         * iterated over again.
-         */
-        async reset() {
-            this.#asyncIterator = this.#asyncIterable[Symbol.asyncIterator]();
-        }
-        /**
-         * The existence of this symbol on the object instances, indicates that
-         * it can be used in `for(.. of ..)` loops and its values can be
-         * extracted from calls to `Array.from()`
-         *
-         * @returns {AsyncIterable} this is returned since this object is already
-         * conforming to the expected JavaScript AsyncIterator interface
-         */
-        [Symbol.asyncIterator]() {
-            return this;
-        }
-        /**
-         * Ensures that the constructor of this object instance's name
-         * is returned if the string tag for this instance is queried
-         *
-         * @returns {string} the name of the class
-         */
-        get [Symbol.toStringTag]() {
-            return this.constructor.name;
-        }
-        /**
-         * The object from which its iterator functionality is derived.
-         *
-         * @type {object}
-         * @private
-         */
-        #asyncIterable = null;
-        /**
-         * The results of a call to the iterable's `[Symbol.asyncIterator]`
-         * generator function.
-         *
-         * @type {object}
-         * @private
-         */
-        #asyncIterator = null;
-    };
     /**
      * Checks if a given value is an async iterable. This method determines if
      * the provided value has a `Symbol.asyncIterator` property that is an async
@@ -184,5 +81,109 @@ class AsyncIterable {
         return type === '[object AsyncGeneratorFunction]';
     }
 }
+/**
+ * Being able to create a compliant `AsyncIterator` around any type of
+ * iterable object. This can be wrapped around any type of object that
+ * has a `[Symbol.asyncIterator]` property assigned to a generator
+ * function.
+ */
+export class AsyncIterator {
+    /**
+     * Creates a new `AsyncIterator` object instance.
+     *
+     * @param {object} asyncIterable any object that has a
+     * `[Symbol.asyncIterable]` property assigned to a generator function.
+     */
+    constructor(asyncIterable) {
+        if (!asyncIterable || !Reflect.has(asyncIterable, Symbol.asyncIterator)) {
+            throw new TypeError('Value used to instantiate AsyncIterator is not an async iterable');
+        }
+        this.#asyncIterable = asyncIterable;
+        this.#asyncIterator = asyncIterable[Symbol.asyncIterator]();
+    }
+    /**
+     * Returns a new `Array` derived from the iterable this object
+     * wraps.
+     *
+     * @returns {array} a new `Array` generated from the wrapped
+     * iterable. The method is generated from using an async for of
+     * loop.
+     */
+    async asArray() {
+        const array = [];
+        for await (const value of this) {
+            array.push(value);
+        }
+        return array;
+    }
+    /**
+     * Returns the actual iterable object passed to the constructor that
+     * created this instance.
+     *
+     * @returns {object} the object containing the `[Symbol.iterator]`
+     */
+    get asyncIterable() {
+        return this.#asyncIterable;
+    }
+    /**
+     * The function retrieves the next value in the iterator. If the
+     * the iterator has run its course, `reset()` can be invoked to
+     * reset the pointer to the beginning of the iteration.
+     *
+     * @returns {any} the next value
+     */
+    async next() {
+        const result = await this.#asyncIterator.next();
+        if (result.done) {
+            return { value: undefined, done: true };
+        }
+        else {
+            return { value: result.value, done: false };
+        }
+    }
+    /**
+     * Resets the async iterator to the beginning allowing it to be
+     * iterated over again.
+     */
+    async reset() {
+        this.#asyncIterator = this.#asyncIterable[Symbol.asyncIterator]();
+    }
+    /**
+     * The existence of this symbol on the object instances, indicates that
+     * it can be used in `for(.. of ..)` loops and its values can be
+     * extracted from calls to `Array.from()`
+     *
+     * @returns {AsyncIterable} this is returned since this object is already
+     * conforming to the expected JavaScript AsyncIterator interface
+     */
+    [Symbol.asyncIterator]() {
+        return this;
+    }
+    /**
+     * Ensures that the constructor of this object instance's name
+     * is returned if the string tag for this instance is queried
+     *
+     * @returns {string} the name of the class
+     */
+    get [Symbol.toStringTag]() {
+        return this.constructor.name;
+    }
+    /**
+     * The object from which its iterator functionality is derived.
+     *
+     * @type {object}
+     * @private
+     */
+    #asyncIterable = null;
+    /**
+     * The results of a call to the iterable's `[Symbol.asyncIterator]`
+     * generator function.
+     *
+     * @type {object}
+     * @private
+     */
+    #asyncIterator = null;
+}
 export const AsyncIterableExtensions = new Extension(AsyncIterable);
-export const AsyncIteratorExtensions = new Extension(AsyncIterable.AsyncIterator);
+export const AsyncIteratorExtensions = new Extension(AsyncIterator);
+//# sourceMappingURL=asyncIterable.js.map

package/dist/mjs/newClasses/asyncIterable.js.map

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