@adaas/a-concept 0.0.63 → 0.1.1

package/dist/src/global/A-Error/A_Error.class.d.ts

@@ -0,0 +1,219 @@
+import { A_TYPES__Error_Init, A_TYPES__Error_Serialized } from './A_Error.types';
+import { ASEID } from '../ASEID/ASEID.class';
+export declare class A_Error<_ConstructorType extends A_TYPES__Error_Init = A_TYPES__Error_Init, _SerializedType extends A_TYPES__Error_Serialized = A_TYPES__Error_Serialized> extends Error {
+    /**
+     * Error Identifier that corresponds to the class name
+     */
+    static get entity(): string;
+    /**
+     * DEFAULT Namespace of the error from environment variable A_CONCEPT_NAMESPACE
+     *
+     * [!] If environment variable is not set, it will default to 'a-concept'
+     */
+    static get concept(): string;
+    /**
+     * DEFAULT Scope of the entity from environment variable A_CONCEPT_DEFAULT_SCOPE
+     *
+     * [!] If environment variable is not set, it will default to 'core'
+     * [!] Scope is an application specific identifier that can be used to group entities together
+     * [!] e.g. 'default', 'core', 'public', 'internal', etc
+     */
+    static get scope(): string;
+    /**
+     * ASEID of the error instance
+     */
+    protected _aseid: ASEID;
+    /**
+     * Possible Scope if needed to identify the error by it's execution environment
+     */
+    protected _scope?: string;
+    /**
+     * Unique code representing the type of error
+     */
+    protected _code?: string;
+    /**
+     * Detailed description of the error
+     */
+    protected _description?: string;
+    /**
+     * Original Error if any
+     */
+    protected _originalError?: Error | any;
+    /**
+     * Link to the documentation or support page for the error
+     */
+    protected _link?: string;
+    /**
+     * A_Error is a custom error class for A_Concept framework.
+     * This error allows to have more structured error handling.
+     * Each error has a unique code, description and a link to the documentation.
+     *
+     * Example of usage:
+     * ```typescript
+     *
+     * // 1) all parameters will be used as provided
+     * throw new A_Error({
+     *    message: 'User not found',
+     *    code: 'USER_NOT_FOUND',
+     *    description: 'The user with the given ID was not found.',
+     *    link: 'https://support.adaas.org/error/USER_NOT_FOUND'
+     * });
+     *
+     * // or
+     * // 2) only message is provided, other parameters will be set to default values:
+     * //     - code: 'user-not-found' (kebab-case of the message)
+     * //     - description: 'User not found' (same as message)
+     * //     - link: Empty
+     * throw new A_Error('User not found');
+     *
+     * // or
+     * // 3) Provided Message and Description, other parameters will be set to default values:
+     * //     - code: 'user-not-found' (kebab-case of the message)
+     * //     - description: 'The user with the given ID was not found.' (as provided)
+     * //     - link: Empty
+     * throw new A_Error('User not found', 'The user with the given ID was not found.');
+     *
+     *
+     * ```
+     * [!] Note: The behavior of A_Error is similar to the A_Entity however it cannot have own A_Features.
+     * [!] Note: This class can be inherited to create custom error classes.
+     *
+     * @param message
+     */
+    constructor(
+    /**
+     * A_Error Constructor params
+     */
+    params: _ConstructorType);
+    constructor(
+    /**
+     * Error message
+     */
+    message: string);
+    constructor(
+    /**
+     * Original JS Error
+     */
+    error: Error);
+    constructor(
+    /**
+     * Error message
+     */
+    message: string, 
+    /**
+     * Detailed description of the error
+     */
+    description: string);
+    /**
+     * Returns the ASEID of the error instance
+     */
+    get aseid(): ASEID;
+    /**
+     * Returns an Error message what is a brief title of the error
+     *
+     * Example: 'User not found', 'Validation error', 'Unauthorized access', etc.
+     *
+     * [!] Note: This message should be short and concise, less than 60 characters
+     * [!] Note: If message exceeds 60 characters, there would be an error thrown
+     * [!] Note: This message is intended to be human-readable and can be displayed in UI or logs
+     */
+    get message(): string;
+    /**
+     * Returns a unique code representing the type of error
+     *
+     * If code is not provided, it will generate a kebab-case of the message
+     *
+     * Example: 'validation-error', 'not-found', 'user-not-found', 'unauthorized' etc.
+     *
+     * [!] Note: It is recommended to use kebab-case for error codes
+     * [!] Note: If not provided would be used a kebab-case message of the error
+     */
+    get code(): string;
+    /**
+     * Returns the type of the error which corresponds to the static entity of the class
+     *
+     * Example: 'a-error', 'validation-error', 'not-found-error', 'user-error', etc.
+     *
+     * Defaults to the kebab-case of the class name
+     *
+     * [!] Note: naming ad separation are fully dependent on the architecture of the application
+     * [!] Note: It is recommended to use kebab-case for error types
+     * [!] Note: This type is intended to group similar errors together
+     */
+    get type(): string;
+    /**
+     * Returns a link with possible documentation or support page for the error
+     * If link is not provided, it will generate a link based on the ASEID of the error that points to the A-Concept support page
+     *
+     * Example: https://adaas.support/a-concept/errors/{ASEID}
+     *
+     * [!] Note: ASEID is generated based on the static properties of the class (concept, scope, entity) and the code of the error
+     */
+    get link(): string;
+    /**
+     * The scope name of the error instance
+     *
+     * If scope is not provided, it will use the static scope of the class
+     *
+     * [!] Note: Scope is an application specific identifier that can be used to group entities together
+     * [!] e.g. 'default', 'core', 'public', 'internal', etc
+     */
+    get scope(): string;
+    /**
+     * A detailed description of the error
+     * If description is not provided, it will use the environment variable A_ERROR_DEFAULT_DESCRIPTION or a generic message
+     *
+     * Example: 'The user with the given ID was not found.', 'The provided data is invalid.', 'You do not have permission to access this resource.', etc.
+     *
+     * [!] Note: This description is intended to provide more context about the error and can be used for debugging or logging purposes
+     */
+    get description(): string;
+    /**
+     * Returns the original error if any
+     *
+     * This can be useful for debugging purposes to see the original stack trace or error message
+     *
+     * [!] Note: Original error is optional and may not be present in all cases
+     */
+    get originalError(): Error | any | undefined;
+    /**
+     * Determines which initializer method to use based on the type of the first parameter.
+     *
+     * @param param1
+     * @returns
+     */
+    protected getInitializer(param1: _ConstructorType | Error | string | any): (param1: any, param2: any) => void | (() => void);
+    /**
+     * Initializes the A_Error instance from a standard Error object.
+     *
+     * @param error
+     */
+    protected fromError(error: Error): void;
+    /**
+     * Initializes the A_Error instance from a string message and optional description.
+     *
+     * @param message
+     * @param description
+     */
+    protected fromString(message: string, description?: string): void;
+    /**
+     * Initializes the A_Error instance from a constructor parameters object.
+     *
+     * @param params
+     */
+    protected fromConstructor(params: _ConstructorType): void;
+    /**
+     * Serializes the A_Error instance to a plain object.
+     *
+     *
+     * @returns
+     */
+    toJSON(): _SerializedType;
+    /**
+     * Checks if the provided message exceeds 60 characters.
+     * If it does, throws a validation A_Error.
+     *
+     * @param message
+     */
+    protected validateMessage(message: string): void;
+}

