@nejs/basic-extensions 1.7.0 → 1.9.0

package/dist/cjs/functionextensions.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FunctionExtensions = void 0;
+exports.FunctionPrototypeExtensions = exports.FunctionExtensions = void 0;
 const extension_1 = require("@nejs/extension");
+const objectextensions_js_1 = require("./objectextensions.js");
+const { getStringTag } = objectextensions_js_1.ObjectExtensions.patches;
 /**
  * The `FunctionExtensions` class is a patch applied to the built-in JavaScript
  * `Function` constructor. It extends `Function` with additional utility methods
@@ -12,6 +14,68 @@ const extension_1 = require("@nejs/extension");
  * capabilities of function handling and introspection in JavaScript.
  */
 exports.FunctionExtensions = new extension_1.Patch(Function, {
+    /**
+     * 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.
+     *
+     * @param {*} value - The value to be checked.
+     * @returns {boolean} Returns `true` if the value is an async function,
+     * otherwise `false`.
+     */
+    isAsync(value) {
+        const stringTag = /(\w+)]/g.exec(Object.prototype.toString.call(value))[1];
+        return (value instanceof Function &&
+            stringTag.includes('Async'));
+    },
+    /**
+     * The function checks if a given value is an async generator function
+     *
+     * @param {any} value - The `value` parameter is the value that we want to
+     * check if it is a generator function.
+     * @returns {boolean} `true` if the value is an instance of a function and
+     * its string tag is 'AsyncGeneratorFunction', otherwise it returns `false`.
+     */
+    isAsyncGenerator(value) {
+        const stringTag = getStringTag(value);
+        return (value instanceof Function &&
+            stringTag == 'AsyncGeneratorFunction');
+    },
+    /**
+     * 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.
+     *
+     * @param {*} value - The value to be checked.
+     * @returns {boolean} Returns `true` if the value is an arrow function,
+     * otherwise `false`.
+     */
+    isBigArrow(value) {
+        return (value instanceof Function &&
+            String(value).includes('=>') &&
+            !String(value).startsWith('bound') &&
+            !Reflect.has(value, 'prototype'));
+    },
+    /**
+     * 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.
+     *
+     * @param {*} value - The value to be checked, typically a function.
+     * @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.
+     */
+    isBound(value) {
+        return (value instanceof Function &&
+            String(value).startsWith('bound') &&
+            !Reflect.has(value, 'prototype'));
+    },
     /**
      * 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
@@ -35,22 +99,43 @@ exports.FunctionExtensions = new extension_1.Patch(Function, {
      * otherwise `false`.
      */
     isFunction(value) {
-        return value instanceof Function;
+        return value instanceof Function && !Function.isClass(value);
     },
+    /**
+     * The function checks if a given value is a generator function
+     *
+     * @param {any} value - The `value` parameter is the value that we want to
+     * check if it 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`.
+     */
+    isGenerator(value) {
+        const stringTag = getStringTag(value);
+        return (value instanceof Function &&
+            stringTag == 'GeneratorFunction');
+    },
+});
+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.
      *
-     * @param {*} value - The value to be checked.
      * @returns {boolean} Returns `true` if the value is an async function,
      * otherwise `false`.
      */
