@rapidrest/core 1.0.1

package/dist/lib/StringUtils.js

@@ -0,0 +1,104 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+/**
+ * Utility functions for working with strings.
+ *
+ * @author Jean-Philippe Steinmetz
+ */
+export class StringUtils {
+    /**
+     * Returns a list of all parameters contained within the string. A parameter is a bracket delimited substring
+     * (e.g. /my/{key}/with/{id}).
+     *
+     * @param {any} str The string to search for parameters.
+     * @returns {array} A list of parameters contained in the provided string.
+     */
+    static getParameters(str) {
+        let results = new Array();
+        for (let i = 0; i < str.length; i++) {
+            let start = str.indexOf("{", i);
+            if (start !== -1) {
+                let end = str.indexOf("}", start);
+                if (end !== -1) {
+                    results.push(str.substring(start + 1, end));
+                    i = end;
+                }
+                else {
+                    break;
+                }
+            }
+            else {
+                break;
+            }
+        }
+        return results;
+    }
+    /**
+     * Performs a search and replace on the provided contents with the map of variable replacements. The contents
+     * must use Mustache formatted tokens such as `{{toreplace}}`.
+     *
+     * @param {string} contents The stringt to perform the find and replace on.
+     * @param {object} variables A map of key=>value pairs to search for and replace.
+     */
+    static findAndReplace(contents, variables) {
+        let output = contents;
+        // Go through all variables and perform replacement
+        for (let key in variables) {
+            // Perform replacement on the variable value itself. This allows nested variable replacement.
+            if (variables[key]) {
+                let value = variables[key];
+                for (let key2 in variables) {
+                    if (variables[key2]) {
+                        let value2 = variables[key2];
+                        value = value.toString().replace(new RegExp("(\\{\\{" + key2 + "\\}\\})", "g"), value2);
+                    }
+                }
+                output = output.replace(new RegExp("(\\{\\{" + key + "\\}\\})", "g"), value);
+            }
+        }
+        return output;
+    }
+    /**
+     * Replaces all instances of the match regex pattern with the contents of the inner regular expression pattern for
+     * the given string.
+     *
+     * e.g.
+     *
+     * let result = replaceAll('/my/path/{id}', new RegExp('\\{([^\\}]+)\\}'), ':');
+     * console.log(result); // -> /my/path/:id
+     *
+     * @param {string} str The string to perform replacement on.
+     * @param {RegExp} match The regular expression pattern to match containing an outer and inner pattern.
+     * @param {string} prefix The prefix to prepend the replacement text with.
+     * @returns {string} The fully replaced contents of the string.
+     */
+    static replaceAll(str, match, prefix) {
+        let result = str;
+        let matches = str.match(match);
+        while (matches) {
+            result = result.replace(matches[0], prefix + matches[1]);
+            matches = result.match(match);
+        }
+        return result;
+    }
+    /**
+     * Converts the first character in the given string to be lowercase (e.g. myVariable).
+     *
+     * @param {string} str The string to convert to camelCase.
+     * @returns {string} The string converted to camelCase.
+     */
+    static toCamelCase(str) {
+        return str.charAt(0).toLocaleLowerCase() + str.substring(1);
+    }
+    /**
+     * Converts the first character in the given string to be uppercase (e.g. MyVariable).
+     *
+     * @param {string} str The string to convert to PascalCase.
+     * @returns {string} The string converted to PascalCase.
+     */
+    static toPascalCase(str) {
+        return str.charAt(0).toLocaleUpperCase() + str.substring(1);
+    }
+}
+//# sourceMappingURL=StringUtils.js.map

package/dist/lib/StringUtils.js.map

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

package/dist/lib/TelemetryUtils.js