package/dist/src/global/A-Error/A_Error.class.js

@@ -0,0 +1,267 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_Error = void 0;
+const A_Error_constants_1 = require("./A_Error.constants");
+const A_Formatter_helper_1 = require("../../helpers/A_Formatter.helper");
+const A_Context_class_1 = require("../A-Context/A-Context.class");
+const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
+const ASEID_class_1 = require("../ASEID/ASEID.class");
+class A_Error extends Error {
+    // ====================================================================
+    // ================== Static A-Error Information ======================
+    // ====================================================================
+    /**
+     * Error Identifier that corresponds to the class name
+     */
+    static get entity() {
+        return A_Formatter_helper_1.A_FormatterHelper.toKebabCase(this.name);
+    }
+    /**
+     * DEFAULT Namespace of the error from environment variable A_CONCEPT_NAMESPACE
+     *
+     * [!] If environment variable is not set, it will default to 'a-concept'
+     */
+    static get concept() {
+        return A_Context_class_1.A_Context.concept;
+    }
+    /**
+     * DEFAULT Scope of the entity from environment variable A_CONCEPT_DEFAULT_SCOPE
+     *
+     * [!] If environment variable is not set, it will default to 'core'
+     * [!] Scope is an application specific identifier that can be used to group entities together
+     * [!] e.g. 'default', 'core', 'public', 'internal', etc
+     */
+    static get scope() {
+        return A_Context_class_1.A_Context.root.name;
+    }
+    constructor(param1, param2) {
+        //  to prevent errors accumulation in the stack trace it returns the original error if provided param1 is A_Error
+        if (param1 instanceof A_Error) {
+            return param1;
+        }
+        else if (A_TypeGuards_helper_1.A_TypeGuards.isConstructorType(param1)) {
+            super(param1.message);
+        }
+        else if (param1 instanceof Error) {
+            super(param1.message);
+        }
+        else if (A_TypeGuards_helper_1.A_TypeGuards.isString(param1)) {
+            super(param1);
+        }
+        else {
+            console.log('INVALID PARAMS PROVIDED TO A_ERROR CONSTRUCTOR: ', param1);
+            throw new A_Error(A_Error_constants_1.A_CONSTANTS__ERROR_CODES.VALIDATION_ERROR, 'Invalid parameters provided to A_Error constructor');
+        }
+        // check message length
+        this.validateMessage(this.message);
+        const initializer = this.getInitializer(param1);
+        // the returned initializer is already bound to `this` (we used .bind(this)),
+        // so calling it will run the appropriate logic on this instance:
+        initializer.call(this, param1, param2);
+    }
+    // ====================================================================
+    // ================== Public A-Error Information ======================
+    // ====================================================================
+    /**
+     * Returns the ASEID of the error instance
+     */
+    get aseid() {
+        return this._aseid;
+    }
+    /**
+     * Returns an Error message what is a brief title of the error
+     *
+     * Example: 'User not found', 'Validation error', 'Unauthorized access', etc.
+     *
+     * [!] Note: This message should be short and concise, less than 60 characters
+     * [!] Note: If message exceeds 60 characters, there would be an error thrown
+     * [!] Note: This message is intended to be human-readable and can be displayed in UI or logs
+     */
+    get message() {
+        return super.message;
+    }
+    /**
+     * Returns a unique code representing the type of error
+     *
+     * If code is not provided, it will generate a kebab-case of the message
+     *
+     * Example: 'validation-error', 'not-found', 'user-not-found', 'unauthorized' etc.
+     *
+     * [!] Note: It is recommended to use kebab-case for error codes
+     * [!] Note: If not provided would be used a kebab-case message of the error
+     */
+    get code() {
+        return this._code || A_Formatter_helper_1.A_FormatterHelper.toKebabCase(this.message);
+    }
+    /**
+     * Returns the type of the error which corresponds to the static entity of the class
+     *
+     * Example: 'a-error', 'validation-error', 'not-found-error', 'user-error', etc.
+     *
+     * Defaults to the kebab-case of the class name
+     *
+     * [!] Note: naming ad separation are fully dependent on the architecture of the application
+     * [!] Note: It is recommended to use kebab-case for error types
+     * [!] Note: This type is intended to group similar errors together
+     */
+    get type() {
+        return this.constructor.entity;
+    }
+    /**
+     * Returns a link with possible documentation or support page for the error
+     * If link is not provided, it will generate a link based on the ASEID of the error that points to the A-Concept support page
+     *
+     * Example: https://adaas.support/a-concept/errors/{ASEID}
+     *
+     * [!] Note: ASEID is generated based on the static properties of the class (concept, scope, entity) and the code of the error
+     */
+    get link() {
+        if (this._link)
+            return this._link;
+        const url = new URL(`https://adaas.support/a-concept/errors/${this.aseid.toString()}`);
+        return url.toString();
+    }
+    /**
+     * The scope name of the error instance
+     *
+     * If scope is not provided, it will use the static scope of the class
+     *
+     * [!] Note: Scope is an application specific identifier that can be used to group entities together
+     * [!] e.g. 'default', 'core', 'public', 'internal', etc
+     */
+    get scope() {
+        return this._aseid.scope;
+    }
+    /**
+     * A detailed description of the error
+     * If description is not provided, it will use the environment variable A_ERROR_DEFAULT_DESCRIPTION or a generic message
+     *
+     * Example: 'The user with the given ID was not found.', 'The provided data is invalid.', 'You do not have permission to access this resource.', etc.
+     *
+     * [!] Note: This description is intended to provide more context about the error and can be used for debugging or logging purposes
+     */
+    get description() {
+        return this._description || process.env.A_ERROR_DEFAULT_DESCRIPTION || A_Error_constants_1.A_CONSTANTS__ERROR_DESCRIPTION;
+    }
+    /**
+     * Returns the original error if any
+     *
+     * This can be useful for debugging purposes to see the original stack trace or error message
+     *
+     * [!] Note: Original error is optional and may not be present in all cases
+     */
+    get originalError() {
+        return this._originalError;
+    }
+    /**
+     * Determines which initializer method to use based on the type of the first parameter.
+     *
+     * @param param1
+     * @returns
+     */
+    getInitializer(param1) {
+        switch (true) {
+            case A_TypeGuards_helper_1.A_TypeGuards.isString(param1):
+                return this.fromString;
+            case param1 instanceof Error:
+                return this.fromError;
+            case A_TypeGuards_helper_1.A_TypeGuards.isConstructorType(param1):
+                return this.fromConstructor;
+            default: {
+                console.log('INVALID PARAMS PROVIDED TO A_ERROR CONSTRUCTOR: ', param1);
+                throw new A_Error(A_Error_constants_1.A_CONSTANTS__ERROR_CODES.VALIDATION_ERROR, 'Invalid parameters provided to A_Error constructor');
+            }
+        }
+    }
+    /**
+     * Initializes the A_Error instance from a standard Error object.
+     *
+     * @param error
+     */
+    fromError(error) {
+        this._code = A_Error_constants_1.A_CONSTANTS__ERROR_CODES.UNEXPECTED_ERROR;
+        this._aseid = new ASEID_class_1.ASEID({
+            concept: this.constructor.concept,
+            scope: this.constructor.scope,
+            entity: this.constructor.entity,
+            id: this.code
+        });
+        this._description = 'If you see this error please let us know.';
+        this._originalError = error;
+    }
+    /**
+     * Initializes the A_Error instance from a string message and optional description.
+     *
+     * @param message
+     * @param description
+     */
+    fromString(message, description) {
+        this._code = A_Formatter_helper_1.A_FormatterHelper.toKebabCase(message);
+        this._scope = A_TypeGuards_helper_1.A_TypeGuards.isScopeInstance(description) ? description.name : undefined;
+        this._aseid = new ASEID_class_1.ASEID({
+            concept: this.constructor.concept,
+            scope: this._scope || this.constructor.scope,
+            entity: this.constructor.entity,
+            id: this.code
+        });
+        this._description = A_TypeGuards_helper_1.A_TypeGuards.isString(description) ? description : undefined;
+        this._link = undefined;
+        this._originalError = undefined;
+    }
+    /**
+     * Initializes the A_Error instance from a constructor parameters object.
+     *
+     * @param params
+     */
+    fromConstructor(params) {
+        this._code = params.code;
+        this._scope = params.scope ? (A_TypeGuards_helper_1.A_TypeGuards.isScopeInstance(params.scope) ? params.scope.name : params.scope) : undefined;
+        this._aseid = new ASEID_class_1.ASEID({
+            concept: this.constructor.concept,
+            scope: this._scope || this.constructor.scope,
+            entity: this.constructor.entity,
+            id: this.code
+        });
+        this._description = params.description;
+        this._link = params.link;
+        this._originalError = params.originalError;
+    }
+    /**
+     * Serializes the A_Error instance to a plain object.
+     *
+     *
+     * @returns
+     */
+    toJSON() {
+        var _a;
+        return {
+            aseid: this.aseid.toString(),
+            code: this.code,
+            type: this.type,
+            message: this.message,
+            link: this.link,
+            scope: this.scope,
+            description: this.description,
+            originalError: (_a = this.originalError) === null || _a === void 0 ? void 0 : _a.message
+        };
+    }
+    // --------------------------------------------------------------------------
+    // ----------------------- PROTECTED HELPERS --------------------------------
+    // --------------------------------------------------------------------------
+    /**
+     * Checks if the provided message exceeds 60 characters.
+     * If it does, throws a validation A_Error.
+     *
+     * @param message
+     */
+    validateMessage(message) {
+        if (message.length > 60) {
+            throw new A_Error(A_Error_constants_1.A_CONSTANTS__ERROR_CODES.VALIDATION_ERROR, 'A-Error message exceeds 60 characters limit.');
+        }
+        if (message.length === 0) {
+            throw new A_Error(A_Error_constants_1.A_CONSTANTS__ERROR_CODES.VALIDATION_ERROR, 'A-Error message cannot be empty.');
+        }
+    }
+}
+exports.A_Error = A_Error;
+//# sourceMappingURL=A_Error.class.js.map

