@rapidrest/core 1.0.1

package/dist/lib/OASUtils.js

@@ -0,0 +1,207 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import fs from "fs";
+import { Logger } from "./Logger.js";
+import path from "path";
+import { Axios } from "axios";
+import YAML from "js-yaml";
+const logger = Logger();
+export class OASUtils {
+    /**
+     * Gets the datastore definition with the specified name.
+     *
+     * @param spec The OpenAPI specification to search.
+     * @param name The name of the datastore to retrieve.
+     * @returns The definition for the datastore with the given name if found, otherwise `undefined`.
+     */
+    static getDatastore(spec, name) {
+        let result = undefined;
+        if (spec.components && spec.components["x-datastores"]) {
+            result = spec.components["x-datastores"][name];
+        }
+        return result;
+    }
+    /**
+     * Gets the specification object at the specified path.
+     *
+     * @param {any} spec The OpenAPI specification to reference.
+     * @param {string} path The path of the object to retrieve.
+     * @returns {any} The object at the specified path if found, otherwise `undefined`.
+     */
+    static getObject(spec, path) {
+        let result = spec;
+        if (path) {
+            if (path[0] === "#") {
+                path = path.substring(1, path.length);
+            }
+            if (path[0] === "/") {
+                path = path.substring(1, path.length);
+            }
+            let parts = path.split("/");
+            parts.forEach(part => {
+                result = result[part];
+            });
+        }
+        else {
+            result = undefined;
+        }
+        return result;
+    }
+    /**
+     * Returns the first available response object for a 2XX response as defined by the provided Operation schema object.
+     *
+     * @param {any} obj The Operation schema object to search.
+     */
+    static getResponse(obj) {
+        if (obj.responses) {
+            for (let status in obj.responses) {
+                if (status[0] === "2") {
+                    for (let type in obj.responses[status]) {
+                        return obj.responses[status];
+                    }
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Returns the first available response content object for a 2XX response as defined by the provided Operation schema object.
+     *
+     * @param {any} obj The Operation schema object to search.
+     */
+    static getResponseContent(obj) {
+        let result = this.getResponse(obj);
+        return result ? result.content : undefined;
+    }
+    /**
+     * Retrieves the schema definition with the given name.
+     *
+     * @param {any} spec The OpenAPI specification object to reference.
+     * @param {string} name The name of the schema to retrieve.
+     * @returns {any} The schema definition with the given name.
+     */
+    static getSchema(spec, name) {
+        if (!spec.components || !spec.components.schemas) {
+            throw new Error("Invalid specification. No schemas found.");
+        }
+        // Perform a case-insensitive search for the schema
+        for (const schemaName in spec.components.schemas) {
+            if (schemaName.match(new RegExp(name, 'i'))) {
+                return spec.components.schemas[schemaName];
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Extracts the type information for a given schema Object definition.
+     *
+     * @param {any} schemaDef The schema definition object to extract type information from.
+     * @param {any} spec The entire OpenAPI specification object.
+     * @param {Function} convertDataType The function that converts OpenAPI Specification types to native types.
+     * @returns {any} A tuple containing the type, subType and subSchemaRef information.
+     */
+    static getTypeInfo(schemaDef, spec, convertDataType) {
+        if (schemaDef) {
+            let result = { type: null, subSchemaRef: null, subType: null };
+            if (schemaDef["$ref"]) {
+                let realDef = OASUtils.getObject(spec, schemaDef["$ref"]);
+                if (realDef) {
+                    result.subSchemaRef = schemaDef["$ref"];
+                    result.type = convertDataType("object", null, path.basename(result.subSchemaRef));
+                }
+                else {
+                    return null;
+                }
+            }
+            else if (schemaDef["type"] === "array") {
+                if (schemaDef["items"]) {
+                    if (schemaDef.items["$ref"]) {
+                        let realDef = OASUtils.getObject(spec, schemaDef.items["$ref"]);
+                        if (realDef) {
+                            result.subSchemaRef = schemaDef.items["$ref"];
+                            result.subType = convertDataType(realDef.type, realDef.format, path.basename(result.subSchemaRef));
+                            result.type = convertDataType("array", result.subType);
+                        }
+                    }
+                    else {
+                        result.format = schemaDef.items.format;
+                        result.subType = convertDataType(schemaDef.items.type, schemaDef.items.format);
+                        result.type = convertDataType("array", result.subType);
+                    }
+                }
+                else {
+                    throw new Error("Array defined with no items");
+                }
+            }
+            else if (schemaDef["type"] === undefined && schemaDef["enum"]) {
+                result.type = "enum";
+                result.values = schemaDef["enum"];
+            }
+            else {
+                result.format = schemaDef.format;
+                result.type = convertDataType(schemaDef.type, schemaDef.format);
+                if (schemaDef.type === "object") {
+                    result.subSchemaRef = "Object";
+                }
+            }
+            return result;
+        }
+        else {
+            return null;
+        }
+    }
+    /**
+     * Attempts to load the Open API specification at the given path or URL.
+     *
+     * @param {string} file The path or URL of the OpenAPI Specification file to load.
+     * @returns {Promise<any>} A promise whose result will be the loaded OpenAPI Specification as an object.
+     */
+    static async loadSpec(file) {
+        let apiSpec = null;
+        if (fs.existsSync(file)) {
+            let fileType = path.extname(file);
+            let data = fs.readFileSync(file, "utf8");
+            if (fileType === ".yaml") {
+                logger.info("Loading YAML: " + file);
+                apiSpec = YAML.load(data);
+            }
+            else if (fileType === ".json") {
+                logger.info("Loading JSON: " + file);
+                apiSpec = JSON.parse(data);
+            }
+            else {
+                throw new Error("Unsupported file type: " + fileType);
+            }
+        }
+        else if (file.match(new RegExp(/http[s]?:\/\/[a-zA-Z0-9]*\.?[a-z]*.*/))) {
+            const axios = new Axios({ baseURL: file });
+            const response = await axios.get(file);
+            if (response && response.data) {
+                if (typeof response.data === "string") {
+                    // Assume the file is a YAML first. If not we'll try JSON
+                    try {
+                        apiSpec = YAML.load(response.data);
+                    }
+                    catch (err) {
+                        apiSpec = response.data;
+                    }
+                }
+                else if (typeof response.data === "object") {
+                    apiSpec = response.data;
+                }
+                else {
+                    throw new Error("Cannot parse data : " + response.data);
+                }
+            }
+            else {
+                throw new Error("File not found: " + file);
+            }
+        }
+        else {
+            throw new Error("File not found: " + file);
+        }
+        return apiSpec;
+    }
+}
+//# sourceMappingURL=OASUtils.js.map

package/dist/lib/OASUtils.js.map

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

package/dist/lib/ObjectFactory.js

@@ -0,0 +1,302 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import "reflect-metadata";
+import { Logger } from "./Logger.js";
+import * as uuid from "uuid";
+/**
+ * The `ObjectFactory` is a manager for creating objects based on registered
+ * class types. This allows for the tracking of multiple instances of objects
+ * so that references can be referenced by unique name.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class ObjectFactory {
+    /** A map for string fully qualified class names to their class types. */
+    classes = new Map();
+    /** The global application configuration object. */
+    config;
+    /** A map for the unique name to the intance of a particular class type. */
+    instances = new Map();
+    /** The application logging utility. */
+    logger;
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger ? logger : Logger();
+        // Add ourself so it can be injected/retrieved
+        this.instances.set(`${ObjectFactory.name}:default`, this);
+    }
+    /**
+     * Destroys the specified objects. If `undefined` is passed in, all objects managed by the factory are destroyed.
+     */
+    async destroy(objs) {
+        // If no set of objects was provided we want to destroy everything
+        if (!objs) {
+            objs = [];
+            this.instances.forEach((value, key) => {
+                if (!value.name) {
+                    value.name = key;
+                }
+                objs.push(value);
+            });
+        }
+        else {
+            // If only a single object was passed in we need to convert this to an array
+            if (!Array.isArray(objs)) {
+                objs = [objs];
+            }
+        }
+        // Go through each object and call its destructor, if available
+        for (const obj of objs) {
+            const name = obj.name ?? obj._name;
+            let destroyFunc = undefined;
+            let proto = Object.getPrototypeOf(obj);
+            while (proto) {
+                for (const member of Object.getOwnPropertyNames(proto)) {
+                    const hasDestructor = Reflect.getMetadata("rrst:destructor", proto, member);
+                    if (hasDestructor) {
+                        destroyFunc = obj[member];
+                        break;
+                    }
+                }
+                if (destroyFunc) {
+                    break;
+                }
+                proto = Object.getPrototypeOf(proto);
+            }
+            if (destroyFunc) {
+                try {
+                    this.logger.debug("Destroying object: " + name);
+                    const boundFunc = destroyFunc.bind(obj);
+                    const result = boundFunc();
+                    if (result instanceof Promise) {
+                        await result;
+                    }
+                }
+                catch (err) {
+                    this.logger.error("Failed to destroy object: " + name);
+                    this.logger.debug(err);
+                }
+            }
+        }
+    }
+    /**
+     * Deletes all instantiated objects.
+     */
+    clear() {
+        this.instances.clear();
+    }
+    /**
+     * Deletes all instantiated objects and registered class types.
+     */
+    clearAll() {
+        this.clear();
+        this.classes.clear();
+    }
+    /**
+     * Scans the given object for any properties with the `@Inject` decorator and assigns the correct values.
+     * @param obj The object to initialize with injected defaults
+     */
+    async initialize(obj) {
+        let proto = Object.getPrototypeOf(obj);
+        while (proto) {
+            // Search for each type of injectable property
+            for (const member of Object.getOwnPropertyNames(proto)) {
+                // Inject @Config
+                const injectConfig = Reflect.getMetadata("rrst:injectConfig", proto, member);
+                if (injectConfig) {
+                    const defaultValue = Reflect.getMetadata("rrst:injectConfigDefault", proto, member);
+                    // If the value is a string, then it must be a path to a specific variable desired
+                    if (typeof injectConfig === "string") {
+                        const value = this.config?.get(injectConfig);
+                        if (value !== undefined) {
+                            obj[member] = value;
+                        }
+                        else if (defaultValue !== undefined) {
+                            obj[member] = defaultValue;
+                        }
+                        else {
+                            throw new Error("No configuration variable is defined at path: " + injectConfig);
+                        }
+                    }
+                    else {
+                        // No specific variable is desired, inject the whole config object
+                        obj[member] = this.config;
+                    }
+                }
+                // Inject @Logger
+                const injectLogger = Reflect.getMetadata("rrst:injectLogger", proto, member);
+                if (injectLogger) {
+                    obj[member] = this.logger;
+                }
+                // Inject @Inject
+                const injectObject = Reflect.getMetadata("rrst:injectObject", proto, member);
+                if (injectObject) {
+                    // First register the type just in case it hasn't been done yet
+                    this.register(injectObject.type);
+                    // Now retrieve the instance for the given name
+                    const instance = await this.newInstance(injectObject.type, injectObject.options);
+                    obj[member] = instance;
+                }
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+        // Call any @Init functions
+        const initFuncs = this.getInitMethods(obj);
+        for (const func of initFuncs) {
+            const result = func.bind(obj)();
+            if (result instanceof Promise) {
+                await result;
+            }
+        }
+        return obj;
+    }
+    /**
+     * Searches an object for one or more functions that implement a `@Init` decorator.
+     *
+     * @param obj The object to search.
+     * @returns The list of functions that implements the `@Init` decorator if found, otherwise undefined.
+     */
+    getInitMethods(obj) {
+        const results = [];
+        for (const member in obj) {
+            const initialize = Reflect.getMetadata("rrst:initialize", obj, member);
+            if (initialize) {
+                results.push(obj[member]);
+                break;
+            }
+        }
+        let proto = Object.getPrototypeOf(obj);
+        while (proto) {
+            for (const member of Object.getOwnPropertyNames(proto)) {
+                const initialize = Reflect.getMetadata("rrst:initialize", proto, member);
+                if (initialize) {
+                    results.push(obj[member]);
+                    break;
+                }
+            }
+            proto = Object.getPrototypeOf(proto);
+        }
+        return results;
+    }
+    /**
+     * Returns the object instance with the given unique name. Unique names take the form `<ClassName>:<InstanceName>`.
+     * It is possible to only specifiy the `<ClassName>`, doing so will automatically look for the `<ClassName>:default`
+     * instance or the first found instance of the given type.
+     * @param nameOrType The unique name or class type of the object to retrieve.
+     * @returns The object instance associated with the given name if found, otherwise `undefined`.
+     */
+    // TODO: Investigate name vs fqn
+    getInstance(nameOrType) {
+        let search = "";
+        if (typeof nameOrType === "string") {
+            search = nameOrType;
+        }
+        else {
+            search =
+                nameOrType && nameOrType.name
+                    ? nameOrType.name
+                    : nameOrType.constructor
+                        ? nameOrType.constructor.name
+                        : search;
+        }
+        // Make sure we have a valid type name
+        if (!nameOrType) {
+            throw new Error("No valid nameOrType was specified.");
+        }
+        // First search for the exact name or with `:default`
+        let result = this.instances.get(search.includes(":") ? search : search + ":default");
+        // If we didn't found a result and we weren't given an exact name to search, find the first
+        // instance of the class.
+        if (!result && !search.includes(":")) {
+            for (const key of this.instances.keys()) {
+                if (key.startsWith(search + ":")) {
+                    result = this.instances.get(key);
+                    break;
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Creates a new instance of the class specified with the provided unique name or type and constructor arguments. If an existing
+     * object has already been created with the given name, that instance is returned, otherwise a new instance is created
+     * using the provided arguments.
+     *
+     * @param type The fully qualified name or type of the class to instantiate. If a type is given it's class name will be inferred
+     * via the constructor name.
+     * @param name The unique name to give the class instance. Set to `undefined` if you wish to force a new object is created.
+     * @param initialize Set to `true` to initialize the object after creation, otherwise set to `false`. Default is `true`.
+     * @param args The set of constructor arguments to use during construction
+     */
+    newInstance(type, options) {
+        let name = options?.name || uuid.v4();
+        const initialize = options?.initialize !== undefined ? options.initialize : true;
+        const args = options?.args || [];
+        // If an class type was given extract it's fqn
+        const className = typeof type === "string" ? type : type.fqn || type.name || type.constructor.name;
+        // Names are namespace specific by type. Prepend the type to the name if not already done.
+        if (name && !name.includes(className)) {
+            name = `${className}:${name}`;
+        }
+        // First check to see if an instance was already created for the given name
+        if (name && this.instances.has(name)) {
+            return this.instances.get(name);
+        }
+        // Make sure we have a valid type name
+        if (!className) {
+            throw new Error("No valid type was specified.");
+        }
+        // Make sure the class has been registered if a type was provided
+        if (typeof type !== "string") {
+            this.register(type);
+        }
+        // Look up the class type in our list
+        const clazz = this.classes.get(className);
+        if (!clazz || !clazz.constructor) {
+            throw new Error("No class found with name: " + className);
+        }
+        // Create the new instance using the provided params
+        this.logger.debug(`Creating new instance of class [${className}] with name [${name}]`);
+        const instance = new clazz(...args);
+        // Also store the fqn for reference
+        Object.defineProperty(instance, "_fqn", {
+            enumerable: false,
+            writable: false,
+            value: className,
+        });
+        // Store the instance in our list of objects
+        if (name) {
+            // Save the name to the object
+            Object.defineProperty(instance, "_name", {
+                enumerable: false,
+                writable: false,
+                value: name,
+            });
+            this.instances.set(name, instance);
+        }
+        // Now initialize the object with any injectable defaults. This must happen after we add the instance
+        // to our internal map so that circular dependencies due not cause endless cycles of creation/initialization.
+        if (initialize) {
+            return this.initialize(instance);
+        }
+        return instance;
+    }
+    /**
+     * Registers the given class type for the provided fully qualified name.
+     * @param clazz The class type to register.
+     * @param fqn The fully qualified name of the class to register. If not specified, the class name will be used.
+     */
+    register(clazz, fqn) {
+        const name = fqn ? fqn : clazz.fqn || clazz.name;
+        if (!name) {
+            this.logger.info(`Unable to register class ${name} for ${clazz}/${fqn}`);
+            return;
+        }
+        if (!this.classes.has(name)) {
+            this.logger.info(`Registering class ${name}`);
+            this.classes.set(name, clazz);
+        }
+    }
+}
+//# sourceMappingURL=ObjectFactory.js.map

package/dist/lib/ObjectFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectFactory.js","sourceRoot":"","sources":["../../src/ObjectFactory.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAW7B;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACtB,yEAAyE;IACzD,OAAO,GAAqB,IAAI,GAAG,EAAE,CAAC;IAEtD,mDAAmD;IACzC,MAAM,CAAM;IAEtB,2EAA2E;IAC3D,SAAS,GAAqB,IAAI,GAAG,EAAE,CAAC;IAExD,uCAAuC;IAC7B,MAAM,CAAM;IAEtB,YAAY,MAAY,EAAE,MAAY;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACzC,8CAA8C;QAC9C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,IAAI,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO,CAAC,IAAkB;QACnC,kEAAkE;QAClE,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,GAAG,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;gBAClC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBACd,KAAK,CAAC,IAAI,GAAG,GAAG,CAAC;gBACrB,CAAC;gBACD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;QACP,CAAC;aAAM,CAAC;YACJ,4EAA4E;YAC5E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC;QACL,CAAC;QAED,+DAA+D;QAC/D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,GAAW,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC;YAE3C,IAAI,WAAW,GAAyB,SAAS,CAAC;YAClD,IAAI,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YACvC,OAAO,KAAK,EAAE,CAAC;gBACX,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrD,MAAM,aAAa,GAAY,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;oBACrF,IAAI,aAAa,EAAE,CAAC;wBAChB,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;wBAC1B,MAAM;oBACV,CAAC;gBACL,CAAC;gBAED,IAAI,WAAW,EAAE,CAAC;oBACd,MAAM;gBACV,CAAC;gBACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;YAED,IAAI,WAAW,EAAE,CAAC;gBACd,IAAI,CAAC;oBACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;oBAChD,MAAM,SAAS,GAAa,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBAClD,MAAM,MAAM,GAAQ,SAAS,EAAE,CAAC;oBAChC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;wBAC5B,MAAM,MAAM,CAAC;oBACjB,CAAC;gBACL,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;oBACvD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC3B,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,QAAQ;QACX,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,UAAU,CAAI,GAAQ;QAC/B,IAAI,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,KAAK,EAAE,CAAC;YACX,8CAA8C;YAC9C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrD,iBAAiB;gBACjB,MAAM,YAAY,GAAQ,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClF,IAAI,YAAY,EAAE,CAAC;oBACf,MAAM,YAAY,GAAQ,OAAO,CAAC,WAAW,CAAC,0BAA0B,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;oBACzF,kFAAkF;oBAClF,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;wBACnC,MAAM,KAAK,GAAQ,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;wBAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;4BACtB,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;wBACxB,CAAC;6BAAM,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;4BACpC,GAAG,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC;wBAC/B,CAAC;6BAAM,CAAC;4BACJ,MAAM,IAAI,KAAK,CAAC,gDAAgD,GAAG,YAAY,CAAC,CAAC;wBACrF,CAAC;oBACL,CAAC;yBAAM,CAAC;wBACJ,kEAAkE;wBAClE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;oBAC9B,CAAC;gBACL,CAAC;gBAED,iBAAiB;gBACjB,MAAM,YAAY,GAAQ,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClF,IAAI,YAAY,EAAE,CAAC;oBACf,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC9B,CAAC;gBAED,iBAAiB;gBACjB,MAAM,YAAY,GAAQ,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClF,IAAI,YAAY,EAAE,CAAC;oBACf,+DAA+D;oBAC/D,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;oBACjC,+CAA+C;oBAC/C,MAAM,QAAQ,GAAQ,MAAM,IAAI,CAAC,WAAW,CACxC,YAAY,CAAC,IAAI,EACjB,YAAY,CAAC,OAAO,CACvB,CAAC;oBACF,GAAG,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;gBAC3B,CAAC;YACL,CAAC;YAED,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,2BAA2B;QAC3B,MAAM,SAAS,GAAe,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACvD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC5B,MAAM,MAAM,CAAC;YACjB,CAAC;QACL,CAAC;QAED,OAAO,GAAG,CAAC;IACf,CAAC;IAED;;;;;OAKG;IACI,cAAc,CAAC,GAAQ;QAC1B,MAAM,OAAO,GAAe,EAAE,CAAC;QAE/B,KAAK,MAAM,MAAM,IAAI,GAAG,EAAE,CAAC;YACvB,MAAM,UAAU,GAAY,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAChF,IAAI,UAAU,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;gBAC1B,MAAM;YACV,CAAC;QACL,CAAC;QAED,IAAI,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QACvC,OAAO,KAAK,EAAE,CAAC;YACX,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrD,MAAM,UAAU,GAAY,OAAO,CAAC,WAAW,CAAC,iBAAiB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;gBAClF,IAAI,UAAU,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;oBAC1B,MAAM;gBACV,CAAC;YACL,CAAC;YACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,OAAO,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACH,gCAAgC;IACzB,WAAW,CAAI,UAAe;QACjC,IAAI,MAAM,GAAW,EAAE,CAAC;QACxB,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,GAAG,UAAU,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,MAAM;gBACF,UAAU,IAAI,UAAU,CAAC,IAAI;oBACzB,CAAC,CAAC,UAAU,CAAC,IAAI;oBACjB,CAAC,CAAC,UAAU,CAAC,WAAW;wBACtB,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI;wBAC7B,CAAC,CAAC,MAAM,CAAC;QACvB,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAC1D,CAAC;QAED,qDAAqD;QACrD,IAAI,MAAM,GAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;QACxF,2FAA2F;QAC3F,yBAAyB;QACzB,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;gBACtC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC;oBAC/B,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACjC,MAAM;gBACV,CAAC;YACL,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;;;;;;;;OAUG;IACI,WAAW,CAAI,IAAS,EAAE,OAAyB;QACtD,IAAI,IAAI,GAAW,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAY,OAAO,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1F,MAAM,IAAI,GAAU,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QAExC,8CAA8C;QAC9C,MAAM,SAAS,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAEnG,0FAA0F;QAC1F,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,IAAI,GAAG,GAAG,SAAS,IAAI,IAAI,EAAE,CAAC;QAClC,CAAC;QAED,2EAA2E;QAC3E,IAAI,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACpD,CAAC;QAED,iEAAiE;QACjE,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,qCAAqC;QACrC,MAAM,KAAK,GAAQ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,SAAS,CAAC,CAAC;QAC9D,CAAC;QAED,oDAAoD;QACpD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,SAAS,gBAAgB,IAAI,GAAG,CAAC,CAAC;QACvF,MAAM,QAAQ,GAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAEvC,mCAAmC;QACnC,MAAM,CAAC,cAAc,CAAC,QAAe,EAAE,MAAM,EAAE;YAC3C,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,KAAK;YACf,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;QAEH,4CAA4C;QAC5C,IAAI,IAAI,EAAE,CAAC;YACP,8BAA8B;YAC9B,MAAM,CAAC,cAAc,CAAC,QAAe,EAAE,OAAO,EAAE;gBAC5C,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE,KAAK;gBACf,KAAK,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,qGAAqG;QACrG,6GAA6G;QAC7G,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACI,QAAQ,CAAC,KAAU,EAAE,GAAY;QACpC,MAAM,IAAI,GAAW,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC;QACzD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,IAAI,QAAQ,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;YACzE,OAAO;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,qBAAqB,IAAI,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;CACJ"}

package/dist/lib/ObjectUtils.js

@@ -0,0 +1,49 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import "reflect-metadata";
+/**
+ * Utility class for working with objects.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class ObjectUtils {
+    /**
+     * Performs validation of the given object or array. Validation is performed by scanning the object class for properties
+     * decorated with `@Validator` and executing the provided validation function.
+     *
+     * @param obj The object or array of objects to validate.
+     * @param clazz The class type that contains the validation metadata.
+     * @param recurse Set to `true` to validate all child objects.
+     */
+    static validate(obj, clazz, recurse) {
+        const objs = Array.isArray(obj) ? obj : [obj];
+        for (const obj of objs) {
+            const metadataObj = !clazz || obj instanceof clazz ? obj : new clazz();
+            // Iterate through all properties of the object
+            for (const member of Object.getOwnPropertyNames(obj)) {
+                if (member === 'constructor')
+                    continue;
+                const nullable = Reflect.getMetadata("rrst:nullable", metadataObj, member);
+                // Value of '0' is valid. Don't throw on such values.
+                if (!nullable && (obj[member] === null || obj[member] === undefined || obj[member] === "")) {
+                    throw new Error(`Property ${member} cannot be null.`);
+                }
+                const validator = Reflect.getMetadata("rrst:validator", metadataObj, member);
+                if (validator && obj[member]) {
+                    try {
+                        obj[member] = validator(obj[member]);
+                    }
+                    catch (err) {
+                        throw new Error(`Property ${member} is invalid. ${err.message}`);
+                    }
+                }
+                // If recursion is requested validate the child object
+                if (recurse && typeof obj[member] === "object") {
+                    ObjectUtils.validate(obj[member], recurse);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=ObjectUtils.js.map

package/dist/lib/ObjectUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectUtils.js","sourceRoot":"","sources":["../../src/ObjectUtils.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E,OAAO,kBAAkB,CAAC;AAG1B;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACpB;;;;;;;OAOG;IACI,MAAM,CAAC,QAAQ,CAAC,GAAQ,EAAE,KAAW,EAAE,OAAiB;QAC3D,MAAM,IAAI,GAAU,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACrD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,MAAM,WAAW,GAAQ,CAAC,KAAK,IAAI,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;YAE5E,+CAA+C;YAC/C,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnD,IAAI,MAAM,KAAK,aAAa;oBAAE,SAAS;gBAEvC,MAAM,QAAQ,GAAQ,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;gBAChF,qDAAqD;gBACrD,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;oBACzF,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,kBAAkB,CAAC,CAAC;gBAC1D,CAAC;gBAED,MAAM,SAAS,GAAkC,OAAO,CAAC,WAAW,CAAC,gBAAgB,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;gBAC5G,IAAI,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3B,IAAI,CAAC;wBACD,GAAG,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;oBACzC,CAAC;oBAAC,OAAO,GAAQ,EAAE,CAAC;wBAChB,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;oBACrE,CAAC;gBACL,CAAC;gBAED,sDAAsD;gBACtD,IAAI,OAAO,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAC7C,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC/C,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;CACJ"}