@adaas/a-utils 0.0.2

package/.nvmrc

@@ -0,0 +1 @@
+v20.10.0

package/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2024 ADAAS <https://adaas.org>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+<img align="left" style="margin-right:40px; margin-bottom:80px;" width="180" height="80" src="./docs/a-logo-docs.png" alt="ADAAS Logo">
+
+# A-Utils SDK 
+
+This package is a set of common utils that can be used across projects related or not related to ADAAS Ecosystem. 
+In this package it is possible to find useful features to work with structures, objects and types.  
+
+
+| LTS | Latest | npm               |
+|---------------|----------|---------------------------|
+| v1.0.0      |   v1.0.1    |     [@adaas/a-utils](https://npm.com)    |
+
+
+<!-- TABLE OF CONTENTS -->
+## Table of Contents
+
+- [About the Project](#overview)
+- [Installation](#installation)
+- [ENV Variables](#environment-variables)
+- [Links](#links)
+
+
+## Installation
+
+```bash
+
+cd /your/project/location
+adf
+npm i @adaas/a-utils
+
+```
+
+
+
+
+
+## Environment Variables
+
+| Variable Name | Required | Description               |
+|---------------|----------|---------------------------|
+| A_NAMESPACE      |    YES    |      Your desired Namespace for the project     |
+
+
+## Links
+
+- [ADAAS Website](https://adaas.org)
+- [Report Issues](https://github.com/ADAAS-org/adaas-a-utils/issues)
+- [Become Future Creator](https://sso.adaas.org)
+---

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { A_CommonHelper } from './src/helpers/A_Common.helper';
+export { A_ScheduleHelper } from './src/helpers/A_Schedule.helper';
+export { A_Error } from './src/global/A_Error.class';
+export { A_ServerError } from './src/global/A_ServerError.class';
+export { ASEID } from './src/global/ASEID.class';
+export { A_Entity } from './src/global/A_Entity.class';
+export { A_ScheduleObject } from './src/global/A_ScheduleObject.class';
+export { A_Polyfills } from './src/global/A_Polyfills';
+export { A_CONSTANTS__ERROR_CODES } from './src/constants/errors.constants';
+export { A_TYPES__DeepPartial, A_TYPES__Dictionary, A_TYPES__ObjectKeyEnum, A_TYPES__Required, A_TYPES__Paths, A_TYPES__PathsToObject, A_TYPES__UnionToIntersection, A_TYPES__ExtractProperties, A_TYPES__ExtractNested, A_TYPES__NonObjectPaths } from './src/types/A_Common.types';
+export { A_TYPES__IAEntity, A_TYPES__AEntity_JSON } from './src/types/A_Entity.types';
+export { A_TYPES__ScheduleObjectConfig } from './src/types/A_ScheduleObject.types';
+export { A_TYPES__Error } from './src/types/A_Error.types';
+export { A_TYPES__ServerError } from './src/types/A_ServerError.types';
+export { A_TYPES__ASEID_Constructor, A_TYPES__ASEID_ConstructorConfig, A_TYPES__ASEID_JSON } from './src/types/ASEID.types';

package/dist/index.js

@@ -0,0 +1,26 @@
+"use strict";
+// ====================== EXPORTS ======================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_CONSTANTS__ERROR_CODES = exports.A_Polyfills = exports.A_ScheduleObject = exports.A_Entity = exports.ASEID = exports.A_ServerError = exports.A_Error = exports.A_ScheduleHelper = exports.A_CommonHelper = void 0;
+// --- Helpers ---
+var A_Common_helper_1 = require("./src/helpers/A_Common.helper");
+Object.defineProperty(exports, "A_CommonHelper", { enumerable: true, get: function () { return A_Common_helper_1.A_CommonHelper; } });
+var A_Schedule_helper_1 = require("./src/helpers/A_Schedule.helper");
+Object.defineProperty(exports, "A_ScheduleHelper", { enumerable: true, get: function () { return A_Schedule_helper_1.A_ScheduleHelper; } });
+// --- Global ---
+var A_Error_class_1 = require("./src/global/A_Error.class");
+Object.defineProperty(exports, "A_Error", { enumerable: true, get: function () { return A_Error_class_1.A_Error; } });
+var A_ServerError_class_1 = require("./src/global/A_ServerError.class");
+Object.defineProperty(exports, "A_ServerError", { enumerable: true, get: function () { return A_ServerError_class_1.A_ServerError; } });
+var ASEID_class_1 = require("./src/global/ASEID.class");
+Object.defineProperty(exports, "ASEID", { enumerable: true, get: function () { return ASEID_class_1.ASEID; } });
+var A_Entity_class_1 = require("./src/global/A_Entity.class");
+Object.defineProperty(exports, "A_Entity", { enumerable: true, get: function () { return A_Entity_class_1.A_Entity; } });
+var A_ScheduleObject_class_1 = require("./src/global/A_ScheduleObject.class");
+Object.defineProperty(exports, "A_ScheduleObject", { enumerable: true, get: function () { return A_ScheduleObject_class_1.A_ScheduleObject; } });
+var A_Polyfills_1 = require("./src/global/A_Polyfills");
+Object.defineProperty(exports, "A_Polyfills", { enumerable: true, get: function () { return A_Polyfills_1.A_Polyfills; } });
+// --- Constants ---
+var errors_constants_1 = require("./src/constants/errors.constants");
+Object.defineProperty(exports, "A_CONSTANTS__ERROR_CODES", { enumerable: true, get: function () { return errors_constants_1.A_CONSTANTS__ERROR_CODES; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";AAEA,wDAAwD;;;AAGxD,kBAAkB;AAClB,iEAA+D;AAAtD,iHAAA,cAAc,OAAA;AACvB,qEAAmE;AAA1D,qHAAA,gBAAgB,OAAA;AAGzB,iBAAiB;AACjB,4DAAqD;AAA5C,wGAAA,OAAO,OAAA;AAChB,wEAAiE;AAAxD,oHAAA,aAAa,OAAA;AAEtB,wDAAiD;AAAxC,oGAAA,KAAK,OAAA;AACd,8DAAuD;AAA9C,0GAAA,QAAQ,OAAA;AAEjB,8EAAuE;AAA9D,0HAAA,gBAAgB,OAAA;AAIzB,wDAEiC;AAD7B,0GAAA,WAAW,OAAA;AAGf,oBAAoB;AACpB,qEAA4E;AAAnE,4HAAA,wBAAwB,OAAA"}

package/dist/src/constants/errors.constants.d.ts

@@ -0,0 +1,65 @@
+export declare enum A_CONSTANTS__ERROR_CODES {
+    INCORRECT_A_ENTITY_CONSTRUCTOR = "ERR-A-Entity-0001",
+    INVALID_ASEID = "ERR-ASEID-0001",
+    UNEXPECTED_ERROR = "ERR-0001",
+    METHOD_NOT_IMPLEMENTED = "ERR-0002",
+    ROUTE_NOT_FOUND = "ERR-0003",
+    TOKEN_NOT_PROVIDED = "ERR-0004",
+    NOT_ALL_PARAMS_WAS_PROVIDED = "ERR-0005",
+    CREDENTIALS_NOT_PROVIDED = "ERR-0006",
+    CONFIGURATION_PROPERTY_NOT_EXISTS_OR_NOT_ALLOWED_TO_READ = "ERR-0007"
+}
+export declare const A_CONSTANTS__DEFAULT_ERRORS: {
+    INCORRECT_A_ENTITY_CONSTRUCTOR: {
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+    INVALID_ASEID: {
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+    UNEXPECTED_ERROR: {
+        serverCode: number;
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+    METHOD_NOT_IMPLEMENTED: {
+        serverCode: number;
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+        link: string;
+    };
+    ROUTE_NOT_FOUND: {
+        serverCode: number;
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+    TOKEN_NOT_PROVIDED: {
+        serverCode: number;
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+    NOT_ALL_PARAMS_WAS_PROVIDED: {
+        serverCode: number;
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+    CREDENTIALS_NOT_PROVIDED: {
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+    CONFIGURATION_PROPERTY_NOT_EXISTS_OR_NOT_ALLOWED_TO_READ: {
+        serverCode: number;
+        code: A_CONSTANTS__ERROR_CODES;
+        description: string;
+        message: string;
+    };
+};

package/dist/src/constants/errors.constants.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_CONSTANTS__DEFAULT_ERRORS = exports.A_CONSTANTS__ERROR_CODES = void 0;
+var A_CONSTANTS__ERROR_CODES;
+(function (A_CONSTANTS__ERROR_CODES) {
+    // Default Utils Errors 
+    A_CONSTANTS__ERROR_CODES["INCORRECT_A_ENTITY_CONSTRUCTOR"] = "ERR-A-Entity-0001";
+    A_CONSTANTS__ERROR_CODES["INVALID_ASEID"] = "ERR-ASEID-0001";
+    A_CONSTANTS__ERROR_CODES["UNEXPECTED_ERROR"] = "ERR-0001";
+    A_CONSTANTS__ERROR_CODES["METHOD_NOT_IMPLEMENTED"] = "ERR-0002";
+    A_CONSTANTS__ERROR_CODES["ROUTE_NOT_FOUND"] = "ERR-0003";
+    A_CONSTANTS__ERROR_CODES["TOKEN_NOT_PROVIDED"] = "ERR-0004";
+    A_CONSTANTS__ERROR_CODES["NOT_ALL_PARAMS_WAS_PROVIDED"] = "ERR-0005";
+    A_CONSTANTS__ERROR_CODES["CREDENTIALS_NOT_PROVIDED"] = "ERR-0006";
+    A_CONSTANTS__ERROR_CODES["CONFIGURATION_PROPERTY_NOT_EXISTS_OR_NOT_ALLOWED_TO_READ"] = "ERR-0007";
+})(A_CONSTANTS__ERROR_CODES || (exports.A_CONSTANTS__ERROR_CODES = A_CONSTANTS__ERROR_CODES = {}));
+;
+exports.A_CONSTANTS__DEFAULT_ERRORS = {
+    // Default A-Utils Errors
+    INCORRECT_A_ENTITY_CONSTRUCTOR: {
+        code: A_CONSTANTS__ERROR_CODES.INCORRECT_A_ENTITY_CONSTRUCTOR,
+        description: 'The A_Entity constructor was called with incorrect parameters.',
+        message: 'Incorrect A_Entity constructor parameters.'
+    },
+    INVALID_ASEID: {
+        code: A_CONSTANTS__ERROR_CODES.INVALID_ASEID,
+        description: 'The provided ASEID is invalid.',
+        message: 'Invalid ASEID provided.'
+    },
+    // Default Utils Server Errors
+    UNEXPECTED_ERROR: {
+        serverCode: 500,
+        code: A_CONSTANTS__ERROR_CODES.UNEXPECTED_ERROR,
+        description: 'If you see this error please let us know.',
+        message: 'Oops... Something went wrong',
+    },
+    METHOD_NOT_IMPLEMENTED: {
+        serverCode: 500,
+        code: A_CONSTANTS__ERROR_CODES.METHOD_NOT_IMPLEMENTED,
+        description: 'If you see this error please let us know.',
+        message: 'Oops... Something went wrong',
+        link: 'https://support.adaas.org/error/' + A_CONSTANTS__ERROR_CODES.UNEXPECTED_ERROR
+    },
+    ROUTE_NOT_FOUND: {
+        serverCode: 404,
+        code: A_CONSTANTS__ERROR_CODES.ROUTE_NOT_FOUND,
+        description: 'We can not find the route you\'re looking for. Please make sure that you\'re using the correct path.',
+        message: 'The target route is not found.'
+    },
+    TOKEN_NOT_PROVIDED: {
+        serverCode: 401,
+        code: A_CONSTANTS__ERROR_CODES.TOKEN_NOT_PROVIDED,
+        description: 'The token is missed in the Authorization header. Please make sure that it\'s presented.',
+        message: 'Token has not found in the authorization header.'
+    },
+    NOT_ALL_PARAMS_WAS_PROVIDED: {
+        serverCode: 409,
+        code: A_CONSTANTS__ERROR_CODES.NOT_ALL_PARAMS_WAS_PROVIDED,
+        description: 'Not all required params provided in the request',
+        message: 'Conflict in request'
+    },
+    CREDENTIALS_NOT_PROVIDED: {
+        code: A_CONSTANTS__ERROR_CODES.CREDENTIALS_NOT_PROVIDED,
+        description: 'The credentials are missed. Please make sure that they are presented.',
+        message: 'Credentials has not found in the request.'
+    },
+    CONFIGURATION_PROPERTY_NOT_EXISTS_OR_NOT_ALLOWED_TO_READ: {
+        serverCode: 403,
+        code: A_CONSTANTS__ERROR_CODES.CONFIGURATION_PROPERTY_NOT_EXISTS_OR_NOT_ALLOWED_TO_READ,
+        description: 'The configuration property is not exists or not allowed to read.',
+        message: 'Configuration property is not exists or not allowed to read.'
+    }
+};
+//# sourceMappingURL=errors.constants.js.map

package/dist/src/constants/errors.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.constants.js","sourceRoot":"","sources":["../../../src/constants/errors.constants.ts"],"names":[],"mappings":";;;AACA,IAAY,wBAaX;AAbD,WAAY,wBAAwB;IAChC,wBAAwB;IACxB,gFAAoD,CAAA;IACpD,4DAAgC,CAAA;IAGhC,yDAA6B,CAAA;IAC7B,+DAAmC,CAAA;IACnC,wDAA4B,CAAA;IAC5B,2DAA+B,CAAA;IAC/B,oEAAwC,CAAA;IACxC,iEAAqC,CAAA;IACrC,iGAAqE,CAAA;AACzE,CAAC,EAbW,wBAAwB,wCAAxB,wBAAwB,QAanC;AAAA,CAAC;AAGW,QAAA,2BAA2B,GAAG;IACvC,yBAAyB;IACzB,8BAA8B,EAAE;QAC5B,IAAI,EAAE,wBAAwB,CAAC,8BAA8B;QAC7D,WAAW,EAAE,gEAAgE;QAC7E,OAAO,EAAE,4CAA4C;KACxD;IACD,aAAa,EAAE;QACX,IAAI,EAAE,wBAAwB,CAAC,aAAa;QAC5C,WAAW,EAAE,gCAAgC;QAC7C,OAAO,EAAE,yBAAyB;KACrC;IAGD,8BAA8B;IAC9B,gBAAgB,EAAE;QACd,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,wBAAwB,CAAC,gBAAgB;QAC/C,WAAW,EAAE,2CAA2C;QACxD,OAAO,EAAE,8BAA8B;KAC1C;IACD,sBAAsB,EAAE;QACpB,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,wBAAwB,CAAC,sBAAsB;QACrD,WAAW,EAAE,2CAA2C;QACxD,OAAO,EAAE,8BAA8B;QACvC,IAAI,EAAE,kCAAkC,GAAG,wBAAwB,CAAC,gBAAgB;KACvF;IACD,eAAe,EAAE;QACb,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,wBAAwB,CAAC,eAAe;QAC9C,WAAW,EAAE,sGAAsG;QACnH,OAAO,EAAE,gCAAgC;KAC5C;IACD,kBAAkB,EAAE;QAChB,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,wBAAwB,CAAC,kBAAkB;QACjD,WAAW,EAAE,yFAAyF;QACtG,OAAO,EAAE,kDAAkD;KAC9D;IACD,2BAA2B,EAAE;QACzB,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,wBAAwB,CAAC,2BAA2B;QAC1D,WAAW,EAAE,iDAAiD;QAC9D,OAAO,EAAE,qBAAqB;KACjC;IACD,wBAAwB,EAAE;QACtB,IAAI,EAAE,wBAAwB,CAAC,wBAAwB;QACvD,WAAW,EAAE,uEAAuE;QACpF,OAAO,EAAE,2CAA2C;KACvD;IACD,wDAAwD,EAAE;QACtD,UAAU,EAAE,GAAG;QACf,IAAI,EAAE,wBAAwB,CAAC,wDAAwD;QACvF,WAAW,EAAE,kEAAkE;QAC/E,OAAO,EAAE,8DAA8D;KAC1E;CAIJ,CAAA"}

package/dist/src/global/ASEID.class.d.ts

@@ -0,0 +1,77 @@
+import { A_TYPES__ASEID_Constructor, A_TYPES__ASEID_JSON } from "../types/ASEID.types";
+/**
+ *  A - ADAAS
+ *  S - System
+ *  E - Entity
+ *  I - Identifier
+ *  D - iDentifier
+ *
+ *
+ *  adaas-sso@scope:usr:0000000001
+ *
+ *  APP_NAMESPACE + @ + SCOPE + : ENTITY_NAME + : + ID + @ + VERSION
+ */
+export declare class ASEID {
+    static regexp: RegExp;
+    /**
+     * Namespace for the ASEID
+     * Generally it is the application name or code, should correspond to the namespace of the application
+     * Could be ID or ASEID
+     */
+    private _namespace;
+    /**
+     * Entity Scope the primary location of the resource
+     * Organization, or organization Unit
+     * Could be ID or ASEID
+     *
+     */
+    private _scope;
+    /**
+     * Entity Type the type of the resource
+     */
+    private _entity;
+    /**
+     * Entity ID the unique identifier of the resource
+     */
+    private _id;
+    /**
+     * Version of the entity (optional)
+     */
+    private _version?;
+    /**
+     * Shard of the entity (optional)
+     */
+    private _shard?;
+    constructor(aseid: string);
+    constructor(props: A_TYPES__ASEID_Constructor);
+    get namespace(): string;
+    get scope(): string;
+    get entity(): string;
+    get id(): string;
+    get version(): string | undefined;
+    get shard(): string | undefined;
+    /**
+     * Tests if the identity string is an ASEID
+     *
+     * @param identity
+     * @returns
+     */
+    static isASEID(identity: string): boolean;
+    /**
+  * Generate an ASEID from a namespace, entity, and id
+  *
+  * @param props
+  * @returns
+  */
+    static generateASEID(props: A_TYPES__ASEID_Constructor): string;
+    /**
+     * Parse ASEID into its components
+     *
+     *
+     * @param identity
+     * @returns
+     */
+    static parseASEID(identity: string): A_TYPES__ASEID_JSON;
+    toString(): string;
+    toJSON(): A_TYPES__ASEID_JSON;
+}

package/dist/src/global/ASEID.class.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASEID = void 0;
+const errors_constants_1 = require("../constants/errors.constants");
+const A_Common_helper_1 = require("../helpers/A_Common.helper");
+const A_Error_class_1 = require("./A_Error.class");
+/**
+ *  A - ADAAS
+ *  S - System
+ *  E - Entity
+ *  I - Identifier
+ *  D - iDentifier
+ *
+ *
+ *  adaas-sso@scope:usr:0000000001
+ *
+ *  APP_NAMESPACE + @ + SCOPE + : ENTITY_NAME + : + ID + @ + VERSION
+ */
+class ASEID {
+    constructor(param1) {
+        if (typeof param1 === 'string' && !ASEID.isASEID(param1)) {
+            throw new A_Error_class_1.A_Error(errors_constants_1.A_CONSTANTS__DEFAULT_ERRORS.INVALID_ASEID);
+        }
+        const aseidString = typeof param1 === 'string' ? param1 : ASEID.generateASEID(param1);
+        const { namespace, scope, entity, id, version, shard } = ASEID.parseASEID(aseidString);
+        this._namespace = namespace;
+        this._scope = scope;
+        this._entity = entity;
+        this._id = id;
+        this._version = version;
+        this._shard = shard;
+    }
+    get namespace() {
+        return this._namespace;
+    }
+    get scope() {
+        return this._scope;
+    }
+    get entity() {
+        return this._entity;
+    }
+    get id() {
+        return this._id;
+    }
+    get version() {
+        return this._version;
+    }
+    get shard() {
+        return this._shard;
+    }
+    /**
+     * Tests if the identity string is an ASEID
+     *
+     * @param identity
+     * @returns
+     */
+    static isASEID(identity) {
+        return this.regexp.test(identity);
+    }
+    /**
+  * Generate an ASEID from a namespace, entity, and id
+  *
+  * @param props
+  * @returns
+  */
+    static generateASEID(props) {
+        const namespace = props.namespace
+            ? this.isASEID(props.namespace)
+                ? this.parseASEID(props.namespace).id
+                : props.namespace
+            : process.env.A_NAMESPACE;
+        const scope = typeof props.scope === 'number'
+            ? A_Common_helper_1.A_CommonHelper.formatWithLeadingZeros(props.scope) :
+            this.isASEID(props.scope)
+                ? this.parseASEID(props.scope).id
+                : props.scope;
+        const entity = props.entity;
+        const id = typeof props.id === 'number'
+            ? A_Common_helper_1.A_CommonHelper.formatWithLeadingZeros(props.id)
+            : props.id;
+        const version = props.version;
+        const shard = !props.shard ? undefined : props.shard;
+        return `${namespace}@${scope}:${entity}:${shard ? (shard + '--' + id) : id}${version ? ('@' + version) : ''}`;
+    }
+    /**
+     * Parse ASEID into its components
+     *
+     *
+     * @param identity
+     * @returns
+     */
+    static parseASEID(identity) {
+        const [namespace, body, version] = identity.split('@');
+        const [scope, entity, idCandidate] = body.split(':');
+        const shard = idCandidate.includes('--') ? idCandidate.split('--')[0] : undefined;
+        const id = idCandidate.includes('--') ? idCandidate.split('--')[1] : idCandidate;
+        return {
+            namespace,
+            scope: scope,
+            entity,
+            id: id,
+            version: version ? version : undefined,
+            shard
+        };
+    }
+    toString() {
+        return ASEID.generateASEID({
+            namespace: this._namespace,
+            scope: this._scope,
+            entity: this._entity,
+            id: this._id,
+            version: this._version,
+            shard: this._shard
+        });
+    }
+    toJSON() {
+        return {
+            namespace: this._namespace,
+            scope: this._scope,
+            entity: this._entity,
+            id: this._id,
+            version: this._version,
+            shard: this._shard
+        };
+    }
+}
+exports.ASEID = ASEID;
+ASEID.regexp = new RegExp(`^[a-z|A-Z|0-9]+@[a-z|A-Z|0-9|-]+:[a-z|A-Z]+:[a-z|A-Z|0-9|-]+(@v[0-9]+|@lts)?$`);
+//# sourceMappingURL=ASEID.class.js.map

package/dist/src/global/ASEID.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ASEID.class.js","sourceRoot":"","sources":["../../../src/global/ASEID.class.ts"],"names":[],"mappings":";;;AAAA,oEAA4E;AAC5E,gEAA4D;AAE5D,mDAA0C;AAG1C;;;;;;;;;;;GAWG;AACH,MAAa,KAAK;IAgDd,YAAY,MAA2C;QAEnD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,IAAI,uBAAO,CAAC,8CAA2B,CAAC,aAAa,CAAC,CAAA;QAChE,CAAC;QAED,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAEtF,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAEvF,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAGD,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAED,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,GAAG,CAAC;IACpB,CAAC;IAED,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAGD;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CACnB,QAAQ,CACX,CAAA;IACL,CAAC;IAED;;;;;IAKA;IACA,MAAM,CAAC,aAAa,CAChB,KAAiC;QAGjC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS;YAC7B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;gBAC3B,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE;gBACrC,CAAC,CAAC,KAAK,CAAC,SAAS;YACrB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;QAE9B,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;YACzC,CAAC,CAAC,gCAAc,CAAC,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;gBACrB,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE;gBACjC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAEtB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAE5B,MAAM,EAAE,GAAG,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;YACnC,CAAC,CAAC,gCAAc,CAAC,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAEf,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAE9B,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAGrD,OAAO,GAAG,SAAS,IAAI,KAAK,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IACjH,CAAC;IAGD;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CAAC,QAAgB;QAE9B,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAErD,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,MAAM,EAAE,GAAG,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAEjF,OAAO;YACH,SAAS;YACT,KAAK,EAAE,KAAK;YACZ,MAAM;YACN,EAAE,EAAE,EAAE;YACN,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YACtC,KAAK;SACR,CAAC;IACN,CAAC;IAGD,QAAQ;QACJ,OAAO,KAAK,CAAC,aAAa,CAAC;YACvB,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,EAAE,EAAE,IAAI,CAAC,GAAG;YACZ,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM;SACrB,CAAC,CAAA;IACN,CAAC;IAGD,MAAM;QACF,OAAO;YACH,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,EAAE,EAAE,IAAI,CAAC,GAAG;YACZ,OAAO,EAAE,IAAI,CAAC,QAAQ;YACtB,KAAK,EAAE,IAAI,CAAC,MAAM;SACrB,CAAA;IACL,CAAC;;AA5LL,sBA6LC;AA3LU,YAAM,GAAW,IAAI,MAAM,CAAC,+EAA+E,CAAC,CAAA"}

package/dist/src/global/A_Deferred.class.d.ts

@@ -0,0 +1,8 @@
+export declare class A_Deferred<T> {
+    promise: Promise<T>;
+    private resolveFn;
+    private rejectFn;
+    constructor();
+    resolve(value: T | PromiseLike<T>): void;
+    reject(reason?: any): void;
+}

package/dist/src/global/A_Deferred.class.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_Deferred = void 0;
+class A_Deferred {
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.resolveFn = resolve;
+            this.rejectFn = reject;
+        });
+    }
+    resolve(value) {
+        this.resolveFn(value);
+    }
+    reject(reason) {
+        this.rejectFn(reason);
+    }
+}
+exports.A_Deferred = A_Deferred;
+//# sourceMappingURL=A_Deferred.class.js.map

package/dist/src/global/A_Deferred.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A_Deferred.class.js","sourceRoot":"","sources":["../../../src/global/A_Deferred.class.ts"],"names":[],"mappings":";;;AAAA,MAAa,UAAU;IAKnB;QACI,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC;YACzB,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,CAAC,KAAyB;QAC7B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,MAAY;QACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;CACJ;AAnBD,gCAmBC"}

package/dist/src/global/A_Entity.class.d.ts

@@ -0,0 +1,49 @@
+import { A_TYPES__AEntity_JSON, A_TYPES__IAEntity } from "../types/A_Entity.types";
+import { ASEID } from "./ASEID.class";
+export declare class A_Entity<_ConstructorType = any, _SerializedType extends A_TYPES__AEntity_JSON = A_TYPES__AEntity_JSON> implements A_TYPES__IAEntity {
+    aseid: ASEID;
+    constructor(aseid: string);
+    constructor(aseid: ASEID);
+    constructor(serialized: _SerializedType);
+    constructor(newEntity: _ConstructorType);
+    /**
+     * Extracts the ID from the ASEID
+     * ID is the unique identifier of the entity
+     */
+    get id(): string | number;
+    /**
+     * Extracts the namespace from the ASEID
+     * namespace is an application specific identifier from where the entity is coming from
+     */
+    get namespace(): string;
+    /**
+     * Extracts the scope from the ASEID
+     * scope is the scope of the entity from Application Namespace
+     */
+    get scope(): string;
+    /**
+     * Extracts the entity from the ASEID
+     * entity is the name of the entity from Application Namespace
+     */
+    get entity(): string;
+    /**
+     * Extracts the version from the ASEID
+     * version is the version of the entity
+     */
+    get version(): string | undefined;
+    /**
+     * Extracts the shard from the ASEID
+     * shard is the shard of the entity
+     */
+    get shard(): string | undefined;
+    protected fromNewEntity(newEntity: _ConstructorType): void;
+    protected fromSerialized(serialized: _SerializedType): void;
+    /**
+     * Converts the entity to a JSON object
+     *
+     *
+     * @returns
+     */
+    toJSON(): _SerializedType;
+    toString(): string;
+}

package/dist/src/global/A_Entity.class.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_Entity = void 0;
+const errors_constants_1 = require("../constants/errors.constants");
+const A_Error_class_1 = require("./A_Error.class");
+const ASEID_class_1 = require("./ASEID.class");
+class A_Entity {
+    constructor(props) {
+        switch (true) {
+            case (typeof props === 'string' && ASEID_class_1.ASEID.isASEID(props)):
+                this.aseid = new ASEID_class_1.ASEID(props);
+                break;
+            case (props instanceof ASEID_class_1.ASEID):
+                this.aseid = props;
+                break;
+            case (typeof props === 'object' && props.aseid):
+                this.fromSerialized(props);
+                break;
+            case (typeof props === 'object'):
+                this.fromNewEntity(props);
+                break;
+            default:
+                throw new A_Error_class_1.A_Error(errors_constants_1.A_CONSTANTS__DEFAULT_ERRORS.INCORRECT_A_ENTITY_CONSTRUCTOR);
+        }
+    }
+    // ====================================================================
+    // ================== DUPLICATED ASEID Getters ========================
+    // ====================================================================
+    /**
+     * Extracts the ID from the ASEID
+     * ID is the unique identifier of the entity
+     */
+    get id() {
+        return this.aseid.id;
+    }
+    /**
+     * Extracts the namespace from the ASEID
+     * namespace is an application specific identifier from where the entity is coming from
+     */
+    get namespace() {
+        return this.aseid.namespace;
+    }
+    /**
+     * Extracts the scope from the ASEID
+     * scope is the scope of the entity from Application Namespace
+     */
+    get scope() {
+        return this.aseid.scope;
+    }
+    /**
+     * Extracts the entity from the ASEID
+     * entity is the name of the entity from Application Namespace
+     */
+    get entity() {
+        return this.aseid.entity;
+    }
+    /**
+     * Extracts the version from the ASEID
+     * version is the version of the entity
+     */
+    get version() {
+        return this.aseid.version;
+    }
+    /**
+     * Extracts the shard from the ASEID
+     * shard is the shard of the entity
+     */
+    get shard() {
+        return this.aseid.shard;
+    }
+    fromNewEntity(newEntity) {
+        return;
+    }
+    fromSerialized(serialized) {
+        this.aseid = new ASEID_class_1.ASEID((serialized).aseid);
+        return;
+    }
+    /**
+     * Converts the entity to a JSON object
+     *
+     *
+     * @returns
+     */
+    toJSON() {
+        return {
+            aseid: this.aseid.toString()
+        };
+    }
+    toString() {
+        return this.aseid.toString();
+    }
+}
+exports.A_Entity = A_Entity;
+//# sourceMappingURL=A_Entity.class.js.map

package/dist/src/global/A_Entity.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A_Entity.class.js","sourceRoot":"","sources":["../../../src/global/A_Entity.class.ts"],"names":[],"mappings":";;;AAAA,oEAA4E;AAK5E,mDAA0C;AAC1C,+CAAsC;AAEtC,MAAa,QAAQ;IAqBjB,YAAY,KAA0D;QAElE,QAAQ,IAAI,EAAE,CAAC;YACX,KAAK,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,mBAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACpD,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAK,CAAC,KAAK,CAAC,CAAC;gBAC9B,MAAM;YACV,KAAK,CAAC,KAAK,YAAY,mBAAK,CAAC;gBACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;gBACnB,MAAM;YACV,KAAK,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAK,KAAa,CAAC,KAAK,CAAC;gBACpD,IAAI,CAAC,cAAc,CAAC,KAAwB,CAAC,CAAC;gBAC9C,MAAM;YAEV,KAAK,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;gBAC5B,IAAI,CAAC,aAAa,CAAC,KAAyB,CAAC,CAAC;gBAC9C,MAAK;YAET;gBACI,MAAM,IAAI,uBAAO,CAAC,8CAA2B,CAAC,8BAA8B,CAAC,CAAC;QACtF,CAAC;IAEL,CAAC;IAED,uEAAuE;IACvE,uEAAuE;IACvE,uEAAuE;IAEvE;;;OAGG;IACH,IAAI,EAAE;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAA;IAC/B,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;OAGG;IAEH,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;IAC5B,CAAC;IAGS,aAAa,CAAC,SAA2B;QAC/C,OAAO;IACX,CAAC;IAES,cAAc,CAAC,UAA2B;QAChD,IAAI,CAAC,KAAK,GAAG,IAAI,mBAAK,CAAC,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3C,OAAO;IACX,CAAC;IAGD;;;;;OAKG;IACH,MAAM;QACF,OAAO;YACH,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE;SACZ,CAAC;IACzB,CAAC;IAID,QAAQ;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;CACJ;AA7HD,4BA6HC"}