package/dist/src/global/A-Error/A_Error.class.js.map

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

package/dist/src/global/A-Error/A_Error.constants.d.ts

@@ -0,0 +1,5 @@
+export declare const A_CONSTANTS__ERROR_CODES: {
+    readonly UNEXPECTED_ERROR: "A-Error Unexpected Error";
+    readonly VALIDATION_ERROR: "A-Error Validation Error";
+};
+export declare const A_CONSTANTS__ERROR_DESCRIPTION = "If you see this error please let us know.";

package/dist/src/global/A-Error/A_Error.constants.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_CONSTANTS__ERROR_DESCRIPTION = exports.A_CONSTANTS__ERROR_CODES = void 0;
+exports.A_CONSTANTS__ERROR_CODES = {
+    UNEXPECTED_ERROR: 'A-Error Unexpected Error',
+    VALIDATION_ERROR: 'A-Error Validation Error',
+};
+exports.A_CONSTANTS__ERROR_DESCRIPTION = 'If you see this error please let us know.';
+//# sourceMappingURL=A_Error.constants.js.map

package/dist/src/global/A-Error/A_Error.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A_Error.constants.js","sourceRoot":"","sources":["../../../../src/global/A-Error/A_Error.constants.ts"],"names":[],"mappings":";;;AAGa,QAAA,wBAAwB,GAAG;IACpC,gBAAgB,EAAE,0BAA0B;IAC5C,gBAAgB,EAAE,0BAA0B;CACtC,CAAC;AAIE,QAAA,8BAA8B,GAAG,2CAA2C,CAAA"}

