@adaas/a-concept 0.1.23 → 0.1.25

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

@@ -1,296 +0,0 @@
-"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");
-const env_constants_1 = require("../../constants/env.constants");
-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
-        switch (true) {
-            case param1 instanceof A_Error:
-                return param1;
-            case param1 instanceof Error:
-                super(param1.message);
-                break;
-            case A_TypeGuards_helper_1.A_TypeGuards.isConstructorType(param1) && 'description' in param1:
-                super(`[${param1.title}]: ${param1.description}`);
-                break;
-            case A_TypeGuards_helper_1.A_TypeGuards.isConstructorType(param1) && !('description' in param1):
-                super(param1.title);
-                break;
-            case A_TypeGuards_helper_1.A_TypeGuards.isString(param1) && !param2:
-                super(param1);
-                break;
-            case A_TypeGuards_helper_1.A_TypeGuards.isString(param1) && !!param2:
-                super(`[${param1}]: ${param2}`);
-                break;
-            default:
-                throw new A_Error(A_Error_constants_1.A_CONSTANTS__ERROR_CODES.VALIDATION_ERROR, 'Invalid parameters provided to A_Error constructor');
-        }
-        const initializer = this.getInitializer(param1, param2);
-        // 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 the title of the error
-     *
-     * Example: 'User not found', 'Validation error', 'Unauthorized access', etc.
-     *
-     * [!] Note: This title should be short and concise, less than 60 characters
-     * [!] Note: If title exceeds 60 characters, there would be an error thrown
-     * [!] Note: This title is intended to be human-readable and can be displayed in UI or logs
-     */
-    get title() {
-        return this._title;
-    }
-    /**
-     * Returns an Error message what is a brief title of the error
-     *
-     */
-    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.title);
-    }
-    /**
-     * 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[env_constants_1.A_CONSTANTS__DEFAULT_ENV_VARIABLES.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, param2) {
-        switch (true) {
-            case A_TypeGuards_helper_1.A_TypeGuards.isString(param1) && !param2:
-                return this.fromMessage;
-            case A_TypeGuards_helper_1.A_TypeGuards.isString(param1) && !!param2:
-                return this.fromTitle;
-            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._title = 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._originalError = error;
-    }
-    /**
-     * Initializes the A_Error instance from a message.
-     *
-     * @param title
-     * @param description
-     */
-    fromMessage(message) {
-        this._title = A_Error_constants_1.A_CONSTANTS__ERROR_CODES.UNEXPECTED_ERROR;
-        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._link = undefined;
-        this._originalError = undefined;
-    }
-    fromTitle(title, description) {
-        this.validateTitle(title);
-        this._title = title;
-        this._description = description;
-        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._link = undefined;
-        this._originalError = undefined;
-    }
-    /**
-     * Initializes the A_Error instance from a constructor parameters object.
-     *
-     * @param params
-     */
-    fromConstructor(params) {
-        this.validateTitle(params.title);
-        this._title = params.title;
-        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(),
-            title: this.title,
-            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 title exceeds 60 characters.
-     * If it does, throws a validation A_Error.
-     *
-     * @param title
-     */
-    validateTitle(title) {
-        if (title.length > 60) {
-            throw new A_Error(A_Error_constants_1.A_CONSTANTS__ERROR_CODES.VALIDATION_ERROR, 'A-Error title exceeds 60 characters limit.');
-        }
-        if (title.length === 0) {
-            throw new A_Error(A_Error_constants_1.A_CONSTANTS__ERROR_CODES.VALIDATION_ERROR, 'A-Error title cannot be empty.');
-        }
-    }
-}
-exports.A_Error = A_Error;
-// message = title + description for better printing in the console
-// description = detailed information about the error
-// code = kebabcase (title)
-//# sourceMappingURL=A_Error.class.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-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

@@ -1,9 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,93 +0,0 @@
-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 title
-     *
-     * A short description of the error
-     */
-    title: 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;
-    /**
-     * A brief title of the error
-     */
-    title: 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/global/A-Error/A_Error.types.js

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,15 +0,0 @@
-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;

package/dist/src/global/A-Feature/A-Feature-Define.decorator.js

