@nejs/basic-extensions 2.21.0 → 2.22.6

package/dist/cjs/classes/introspector.js.map

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

package/dist/cjs/classes/iterable.d.ts

@@ -1,169 +0,0 @@
-/**
- * The Iterable class is designed to provide a convenient way to create synchronous
- * iterable objects. It can be initialized with either an array or individual elements.
- * This class implements the iterable protocol, allowing instances to be used with
- * `for...of` loops and other standard JavaScript iteration mechanisms.
- */
-export class Iterable {
-    /**
-     * Checks if a given value is an iterable. This method determines if the
-     * provided value has a `Symbol.iterator` property that is a generator
-     * function. It's a precise way to identify if the value conforms to the
-     * iterable protocol using a generator function.
-     *
-     * Note: This method specifically checks for generator functions. Some
-     * iterables might use regular functions that return an iterator, which
-     * this method won't identify.
-     *
-     * @param {*} value - The value to be checked for iterability.
-     * @returns {boolean} - Returns true if the value is an iterable implemented
-     * using a generator function, false otherwise.
-     */
-    static isIterable(value: any): boolean;
-    /**
-     * Constructs an instance of Iterable. It can be initialized with either an
-     * iterable object (such as an array, Set, Map, string, or any object
-     * implementing the iterable protocol) or individual elements. If the first
-     * argument is an iterable, the class 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|*} elementsOrFirstElement - An iterable object or the
-     * first element.
-     * @param {...*} moreElements - Additional elements if the first argument is
-     * not an iterable.
-     */
-    constructor(elementsOrFirstElement: Iterable | any, ...moreElements: any[]);
-    /**
-     * Provides access to the elements as a standard array. Useful for scenarios
-     * where array methods and behaviors are needed.
-     *
-     * @returns {Array} An array containing all the elements of the iterable.
-     */
-    get asArray(): any[];
-    /**
-     * Implements the iterable protocol. When an instance of Iterable is used
-     * in a `for...of` loop or spread syntax, this generator function is invoked
-     * to yield the elements one by one in a synchronous manner.
-     *
-     * @returns {Generator} A generator that yields each element of the iterable.
-     */
-    [Symbol.iterator](): Generator;
-    /**
-     * 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 `Iterator` around any type of iterable
- * object. This can be wrapped around any type of object that has a
- * `[Symbol.iterator]` property assigned to a generator function.
- */
-export class Iterator {
-    /**
-     * Creates an Iterator for the keys of the given object.
-     *
-     * @note alternatives to keyFetcher might be `Reflect.ownKeys` or even
-     * `Object.keys`. Each type of fetcher has their own requirements but
-     * any function that takes an object and returns keys will suffice.
-     *
-     * @param {Object} object - The object whose keys will be iterated.
-     * @param {Function} [mapEach] - Optional function to map each key.
-     * @param {Function} [keyFetcher=Object.getOwnPropertyNames] - Function to
-     * fetch keys from the object. Defaults to Object.getOwnPropertyNames.
-     * @returns {Iterator} An Iterator instance containing the object's keys.
-     */
-    static keys(object: Object, mapEach?: Function, keyFetcher?: Function): Iterator;
-    /**
-     * Creates an Iterator for the entries of the given object.
-     *
-     * @note alternatives to keyFetcher might be `Reflect.ownKeys` or even
-     * `Object.keys`. Each type of fetcher has their own requirements but
-     * any function that takes an object and returns keys will suffice.
-     *
-     * @param {Object} object - The object whose entries will be iterated.
-     * @param {Function} [mapEach] - Optional function to map each entry.
-     * @param {Function} [keyFetcher=Object.getOwnPropertyNames] - Function to
-     * fetch keys from the object. Defaults to Object.getOwnPropertyNames.
-     * @returns {Iterator} An Iterator instance containing the object's entries.
-     */
-    static entries(object: Object, mapEach?: Function, keyFetcher?: Function): Iterator;
-    /**
-     * Creates an Iterator for the property descriptors of the given object.
-     *
-     * @note alternatives to keyFetcher might be `Reflect.ownKeys` or even
-     * `Object.keys`. Each type of fetcher has their own requirements but
-     * any function that takes an object and returns keys will suffice.
-     *
-     * @param {Object} object - The object whose descriptors will be iterated.
-     * @param {Function} [mapEach] - Optional function to map each descriptor
-     * entry.
-     * @param {Function} [keyFetcher=Object.getOwnPropertyNames] - Function to
-     * fetch keys from the object. Defaults to Object.getOwnPropertyNames.
-     * @returns {Iterator} An Iterator instance containing entries of [key,
-     * descriptor] pairs.
-     */
-    static descriptors(object: Object, mapEach?: Function, keyFetcher?: Function): Iterator;
-    /**
-     * Creates a new `Iterator` object instance.
-     *
-     * @param {object} iterable any object that has a `[Symbol.iterator]`
-     * property assigned to a generator function.
-     * @param {function} mapEach when provided `mapEach` is a callback that
-     * takes an entry as input and receives one as output.
-     */
-    constructor(iterable: object, mapEach: Function);
-    /**
-     * 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 `Array.from()`
-     */
-    get asArray(): array;
-    /**
-     * Returns the actual iterable object passed to the constructor that
-     * created this instance.
-     *
-     * @returns {object} the object containing the `[Symbol.iterator]`
-     */
-    get iterable(): 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 iterator to the beginning allowing it to be
-     * iterated over again.
-     */
-    reset(): 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 {Iterator} this is returned since this object is already
-     * conforming to the expected JavaScript Iterator interface
-     */
-    [Symbol.iterator](): Iterator;
-    /**
-     * 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 IterableExtensions: Extension;
-export const IteratorExtensions: Extension;
-import { Extension } from '@nejs/extension';

package/dist/cjs/classes/iterable.js

@@ -1,268 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IteratorExtensions = exports.IterableExtensions = exports.Iterator = exports.Iterable = void 0;
-const extension_1 = require("@nejs/extension");
-/**
- * The Iterable class is designed to provide a convenient way to create synchronous
- * iterable objects. It can be initialized with either an array or individual elements.
- * This class implements the iterable protocol, allowing instances to be used with
- * `for...of` loops and other standard JavaScript iteration mechanisms.
- */
-class Iterable {
-    /**
-     * Private field to store the elements of the iterable.
-     * @private
-     */
-    #elements = [];
-    /**
-     * Constructs an instance of Iterable. It can be initialized with either an
-     * iterable object (such as an array, Set, Map, string, or any object
-     * implementing the iterable protocol) or individual elements. If the first
-     * argument is an iterable, the class 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|*} elementsOrFirstElement - An iterable object or the
-     * first element.
-     * @param {...*} moreElements - Additional elements if the first argument is
-     * not an iterable.
-     */
-    constructor(elementsOrFirstElement, ...moreElements) {
-        if (elementsOrFirstElement != null &&
-            typeof elementsOrFirstElement[Symbol.iterator] === 'function') {
-            this.#elements = [...elementsOrFirstElement, ...moreElements];
-        }
-        else {
-            this.#elements = [elementsOrFirstElement, ...moreElements];
-        }
-    }
-    /**
-     * Implements the iterable protocol. When an instance of Iterable is used
-     * in a `for...of` loop or spread syntax, this generator function is invoked
-     * to yield the elements one by one in a synchronous manner.
-     *
-     * @returns {Generator} A generator that yields each element of the iterable.
-     */
-    *[Symbol.iterator]() {
-        for (const element of this.#elements) {
-            yield element;
-        }
-    }
-    /**
-     * Provides access to the elements as a standard array. Useful for scenarios
-     * where array methods and behaviors are needed.
-     *
-     * @returns {Array} An array containing all the elements of the iterable.
-     */
-    get asArray() {
-        return this.#elements;
-    }
-    /**
-     * 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;
-    }
-    /**
-     * Checks if a given value is an iterable. This method determines if the
-     * provided value has a `Symbol.iterator` property that is a generator
-     * function. It's a precise way to identify if the value conforms to the
-     * iterable protocol using a generator function.
-     *
-     * Note: This method specifically checks for generator functions. Some
-     * iterables might use regular functions that return an iterator, which
-     * this method won't identify.
-     *
-     * @param {*} value - The value to be checked for iterability.
-     * @returns {boolean} - Returns true if the value is an iterable implemented
-     * using a generator function, false otherwise.
-     */
-    static isIterable(value) {
-        const type = Object.prototype.toString.call(value?.[Symbol.iterator]);
-        return type === '[object GeneratorFunction]';
-    }
-}
-exports.Iterable = Iterable;
-/**
- * Being able to create a compliant `Iterator` around any type of iterable
- * object. This can be wrapped around any type of object that has a
- * `[Symbol.iterator]` property assigned to a generator function.
- */
-class Iterator {
-    /**
-     * A private function that when provided has the following signature:
-     * `function mapEach(entry) -> entry`. This allows any changes to be made
-     * to each element, conditionally and programmatically, as needed before
-     * they are returned to the called code.
-     */
-    #mapEach = undefined;
-    /**
-     * Creates a new `Iterator` object instance.
-     *
-     * @param {object} iterable any object that has a `[Symbol.iterator]`
-     * property assigned to a generator function.
-     * @param {function} mapEach when provided `mapEach` is a callback that
-     * takes an entry as input and receives one as output.
-     */
-    constructor(iterable, mapEach) {
-        if (!iterable || !Reflect.has(iterable, Symbol.iterator)) {
-            throw new TypeError('Value used to instantiate Iterator is not iterable');
-        }
-        this.#iterable = iterable;
-        this.#iterator = iterable[Symbol.iterator]();
-        this.#mapEach = typeof mapEach === 'function' ? mapEach : undefined;
-    }
-    /**
-     * 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 `Array.from()`
-     */
-    get asArray() {
-        return Array.from(this.#iterable);
-    }
-    /**
-     * Returns the actual iterable object passed to the constructor that
-     * created this instance.
-     *
-     * @returns {object} the object containing the `[Symbol.iterator]`
-     */
-    get iterable() {
-        return this.#iterable;
-    }
-    /**
-     * 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() {
-        const input = this.#iterator.next();
-        let output = input;
-        if (output.done) {
-            return { value: undefined, done: true };
-        }
-        else {
-            if (this.#mapEach && typeof this.#mapEach === 'function') {
-                output.value = this.#mapEach(input.value);
-            }
-            return { value: output.value, done: false };
-        }
-    }
-    /**
-     * Resets the iterator to the beginning allowing it to be
-     * iterated over again.
-     */
-    reset() {
-        this.#iterator = this.#iterable[Symbol.iterator]();
-    }
-    /**
-     * 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 {Iterator} this is returned since this object is already
-     * conforming to the expected JavaScript Iterator interface
-     */
-    [Symbol.iterator]() {
-        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
-     */
-    #iterable = null;
-    /**
-     * The results of a call to the iterable's `[Symbol.iterator]`
-     * generator function.
-     *
-     * @type {object}
-     * @private
-     */
-    #iterator = null;
-    /**
-     * Creates an Iterator for the keys of the given object.
-     *
-     * @note alternatives to keyFetcher might be `Reflect.ownKeys` or even
-     * `Object.keys`. Each type of fetcher has their own requirements but
-     * any function that takes an object and returns keys will suffice.
-     *
-     * @param {Object} object - The object whose keys will be iterated.
-     * @param {Function} [mapEach] - Optional function to map each key.
-     * @param {Function} [keyFetcher=Object.getOwnPropertyNames] - Function to
-     * fetch keys from the object. Defaults to Object.getOwnPropertyNames.
-     * @returns {Iterator} An Iterator instance containing the object's keys.
-     */
-    static keys(object, mapEach, keyFetcher) {
-        keyFetcher ??= Object.getOwnPropertyNames;
-        const keys = keyFetcher(object);
-        return new Iterator(keys, mapEach);
-    }
-    /**
-     * Creates an Iterator for the entries of the given object.
-     *
-     * @note alternatives to keyFetcher might be `Reflect.ownKeys` or even
-     * `Object.keys`. Each type of fetcher has their own requirements but
-     * any function that takes an object and returns keys will suffice.
-     *
-     * @param {Object} object - The object whose entries will be iterated.
-     * @param {Function} [mapEach] - Optional function to map each entry.
-     * @param {Function} [keyFetcher=Object.getOwnPropertyNames] - Function to
-     * fetch keys from the object. Defaults to Object.getOwnPropertyNames.
-     * @returns {Iterator} An Iterator instance containing the object's entries.
-     */
-    static entries(object, mapEach, keyFetcher) {
-        keyFetcher ??= Object.getOwnPropertyNames;
-        const keys = keyFetcher(object);
-        const entries = [];
-        for (const key of keys) {
-            entries.push([key, object[key]]);
-        }
-        return new Iterator(entries, mapEach);
-    }
-    /**
-     * Creates an Iterator for the property descriptors of the given object.
-     *
-     * @note alternatives to keyFetcher might be `Reflect.ownKeys` or even
-     * `Object.keys`. Each type of fetcher has their own requirements but
-     * any function that takes an object and returns keys will suffice.
-     *
-     * @param {Object} object - The object whose descriptors will be iterated.
-     * @param {Function} [mapEach] - Optional function to map each descriptor
-     * entry.
-     * @param {Function} [keyFetcher=Object.getOwnPropertyNames] - Function to
-     * fetch keys from the object. Defaults to Object.getOwnPropertyNames.
-     * @returns {Iterator} An Iterator instance containing entries of [key,
-     * descriptor] pairs.
-     */
-    static descriptors(object, mapEach, keyFetcher) {
-        keyFetcher ??= Object.getOwnPropertyNames;
-        const keys = keyFetcher(object);
-        const entries = [];
-        for (const key of keys) {
-            entries.push([key, Object.getOwnPropertyDescriptor(object, key)]);
-        }
-        return new Iterator(entries, mapEach);
-    }
-}
-exports.Iterator = Iterator;
-exports.IterableExtensions = new extension_1.Extension(Iterable);
-exports.IteratorExtensions = new extension_1.Extension(Iterator);
-//# sourceMappingURL=iterable.js.map

package/dist/cjs/classes/iterable.js.map

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

package/dist/cjs/classes/param.parser.d.ts

@@ -1,221 +0,0 @@
-export class ParamParser {
-    /**
-     * Attempts to parse the given parameters using the provided parsers, throwing an
-     * error if no valid parser is found. This method serves as a convenience wrapper
-     * around `safeTryParsers`, enforcing strict parsing by automatically enabling
-     * error throwing on failure.
-     *
-     * @param {any[]} parameters - The parameters to be parsed.
-     * @param {Function[]} parsers - An array of `ParamParser` subclasses to attempt
-     * parsing with.
-     * @returns {Object} An object containing the parsing result, with a `success`
-     * property indicating if parsing was successful, and a `data` property containing
-     * the parsed data if successful.
-     * @example
-     * const parameters = ['param1', 'param2'];
-     * const parsers = [Parser1, Parser2];
-     * const result = ParamParser.tryParsers(parameters, parsers);
-     * if (result.success) {
-     *   console.log('Parsing successful:', result.data);
-     * } else {
-     *   console.error('Parsing failed.');
-     * }
-     */
-    static tryParsers(parameters: any[], parsers: Function[]): Object;
-    /**
-     * Tries parsing `parameters` with each parser in `parsers`. If
-     * `throwOnFail` is true, throws an error when validation fails or
-     * no valid parser is found.
-     *
-     * This method attempts to parse the given parameters using the
-     * provided list of parsers. It validates the input to ensure both
-     * `parameters` and `parsers` are arrays and that `parsers`
-     * contains at least one valid `ParamParser` subclass. If
-     * `throwOnFail` is set to true, it will throw specific errors for
-     * invalid inputs or when no parser succeeds. Otherwise, it returns
-     * an object indicating the success status and the result of
-     * parsing, if successful.
-     *
-     * @param {any[]} parameters - The parameters to be parsed.
-     * @param {Function[]} parsers - An array of `ParamParser`
-     * subclasses to attempt parsing with.
-     * @param {boolean} [throwOnFail=false] - Whether to throw an
-     * error on failure.
-     * @returns {{success: boolean, data: any}} An object with a
-     * `success` flag and `data` containing the parsing result, if
-     * successful.
-     * @throws {ParametersMustBeArrayError} If `parameters` or
-     * `parsers` are not arrays when `throwOnFail` is true.
-     * @throws {ParsersArrayMustContainParsersError} If `parsers`
-     * does not contain at least one valid `ParamParser` subclass
-     * when `throwOnFail` is true.
-     * @throws {NoValidParsersFound} If no valid parser is found
-     * and `throwOnFail` is true.
-     * @example
-     * const parameters = ['param1', 'param2'];
-     * const parsers = [Parser1, Parser2];
-     * const result = ParamParser.safeTryParsers(
-     *   parameters, parsers, true
-     * );
-     *
-     * if (result.success) {
-     *   console.log('Parsing successful:', result.data);
-     * } else {
-     *   console.error('Parsing failed.');
-     * }
-     */
-    static safeTryParsers(parameters: any[], parsers: Function[], throwOnFail?: boolean): {
-        success: boolean;
-        data: any;
-    };
-    /**
-     * A custom error class that signifies no valid parsers were found
-     * during the parsing process. This error is thrown when all
-     * parsers fail to parse the given parameters and the `throwOnFail`
-     * flag is set to true in the `safeTryParsers` method.
-     *
-     * @returns {Function} A class extending Error, representing a
-     * specific error when no valid parsers are found.ound.
-     *
-     * @example
-     * try {
-     *   const result = ParamParser.safeTryParsers(
-     *     parameters, parsers, true
-     *   );
-     * } catch (error) {
-     *   if (error instanceof ParamParser.NoValidParsersFound) {
-     *     console.error(
-     *       'No valid parsers could process the parameters.'
-     *     );
-     *   }
-     * }
-     */
-    static get NoValidParsersFound(): Function;
-    /**
-     * Represents an error thrown when the parameters provided to a method
-     * are not in an array format as expected. This class extends the
-     * native JavaScript `Error` class, allowing for instances of this
-     * error to be thrown and caught using standard error handling
-     * mechanisms in JavaScript.
-     *
-     * This error is specifically used in scenarios where a method
-     * expects its arguments to be provided as an array, and the
-     * validation of those arguments fails because they were not
-     * provided in an array format. It serves as a clear indicator
-     * of the nature of the error to developers, enabling them to
-     * quickly identify and rectify the issue in their code.
-     *
-     * @example
-     * try {
-     *   ParamParser.safeTryParsers(nonArrayParameters, parsers, true);
-     * } catch (error) {
-     *   if (error instanceof ParamParser.ParametersMustBeArrayError) {
-     *     console.error('Parameters must be provided as an array.');
-     *   }
-     * }
-     */
-    static get ParametersMustBeArrayError(): {
-        new (message?: string): {
-            name: string;
-            message: string;
-            stack?: string;
-            cause?: unknown;
-        };
-        new (message?: string, options?: ErrorOptions): {
-            name: string;
-            message: string;
-            stack?: string;
-            cause?: unknown;
-        };
-    };
-    /**
-     * A custom error class indicating that the parsers array does not
-     * contain valid parser functions. This error is thrown when the
-     * validation of parsers within `ParamParser.safeTryParsers` fails
-     * to find any instance that is a subclass of `ParamParser`. It
-     * extends the native JavaScript `Error` class, allowing it to be
-     * thrown and caught using standard error handling mechanisms.
-     *
-     * This error serves as a clear indicator to developers that the
-     * provided array of parsers does not meet the expected criteria,
-     * specifically that it must contain at least one valid parser
-     * that extends `ParamParser`. This ensures that the parsing
-     * process can be executed with at least one valid parser function.
-     *
-     * @example
-     * try {
-     *   ParamParser.safeTryParsers(parameters, [], true);
-     * } catch (error) {
-     *   const { ParsersArrayMustContainParsersError } = ParamParser
-     *   if (error instanceof ParsersArrayMustContainParsersError) {
-     *     console.error(
-     *       'The parsers array must contain at least one valid parser.'
-     *     );
-     *   }
-     * }
-     */
-    static get ParsersArrayMustContainParsersError(): {
-        new (message?: string): {
-            name: string;
-            message: string;
-            stack?: string;
-            cause?: unknown;
-        };
-        new (message?: string, options?: ErrorOptions): {
-            name: string;
-            message: string;
-            stack?: string;
-            cause?: unknown;
-        };
-    };
-    /**
-     * Constructs an instance of ParamParser. It takes in parameters, an optional
-     * validator function, and an optional parser function. The parameters are
-     * validated and if successful, parsed.
-     *
-     * @param {any[]} parameters - Arguments passed in by the process.
-     * @param {((any[]) => boolean)?} [validator=() => {}] - An optional function
-     * to specify a validator without subclassing ParamParser. It should return
-     * a boolean indicating the validity of the parameters.
-     * @param {((any[]) => object)?} [parser=() => {}] - An optional function to
-     * specify a parser without subclassing ParamParser. It should return an
-     * object after parsing the input parameters.
-     *
-     * @example
-     * const parameters = ['param1', 'param2']
-     * const validator = params => params.every(param => typeof param === 'string')
-     * const parser = params => ({ params })
-     * const paramParser = new ParamParser(parameters, validator, parser)
-     * if (paramParser.success) {
-     *   console.log('Parsing successful:', paramParser.results)
-     * } else {
-     *   console.error('Parsing failed.')
-     * }
-     */
-    constructor(parameters: any[], validator?: () => void, parser?: () => void);
-    args: any[];
-    parser: () => void;
-    validator: () => void;
-    result: any;
-    success: boolean;
-    results: object | undefined;
-    /**
-     * @param {object} args arguments that were previously validated
-     * by either the overloaded validate() method or the supplied
-     * validator closure.
-     * @returns {object} returns the output object, or an empty
-     * object, after parsing the input arguments or parameters.
-     */
-    parse(args: object): object;
-    /**
-     * Walk the arguments and determine if the supplied input is
-     * a valid parsing.
-     *
-     * @param {any[]} args arguments supplied by the process.
-     * @returns {boolean} `true` if the validation is successful,
-     * `false` otherwise.
-     */
-    validate(args: any[]): boolean;
-}
-export const ParamParserExtensions: Extension;
-import { Extension } from '@nejs/extension';