package/dist/src/global/A-Error/A_Error.types.d.ts

@@ -0,0 +1,89 @@
+import { A_Scope } from "../A-Scope/A-Scope.class";
+import { A_Error } from "./A_Error.class";
+/**
+ * Entity constructor type
+ * Uses the generic type T to specify the type of the entity
+ */
+export type A_TYPES__Error_Constructor<T = A_Error> = new (...args: any[]) => T;
+/**
+ * Error initialization type
+ */
+export type A_TYPES__Error_Init = {
+    /**
+     * Error message
+     *
+     * A short description of the error
+     */
+    message: string;
+    /**
+     * Error code representing the type of error
+     *
+     * Should be unique within the application or service
+     *
+     * Example: 'validation-error', 'not-found', 'user-not-found', 'unauthorized' etc.
+     *
+     * [!] Note: It is recommended to use kebab-case for error codes
+     * [!] Note: If not provided would be used a kebab-case message of the error
+     */
+    code?: string;
+    /**
+     * Possible Scope if needed to identify the error by it's execution environment
+     *
+     * For example, error of type 'validation' could happen in different scopes
+     * like 'user', 'admin', 'system' etc. This will help to identify the error context better
+     *
+     * Could be string or A_Scope instance
+     *
+     * [!] Note: If not provided, the default scope of the A_Error will be used (A_Context.root.name)
+     */
+    scope?: string | A_Scope;
+    /**
+     * Detailed description of the error
+     */
+    description?: string;
+    /**
+     * Link to the documentation or support page for the error
+     */
+    link?: string;
+    /**
+     * Original Error if any
+     */
+    originalError?: Error | unknown;
+};
+/**
+ * Error serialized type
+ */
+export type A_TYPES__Error_Serialized = {
+    /**
+     * ASEID of the error
+     */
+    aseid: string;
+    /**
+     * Error message
+     */
+    message: string;
+    /**
+     * Type of the error
+     */
+    type: string;
+    /**
+     * Error code
+     */
+    code: string;
+    /**
+     * Error description
+     */
+    description: string;
+    /**
+     * Link to documentation or support page
+     */
+    link?: string;
+    /**
+     * Scope of the error
+     */
+    scope: string;
+    /**
+     * Original error message if any
+     */
+    originalError?: string;
+};