@@ -1,76 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_Feature_Define = A_Feature_Define;
-const A_Context_class_1 = require("../A-Context/A-Context.class");
-const A_Meta_class_1 = require("../A-Meta/A-Meta.class");
-const A_Entity_constants_1 = require("../A-Entity/A-Entity.constants");
-const A_Container_constants_1 = require("../A-Container/A-Container.constants");
-const A_Component_constants_1 = require("../A-Component/A-Component.constants");
-const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
-const A_Feature_error_1 = require("./A-Feature.error");
-/**
- * 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
- */
-function A_Feature_Define(config = {}) {
-    return function (target, propertyKey, descriptor) {
-        var _a;
-        // for error messages
-        const componentName = ((_a = target === null || target === void 0 ? void 0 : target.constructor) === null || _a === void 0 ? void 0 : _a.name) || String(target) || 'Unknown';
-        if (!A_TypeGuards_helper_1.A_TypeGuards.isAllowedForFeatureDefinition(target))
-            throw new A_Feature_error_1.A_FeatureError(A_Feature_error_1.A_FeatureError.FeatureDefinitionError, `A-Feature cannot be defined on the ${componentName} level`);
-        const meta = A_Context_class_1.A_Context.meta(target.constructor);
-        let metaKey;
-        switch (true) {
-            case A_TypeGuards_helper_1.A_TypeGuards.isEntityInstance(target):
-                metaKey = A_Entity_constants_1.A_TYPES__EntityMetaKey.FEATURES;
-                break;
-            case A_TypeGuards_helper_1.A_TypeGuards.isContainerInstance(target):
-                metaKey = A_Container_constants_1.A_TYPES__ContainerMetaKey.FEATURES;
-                break;
-            case A_TypeGuards_helper_1.A_TypeGuards.isComponentInstance(target):
-                metaKey = A_Component_constants_1.A_TYPES__ComponentMetaKey.FEATURES;
-                break;
-        }
-        // Get the existed metadata or create a new one
-        const existedMeta = meta.get(metaKey) || new A_Meta_class_1.A_Meta();
-        const name = config.name || propertyKey;
-        //  default to false
-        const invoke = config.invoke || false;
-        // Set the metadata of the method to define a custom Feature with name 
-        existedMeta.set(propertyKey, {
-            name: `${target.constructor.name}.${name}`,
-            handler: propertyKey,
-            invoke: invoke,
-            template: config.template && config.template.length ? config.template.map(item => (Object.assign(Object.assign({}, item), { before: item.before || [], after: item.after || [], behavior: item.behavior || 'sync', throwOnError: true }))) : [],
-        });
-        //  Update the metadata of the container with the new Feature definition
-        A_Context_class_1.A_Context
-            .meta(target.constructor)
-            .set(metaKey, existedMeta);
-        const originalMethod = descriptor.value;
-        // Wrap the original method to add the call to `call`
-        // this helps to automatically call the container/entity/component method when it's called
-        descriptor.value = function (...args) {
-            // Call the original method
-            if (!invoke)
-                return originalMethod.apply(this, args);
-            else
-                originalMethod.apply(this, args);
-            // Call your `call` with the function name
-            if (typeof this.call === "function" && invoke)
-                return this.call(name);
-        };
-        return descriptor;
-    };
-}
-//# sourceMappingURL=A-Feature-Define.decorator.js.map

package/dist/src/global/A-Feature/A-Feature-Define.decorator.js.map

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

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

@@ -1,56 +0,0 @@
-import { A_TYPES__FeatureExtendDecoratorConfig } from "./A-Feature.types";
-/**
- * A-Extend decorator
- *
- * This decorator allows to define a custom Extend 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-Extend and A-Extend decorators is that A-Extend methods can be inherited and overridden by child classes.
- *
- *
- * @param params
- * @returns
- */
-/**
- * Use regexp in case if you need more flexibility and control over the name of the method
- *
- * @param regexp
- */
-export declare function A_Feature_Extend(
-/**
- * The regular expression to match the name of the Feature method to be extended
- *
- * Example:
- *
- * ```ts
- *  @A_Feature.Extend(/.*\.load/)
- * ```
- */
-regexp: RegExp): any;
-/**
- * In this case the name configurations will be used as an input to get scope and name of target function
- * [!] Not that for all SCOPE will be used OR operator
- *
- * @param config
- */
-export declare function A_Feature_Extend(
-/**
- * Configuration for the A-Feature-Extend decorator
- */
-config: Partial<A_TYPES__FeatureExtendDecoratorConfig>): any;
-/**
- * In this case the name of function will be used as a name of the Feature.
- * [!] AND it will be applicable for ANY element where the name is the same as the name of the function
- */
-export declare function A_Feature_Extend(): any;
-/**
- * Builds a target regular expression based on the provided parameters.
- *
- * @param param1 - The first parameter, which can be a string or an object.
- * @param include - An array of items to include in the regular expression.
- * @param exclude - An array of items to exclude from the regular expression.
- * @param propertyKey - The property key to use in the regular expression.
- * @returns A regular expression object.
- */
-export declare function buildTargetRegexp(param1: any, include: any[], exclude: any[], propertyKey: string): RegExp;