-    isAsync(value) {
-        const stringTag = /(\w+)]/g.exec(Object.prototype.toString.call(value))[1];
-        return (value instanceof Function &&
-            stringTag.includes('Async'));
+    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
@@ -58,15 +143,11 @@ exports.FunctionExtensions = new extension_1.Patch(Function, {
      * symbol, and if it lacks a prototype, which is a characteristic of arrow
      * functions in JavaScript.
      *
-     * @param {*} value - The value to be checked.
      * @returns {boolean} Returns `true` if the value is an arrow function,
      * otherwise `false`.
      */
-    isBigArrow(value) {
-        return (value instanceof Function &&
-            String(value).includes('=>') &&
-            !String(value).startsWith('bound') &&
-            !Reflect.has(value, 'prototype'));
+    get isBigArrow() {
+        return Function.isBigArrow(this);
     },
     /**
      * Determines if a given value is a bound function. Bound functions are
@@ -76,15 +157,44 @@ exports.FunctionExtensions = new extension_1.Patch(Function, {
      * 'bound', and if it lacks a `prototype` property. These characteristics
      * are indicative of bound functions in JavaScript.
      *
-     * @param {*} value - The value to be checked, typically a function.
      * @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.
      */
-    isBound(value) {
-        return (value instanceof Function &&
-            String(value).startsWith('bound') &&
-            !Reflect.has(value, 'prototype'));
+    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":";;;AAAA,+CAAuC;AAEvC;;;;;;;;GAQG;AACU,QAAA,kBAAkB,GAAG,IAAI,iBAAK,CAAC,QAAQ,EAAE;IACpD;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK;QACX,OAAO,KAAK,YAAY,QAAQ,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IACtE,CAAC;IAED;;;;;;;;OAQG;IACH,UAAU,CAAC,KAAK;QACd,OAAO,KAAK,YAAY,QAAQ,CAAC;IACnC,CAAC;IAED;;;;;;;;;OASG;IACH,OAAO,CAAC,KAAK;QACX,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1E,OAAO,CACL,KAAK,YAAY,QAAQ;YACzB,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC5B,CAAA;IACH,CAAC;IAED;;;;;;;;;OASG;IACH,UAAU,CAAC,KAAK;QACd,OAAO,CACL,KAAK,YAAY,QAAQ;YACzB,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC5B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;YAClC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CACjC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,KAAK;QACX,OAAO,CACL,KAAK,YAAY,QAAQ;YACzB,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC;YACjC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,CACjC,CAAA;IACH,CAAC;CACF,CAAC,CAAA"}
+{"version":3,"file":"functionextensions.js","sourceRoot":"","sources":["../../src/functionextensions.js"],"names":[],"mappings":"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"}

package/dist/cjs/index.d.ts

@@ -5,6 +5,9 @@ declare namespace results {
     export { Patches as patches };
     export { all };
 }
-export const Extensions: {};
-export const Patches: Map<Object, import("@nejs/extension").Patch>;
+export namespace Extensions {
+    export { GlobalFunctionsAndProps as global };
+}
+export const Patches: Map<any, any>;
 export const Controls: {};
+import { GlobalFunctionsAndProps } from './globals.js';

package/dist/cjs/index.js

@@ -4,6 +4,7 @@ exports.Controls = exports.Patches = exports.Extensions = exports.all = void 0;
 const functionextensions_js_1 = require("./functionextensions.js");
 const objectextensions_js_1 = require("./objectextensions.js");
 const mapextensions_js_1 = require("./mapextensions.js");
+const setextensions_js_1 = require("./setextensions.js");
 const reflectextensions_js_1 = require("./reflectextensions.js");
 const stringextensions_js_1 = require("./stringextensions.js");
 const symbolextensions_js_1 = require("./symbolextensions.js");
@@ -12,28 +13,38 @@ const descriptor_js_1 = require("./newClasses/descriptor.js");
 const globals_js_1 = require("./globals.js");
 const refset_js_1 = require("./newClasses/refset.js");
 const refmap_js_1 = require("./newClasses/refmap.js");
+const deferred_js_1 = require("./newClasses/deferred.js");
 const asyncIterable_js_1 = require("./newClasses/asyncIterable.js");
 const iterable_js_1 = require("./newClasses/iterable.js");
-const Patches = new Map([
+const StaticPatches = [
     [Object, objectextensions_js_1.ObjectExtensions],
     [Function, functionextensions_js_1.FunctionExtensions],
     [Reflect, reflectextensions_js_1.ReflectExtensions],
     [String, stringextensions_js_1.StringExtensions],
     [Symbol, symbolextensions_js_1.SymbolExtensions],
+];
+const InstancePatches = [
     [Object.prototype, objectextensions_js_1.ObjectPrototypeExtensions],
+    [Function.prototype, functionextensions_js_1.FunctionPrototypeExtensions],
     [Array.prototype, arrayextensions_js_1.ArrayPrototypeExtensions],
     [Map.prototype, mapextensions_js_1.MapPrototypeExtensions],
-    [globalThis, globals_js_1.GlobalFunctionsAndProps],
+    [Set.prototype, setextensions_js_1.SetPrototypeExtensions],
+];
+const Patches = new Map([
+    ...StaticPatches,
+    ...InstancePatches,
 ]);
 exports.Patches = Patches;
 const Extensions = {
-    [descriptor_js_1.DescriptorExtensions.key]: descriptor_js_1.DescriptorExtensions,
+    global: globals_js_1.GlobalFunctionsAndProps,
     [asyncIterable_js_1.AsyncIterableExtensions.key]: asyncIterable_js_1.AsyncIterableExtensions,
     [asyncIterable_js_1.AsyncIteratorExtensions.key]: asyncIterable_js_1.AsyncIteratorExtensions,
+    [deferred_js_1.DeferredExtension.key]: deferred_js_1.DeferredExtension,
+    [descriptor_js_1.DescriptorExtensions.key]: descriptor_js_1.DescriptorExtensions,
     [iterable_js_1.IterableExtensions.key]: iterable_js_1.IterableExtensions,
     [iterable_js_1.IteratorExtensions.key]: iterable_js_1.IteratorExtensions,
-    [refset_js_1.RefSetExtensions.key]: refset_js_1.RefSetExtensions,
     [refmap_js_1.RefMapExtensions.key]: refmap_js_1.RefMapExtensions,
+    [refset_js_1.RefSetExtensions.key]: refset_js_1.RefSetExtensions,
 };
 exports.Extensions = Extensions;
 const Controls = {};
@@ -46,16 +57,28 @@ Object.assign(Controls, {
     enablePatches() {
         Patches.forEach((extension) => { extension.apply(); });
     },
+    enableStaticPatches(filter = (extension) => true) {
+        StaticPatches.filter(filter).forEach(extension => extension.apply());
+    },
+    enableInstancePatches(filter = (extension) => true) {
+        InstancePatches.filter(filter).forEach(extension => extension.apply());
+    },
     enableExtensions() {
         Object.values(Extensions).forEach((extension) => { extension.apply(); });
     },
-    disableAll(owners) {
+    disableAll() {
         Controls.disablePatches();
         Controls.disableExtensions();
     },
     disablePatches() {
         Patches.forEach((extension) => { extension.revert(); });
     },
+    disableStaticPatches(filter = (extension) => true) {
+        StaticPatches.filter(filter).forEach(extension => extension.revert());
+    },
+    disableInstancePatches(filter = (extension) => true) {
+        InstancePatches.filter(filter).forEach(extension => extension.revert());
+    },
     disableExtensions() {
         Object.values(Extensions).forEach((extension) => { extension.revert(); });
     },

package/dist/cjs/index.js.map

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

package/dist/cjs/newClasses/deferred.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Deferreds, which were first introduced by jQuery for browsers in the early
+ * 2000s, are a way to manage asynchronous operations. They have been widely
+ * used and replicated by engineers since then. Although the Promise class in
+ * modern JavaScript provides a static method called `withResolvers` that
+ * returns an object with similar properties to a Deferred, it is not directly
+ * supported by Node.js.
+ *
+ * ```
+ * const withResolvers = Promise.withResolvers()
+ * Reflect.has(withResolvers, 'promise') // true
+ * Reflect.has(withResolvers, 'resolve') // true
+ * Reflect.has(withResolvers, 'reject')  // true
+ * ```
+ *
+ * This Deferred class extends the Promise class, allowing it to capture the
+ * value or reason for easy access after resolution, akin to
+ * {@link Promise.withResolvers}. As it extends {@link Promise}, it is
+ * 'thenable' and works with `await` as if it were a native Promise. This
+ * allows seamless integration with code expecting Promise-like objects.
+ */
+export class Deferred extends Promise<any> {
+    /**
+     * A getter for the species symbol which returns a custom DeferredPromise
+     * class. This class extends from Deferred and is used to ensure that the
+     * constructor signature matches that of a Promise. The executor function
+     * passed to the constructor of this class is used to initialize the Deferred
+     * object with resolve and reject functions, similar to how a Promise would
+     * be initialized.
+     *
+     * @returns {DeferredPromise} A DeferredPromise class that extends Deferred.
+     */
+    static get [Symbol.species](): DeferredPromise;
+    /**
+     * The constructor for Deferred instances. By default, a new Deferred will
+     * have three important properties: `promise`, `resolve`, and `reject`.
+     *
+     * The constructor takes an object called `options`. It can have the
+     * following properties:
+     *
+     * ```
+     * interface BaseDeferredOptions {
+     *   // Deferreds store the value or reason. To turn this off, pass true
+     *   // to this option.
+     *   doNotTrackAnswers?: boolean;
+     * }
+     *
+     * interface ResolveDeferredOptions {
+     *   // Passing in an option object with a resolve value will auto resolve
+     *   // the Deferred with your value. An error will be raised if both
+     *   // resolve and reject are supplied at the same time.
+     *   resolve?: (value: any) => void;
+     * }
+     *
+     * interface RejectDeferredOptions {
+     *   // Passing in an option object with a reject reason will auto reject
+     *   // the Deferred with your reason. An error will be raised if both
+     *   // resolve and reject are supplied at the same time.
+     *   reject?: (reason: any) => void;
+     * }
+     *
+     * type DeferredOptions = BaseDeferredOptions &
+     *   (ResolveDeferredOptions | RejectDeferredOptions)
+     * ```
+     *
+     * @param {object} options see above for examples on supported options, but
+     * when supplied, the constructor can take instructions on how to auto
+     * resolve or reject the deferred created here.
+     */
+    constructor(options: object);
+    /**
+     * When the Deferred is settled with {@link Deferred.resolve}, the `value`
+     * passed to that function will be set here as well.
+     *
+     * @type {*}
+     */
+    value: any;
+    /**
+     * When the Deferred is settled with {@link Deferred.reject}, the `reason`
+     * passed to that rejection will also be stored here.
+     *
+     * @type {*}
+     */
+    reason: any;
+    /**
+     * Returns a boolean value that indicates whether or not this Deferred
+     * has been settled (either resolve or reject have been invoked).
+     *
+     * @returns {boolean} `true` if either {@link Deferred.resolve} or
+     * {@link Deferred.reject} have been invoked; `false` otherwise
+     */
+    get settled(): boolean;
+    /**
+     * Accessor for the promise managed by this Deferred instance.
+     *
+     * This getter provides access to the internal promise which is controlled
+     * by the Deferred's resolve and reject methods. It allows external code to
+     * attach callbacks for the resolution or rejection of the Deferred without
+     * the ability to directly resolve or reject it.
+     *
+     * @returns {Promise} The promise controlled by this Deferred instance.
+     */
+    get promise(): Promise<any>;
+    /**
+     * Resolves the Deferred with the given value. If the value is a thenable
+     * (i.e., has a "then" method), the Deferred will "follow" that thenable,
+     * adopting its eventual state; otherwise, the Deferred will be fulfilled
+     * with the value. This function behaves the same as Promise.resolve.
+     *
+     * @param {*} value - The value to resolve the Deferred with.
+     * @returns {Promise} A Promise that is resolved with the given value.
+     */
+    resolve(value: any): Promise<any>;
+    /**
+     * Rejects the Deferred with the given reason. This function behaves the
+     * same as Promise.reject. The Deferred will be rejected with the provided
+     * reason.
+     *
+     * @param {*} reason - The reason to reject the Deferred with.
+     * @returns {Promise} A Promise that is rejected with the given reason.
+     */
+    reject(reason: any): Promise<any>;
+    #private;
+}
+export const DeferredExtension: Extension;
+import { Extension } from '@nejs/extension';