package/dist/src/{decorators/A-Inject/A-Inject.decorator.types.js → global/A-Error/A_Error.types.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=A-Inject.decorator.types.js.map
+//# sourceMappingURL=A_Error.types.js.map

package/dist/src/global/A-Error/A_Error.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A_Error.types.js","sourceRoot":"","sources":["../../../../src/global/A-Error/A_Error.types.ts"],"names":[],"mappings":""}

package/dist/src/global/A-Feature/A-Feature-Define.decorator.d.ts

@@ -0,0 +1,15 @@
+import { A_TYPES__FeatureDefineDecoratorConfig, A_TYPES__FeatureDefineDecoratorDescriptor, A_TYPES__FeatureDefineDecoratorTarget } from "./A-Feature.types";
+/**
+ * A-Feature decorator
+ *
+ * This decorator allows to define a custom lifecycle stage for the Container.
+ * These stages are executed in a container-specific order and can be extended by components that are injected into the container.
+ * This approach allows to create a flexible and extendable architecture for the application.
+ *
+ * The main difference between the A-Feature and A-Feature decorators is that A-Feature methods can be inherited and overridden by child classes.
+ *
+ *
+ * @param params
+ * @returns
+ */
+export declare function A_Feature_Define(config?: Partial<A_TYPES__FeatureDefineDecoratorConfig>): (target: A_TYPES__FeatureDefineDecoratorTarget, propertyKey: string, descriptor: A_TYPES__FeatureDefineDecoratorDescriptor) => A_TYPES__FeatureDefineDecoratorDescriptor;