@@ -0,0 +1,159 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import axios from "axios";
+import * as uuid from "uuid";
+import { JWTUtils } from "./JWTUtils.js";
+/**
+ * Describes a single telemetry event. A telemetry event is when something occurs in the system.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class Event {
+    /**
+     * The universally unique identifier of the event.
+     */
+    uid;
+    /**
+     * The name of the environment that the event originated from. This is typically `dev` or `prod`.
+     */
+    environment;
+    /**
+     * The unique name of the service or client that the event originated from.
+     */
+    origin;
+    /**
+     * The date and time that the event occured.
+     */
+    timestamp = new Date();
+    /**
+     * The type of event being recorded.
+     */
+    type;
+    /**
+     * The universally unique identifer of the user that sent the event.
+     */
+    userId;
+    constructor(config, userId, data) {
+        this.uid = uuid.v4();
+        this.environment = process.env.NODE_ENV ? process.env.NODE_ENV : "prod";
+        const serviceName = config.get("service_name");
+        this.origin = serviceName ? `${serviceName}:${config.get("version")}` : "unknown";
+        this.type = data.type;
+        this.userId = userId;
+        // Copy all fields in data to this object
+        const tmp = data;
+        for (let key in tmp) {
+            if (key !== "environment" && key !== "origin" && key !== "userId") {
+                this[key] = tmp[key];
+            }
+        }
+    }
+}
+/**
+ * Provides a common set of static functions for recording and working with telemetry `Event` instances.
+ *
+ * The `init` function must be called before any other function can be called.
+ *
+ * The `record` function is used to send an event to a configured `telemetry_services` service for permanent storage.
+ *
+ * The `on` function allows code within the same application or service to listen for outgoing events that have been
+ * sent via the `record` function.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class EventUtils {
+    static initialized = false;
+    static config;
+    static listeners = new Map();
+    static logger;
+    static token;
+    static userId;
+    /**
+     * Initializes `EventUtils` with the provided defaults.
+     *
+     * @param config The application configuration to use.
+     * @param logger The logging utility to use.
+     * @param jwtToken The user's JWT token to send telemetry events on behalf of.
+     */
+    static init(config, logger, jwtToken) {
+        EventUtils.config = config;
+        EventUtils.listeners = new Map();
+        EventUtils.logger = logger;
+        EventUtils.token = jwtToken;
+        // Extract the user id from the token
+        const payload = JWTUtils.decodeToken(config.get("auth"), jwtToken);
+        EventUtils.userId = payload.profile.uid;
+        EventUtils.initialized = true;
+    }
+    /**
+     * Sends the given event to the telemetry service for permanent recording.
+     *
+     * @param evt The event to send and record.
+     * @param type The type of event to record. Overrides any `type` value set in `evt`.
+     */
+    static async record(evt, type) {
+        try {
+            if (!EventUtils.initialized) {
+                throw new Error("EventUtils has not been initialized. Did you call EventUtils.init()?");
+            }
+            if (type) {
+                evt.type = type;
+            }
+            if (!evt.type || evt.type.length === 0) {
+                throw new Error("Events must have a `type` specified.");
+            }
+            // Create the event instance that will be sent for storage
+            const event = evt instanceof Event ? evt : new Event(EventUtils.config, EventUtils.userId, evt);
+            // Send to the telemetry service
+            const baseUrl = EventUtils.config.get("telemetry_services:url");
+            if (baseUrl) {
+                const url = baseUrl + "/events";
+                const response = await axios.post(url, event, {
+                    headers: {
+                        Authorization: "jwt " + EventUtils.token,
+                    }
+                });
+            }
+            else {
+                EventUtils.logger?.debug("Failed to send telemetry event. telemetry_services:url has not been set in the config.");
+            }
+            // Notify any registered listeners
+            const callbacks = EventUtils.listeners.get(evt.type);
+            if (callbacks) {
+                for (let func of callbacks) {
+                    func(event);
+                }
+            }
+        }
+        catch (err) {
+            if (!EventUtils.logger) {
+                console.warn(`Failed to send telemetry event. Error: ${err.message}`);
+            }
+            else {
+                EventUtils.logger.warn(`Failed to send telemetry event. Error: ${err.message}`);
+            }
+        }
+    }
+    /**
+     * Registers a `callback` function to receive notifications of recorded events of the given `type`. Note that only
+     * events originating from the same application or service will be notified.
+     *
+     * @param type The type of event to be notified of.
+     * @param callback The function to call when an event is recorded.
+     */
+    static on(type, callback) {
+        if (!EventUtils.initialized) {
+            throw new Error("EventUtils has not been initialized. Did you call EventUtils.init()?");
+        }
+        if (!EventUtils.listeners.has(type)) {
+            EventUtils.listeners.set(type, []);
+        }
+        const callbacks = EventUtils.listeners.get(type);
+        if (callbacks) {
+            callbacks.push(callback);
+            EventUtils.listeners.set(type, callbacks);
+        }
+    }
+}
+//# sourceMappingURL=TelemetryUtils.js.map

package/dist/lib/TelemetryUtils.js.map

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

package/dist/lib/UserUtils.js

@@ -0,0 +1,138 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+/**
+ * Utilities for working with authenticated user objects. An user object is expected to have the following
+ * properties.
+ *
+ * * `uid` - Universally unique identifier for the user
+ * * `email` - Unique e-mail address for the user
+ * * `roles` - A list of unique names indicating the permissions of the user.
+ * * `verified` - Indicates if the user's e-mail address has been verified.
+ *
+ * @author Jean-Philippe Steinmetz <rapidrests@gmail.com>
+ */
+export class UserUtils {
+    /**
+     * Returns `true` if the given user object is a member of the organization with the specified uid, otherwise returns `false`.
+     * @param user The user object to inspect.
+     * @param organizationUid The universally unique identifier of the persona to search for.
+     */
+    static hasOrganization(user, organizationUid) {
+        if (user && user.orgs && Array.isArray(user.orgs)) {
+            for (const uid of user.orgs) {
+                if (uid === organizationUid) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Returns `true` if the given user object contains is a member of an organization matching one of the uids in the specified list, otherwise returns `false`.
+     * @param user The user object to inspect.
+     * @param organizationUids The list of universally unique identifiers to search for.
+     */
+    static hasOrganizations(user, organizationUids) {
+        if (user && user.orgs && Array.isArray(user.orgs) && Array.isArray(organizationUids)) {
+            for (const organizationUid of organizationUids) {
+                for (const uid of user.orgs) {
+                    if (uid === organizationUid) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Returns `true` if the given user object contains a `Persona` object with the specified uid, otherwise returns `false`.
+     * @param user The user object to inspect.
+     * @param personaUid The universally unique identifier of the persona to search for.
+     */
+    static hasPersona(user, personaUid) {
+        if (user && user.personas && Array.isArray(user.personas) && personaUid) {
+            for (const persona of user.personas) {
+                if (persona.uid === personaUid) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Returns `true` if the given user object contains a `Persona` object matching one of the uids in the specified list, otherwise returns `false`.
+     * @param user The user object to inspect.
+     * @param personaUid The list of universally unique identifiers to search for.
+     */
+    static hasPersonas(user, personaUids) {
+        if (user && user.personas && Array.isArray(user.personas) && Array.isArray(personaUids)) {
+            for (const personaUid of personaUids) {
+                for (const persona of user.personas) {
+                    if (persona.uid === personaUid) {
+                        return true;
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Returns the unique identifier of the specified type associated with the given user.
+     *
+     * @param user The user to retrieve the external id from.
+     * @param type The type of external provider to retrieve.
+     * @returns The unique id of the external provider for the given type if found, otherwise `undefined`.
+     */
+    static getExternalId(user, type) {
+        let result = undefined;
+        if (user && Array.isArray(user.externalIds)) {
+            for (const externalId of user.externalIds) {
+                const parts = externalId.split(":");
+                if (parts.length === 2 && parts[0] === type) {
+                    result = parts[1];
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Returns `true` if the given user object has a role with the specified name, otherwise returns `false`.
+     *
+     * @param user The user object to inspect.
+     * @param role The unique name of the role to search for.
+     * @param orgUid The unique identifier of an organization whose role will be verified.
+     */
+    static hasRole(user, role, orgUid) {
+        let result = false;
+        if (user) {
+            if (user.roles) {
+                if (Array.isArray(user.roles)) {
+                    result = user.roles.includes(role);
+                    if (!result && orgUid !== "") {
+                        result = user.roles.includes(`${orgUid}.${role}`);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * Returns `true` if the given user object has at least one role from the specified list of names, otherwise returns `false`.
+     *
+     * @param user The user object to inspect.
+     * @param roles A list of unique names of the roles to search for.
+     * @param orgUid The unique identifier of an organization whose role will be verified.
+     */
+    static hasRoles(user, roles, orgUid) {
+        if (user && user.roles && Array.isArray(user.roles) && Array.isArray(roles)) {
+            for (const role of roles) {
+                if (UserUtils.hasRole(user, role, orgUid)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=UserUtils.js.map

package/dist/lib/UserUtils.js.map

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

package/dist/lib/ValidationUtils.js

@@ -0,0 +1,130 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import validator from "validator";
+/**
+ * A collection of validation functions to use with the `@Validator()` decorator.
+ */
+export class ValidationUtils {
+    /**
+     * A simple wrapper that calls the specified boolean validation function with the given value and returns the
+     * value as a result if the validation function passes. Otherwise throws an error.
+     *
+     * @param val The value to validate.
+     * @param func The boolean validation function to check the value.
+     * @throws Throws an error if the value fails the boolean validation test.
+     */
+    static check(val, func) {
+        if (!func(val)) {
+            throw new Error(`Value failed validation: ${func.name}`);
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string represents a ISO, RFC or UTC date or timestamp.
+     */
+    static checkDate(val) {
+        if (!validator.isDate(val)) {
+            throw new Error("Value is not a Date.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string represents a valid e-mail address.
+     */
+    static checkEmail(val) {
+        if (!validator.isEmail(val)) {
+            throw new Error("Value is not a valid email addresss.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided array is not empty.
+     */
+    static checkEmpty(val) {
+        if (val && val.length === 0) {
+            throw new Error("Value cannot be empty.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string is a valid IP address.
+     */
+    static checkIP(val) {
+        if (!validator.isIP(val)) {
+            throw new Error("Value is not a valid IP address.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string is valid JSON (note: uses `JSON.parse`).
+     */
+    static checkJSON(val) {
+        if (!validator.isJSON(val)) {
+            throw new Error("Value is not valid JSON.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string matches the regexp pattern /[a-zA-Z0-9_\-\.@:\+]+/.
+     */
+    static checkName(val) {
+        if (!/[a-zA-Z0-9_\-]+/.test(val)) {
+            throw new Error("Value is not a name matching pattern /[a-zA-Z0-9_\-\.@:\+]+/");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided object is not null or empty.
+     */
+    static checkNull(val) {
+        if (typeof val !== "boolean" && !val) {
+            throw new Error("Value cannot be null.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string represents a valid phone number.
+     */
+    static checkPhone(val) {
+        if (!validator.isMobilePhone(val)) {
+            throw new Error("Value is not a valid phone number.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string represents a semantic version.
+     */
+    static checkSemVer(val) {
+        if (!validator.isSemVer(val)) {
+            throw new Error("Value is not a valid semantic version.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string is a valid URL.
+     */
+    static checkURL(val) {
+        if (!validator.isURL(val)) {
+            throw new Error("Value is not a URL.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided string is a valid UUID.
+     */
+    static checkUUID(val) {
+        if (!validator.isUUID(val)) {
+            throw new Error("Value is not a UUID.");
+        }
+        return val;
+    }
+    /**
+     * Validates that the provided value is an entity `version` number (e.g. `value > 0`).
+     */
+    static checkVersion(val) {
+        const num = Number(val);
+        return Math.max(num, 0);
+    }
+}
+//# sourceMappingURL=ValidationUtils.js.map

package/dist/lib/ValidationUtils.js.map

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

package/dist/lib/decorators/ObjectDecorators.js

@@ -0,0 +1,95 @@
+///////////////////////////////////////////////////////////////////////////////
+// Copyright (C) 2020-2026 Jean-Philippe Steinmetz
+///////////////////////////////////////////////////////////////////////////////
+import "reflect-metadata";
+/**
+ * Apply this to a class function to mark it as a destructor to be called by the `ObjectFactory` during cleanup.
+ */
+export function Destroy(target, propertyKey) {
+    Reflect.defineMetadata("rrst:destructor", true, target, propertyKey);
+}
+/**
+ * Injects an object instance to the decorated property of the given name and type using the provided arguments
+ * if no object has been created yet.
+ * @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
+ */
+export function Inject(type, options) {
+    return function (target, propertyKey) {
+        options = {
+            ...options,
+            name: options?.name || "default",
+        };
+        Reflect.defineMetadata("rrst:injectObject", {
+            options,
+            type,
+        }, target, propertyKey);
+        Object.defineProperty(target, propertyKey, {
+            enumerable: true,
+            writable: true,
+            value: undefined,
+        });
+    };
+}
+/**
+ * Apply this to a function to be executed once a new object instance has been created and all dependencies injected.
+ * Note: If the decorated function returns a Promise it is not gauranteed to finish execution before the object is
+ * returned during the instantiation process.
+ */
+export function Init(target, propertyKey, descriptor) {
+    Reflect.defineMetadata("rrst:initialize", true, target, propertyKey);
+}
+/**
+ * Apply this to a property to have a configuration variable be injected at instantiation. If no path is given, the
+ * global configuration object is injected.
+ *
+ * @param path The path to the configuration variable to inject.
+ * @param defaultValue Set to the desired default value. If `undefined` is specified then an error is thrown if
+ * no config variable is found at the given path.
+ */
+export function Config(path, defaultValue = undefined) {
+    return function (target, propertyKey) {
+        Reflect.defineMetadata("rrst:injectConfig", path ? path : true, target, propertyKey);
+        Reflect.defineMetadata("rrst:injectConfigDefault", defaultValue, target, propertyKey);
+        const key = `__${String(propertyKey)}`;
+        Object.defineProperty(target, propertyKey, {
+            enumerable: true,
+            writable: true,
+            value: undefined,
+        });
+    };
+}
+/**
+ * Apply this to a property to have the logger utility injected at instantiation.
+ */
+export function Logger(target, propertyKey) {
+    Reflect.defineMetadata("rrst:injectLogger", true, target, propertyKey);
+    const key = `__${String(propertyKey)}`;
+    Object.defineProperty(target, propertyKey, {
+        enumerable: true,
+        writable: true,
+        value: undefined,
+    });
+}
+/**
+ * Apply this to a property to indicate that the value can be `null` or `undefined.`
+ *
+ * @param nullable Set to `true` to indicate that the property value can be `null`, otherwise set to `false`. Default is `false`.
+ */
+export function Nullable(target, propertyKey) {
+    Reflect.defineMetadata("rrst:nullable", true, target, propertyKey);
+}
+/**
+ * Apply this to a property to specify the function that will be used to perform validation of the value.
+ *
+ * @param func The validation function to use for the given property.
+ */
+export function Validator(func) {
+    return function (target, propertyKey) {
+        Reflect.defineMetadata("rrst:validator", func, target, propertyKey);
+    };
+}
+//# sourceMappingURL=ObjectDecorators.js.map

package/dist/lib/decorators/ObjectDecorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ObjectDecorators.js","sourceRoot":"","sources":["../../../src/decorators/ObjectDecorators.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kDAAkD;AAClD,+EAA+E;AAC/E,OAAO,kBAAkB,CAAC;AAG1B;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,MAAW,EAAE,WAAmB;IACpD,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,IAAS,EAAE,OAAyB;IACvD,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,GAAG;YACN,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,SAAS;SACnC,CAAC;QACF,OAAO,CAAC,cAAc,CAClB,mBAAmB,EACnB;YACI,OAAO;YACP,IAAI;SACP,EACD,MAAM,EACN,WAAW,CACd,CAAC;QACF,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACvC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,MAAW,EAAE,WAAmB,EAAE,UAA8B;IACjF,OAAO,CAAC,cAAc,CAAC,iBAAiB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,IAAa,EAAE,eAAoB,SAAS;IAC/D,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACrF,OAAO,CAAC,cAAc,CAAC,0BAA0B,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACtF,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;YACvC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,SAAS;SACnB,CAAC,CAAC;IACP,CAAC,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,MAAW,EAAE,WAA4B;IAC5D,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,KAAK,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;IACvC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;QACvC,UAAU,EAAE,IAAI;QAChB,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,SAAS;KACnB,CAAC,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAW,EAAE,WAA4B;IAC9D,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACvE,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,IAAuB;IAC7C,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,CAAC,cAAc,CAAC,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACxE,CAAC,CAAA;AACL,CAAC"}