@adaas/a-concept 0.1.23 → 0.1.25

package/dist/src/global/A-Entity/A-Entity.constants.d.ts

@@ -1,11 +0,0 @@
-export declare enum A_TYPES__EntityMetaKey {
-    EXTENSIONS = "a-component-extensions",
-    FEATURES = "a-component-features",
-    ABSTRACTIONS = "a-component-abstractions",
-    INJECTIONS = "a-component-injections"
-}
-export declare enum A_TYPES__EntityFeatures {
-    SAVE = "save",
-    DESTROY = "destroy",
-    LOAD = "load"
-}

package/dist/src/global/A-Entity/A-Entity.constants.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_TYPES__EntityFeatures = exports.A_TYPES__EntityMetaKey = void 0;
-var A_TYPES__EntityMetaKey;
-(function (A_TYPES__EntityMetaKey) {
-    A_TYPES__EntityMetaKey["EXTENSIONS"] = "a-component-extensions";
-    A_TYPES__EntityMetaKey["FEATURES"] = "a-component-features";
-    A_TYPES__EntityMetaKey["ABSTRACTIONS"] = "a-component-abstractions";
-    A_TYPES__EntityMetaKey["INJECTIONS"] = "a-component-injections";
-})(A_TYPES__EntityMetaKey || (exports.A_TYPES__EntityMetaKey = A_TYPES__EntityMetaKey = {}));
-var A_TYPES__EntityFeatures;
-(function (A_TYPES__EntityFeatures) {
-    A_TYPES__EntityFeatures["SAVE"] = "save";
-    A_TYPES__EntityFeatures["DESTROY"] = "destroy";
-    A_TYPES__EntityFeatures["LOAD"] = "load";
-})(A_TYPES__EntityFeatures || (exports.A_TYPES__EntityFeatures = A_TYPES__EntityFeatures = {}));
-//# sourceMappingURL=A-Entity.constants.js.map

package/dist/src/global/A-Entity/A-Entity.constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"A-Entity.constants.js","sourceRoot":"","sources":["../../../../src/global/A-Entity/A-Entity.constants.ts"],"names":[],"mappings":";;;AAAA,IAAY,sBAKX;AALD,WAAY,sBAAsB;IAC9B,+DAAqC,CAAA;IACrC,2DAAiC,CAAA;IACjC,mEAAyC,CAAA;IACzC,+DAAqC,CAAA;AACzC,CAAC,EALW,sBAAsB,sCAAtB,sBAAsB,QAKjC;AAED,IAAY,uBAIX;AAJD,WAAY,uBAAuB;IAC/B,wCAAa,CAAA;IACb,8CAAmB,CAAA;IACnB,wCAAa,CAAA;AACjB,CAAC,EAJW,uBAAuB,uCAAvB,uBAAuB,QAIlC"}

package/dist/src/global/A-Entity/A-Entity.error.d.ts

@@ -1,7 +0,0 @@
-import { A_Error } from "../A-Error/A_Error.class";
-export declare class A_Entity_Error extends A_Error {
-    /**
-     * Error code for validation errors.
-     */
-    static readonly ValidationError = "A-Entity Validation Error";
-}

package/dist/src/global/A-Entity/A-Entity.error.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_Entity_Error = void 0;
-const A_Error_class_1 = require("../A-Error/A_Error.class");
-class A_Entity_Error extends A_Error_class_1.A_Error {
-}
-exports.A_Entity_Error = A_Entity_Error;
-/**
- * Error code for validation errors.
- */
-A_Entity_Error.ValidationError = 'A-Entity Validation Error';
-//# sourceMappingURL=A-Entity.error.js.map

package/dist/src/global/A-Entity/A-Entity.error.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"A-Entity.error.js","sourceRoot":"","sources":["../../../../src/global/A-Entity/A-Entity.error.ts"],"names":[],"mappings":";;;AAAA,4DAAmD;AAInD,MAAa,cAAe,SAAQ,uBAAO;;AAA3C,wCAOC;AALG;;GAEG;AACa,8BAAe,GAAG,2BAA2B,CAAC"}

package/dist/src/global/A-Entity/A-Entity.meta.d.ts

@@ -1,11 +0,0 @@
-import { A_Meta } from "../A-Meta/A-Meta.class";
-import { A_TYPES__EntityMeta } from "./A-Entity.types";
-import { A_TYPES__FeatureDefineDecoratorMeta } from "../A-Feature/A-Feature.types";
-export declare class A_EntityMeta extends A_Meta<A_TYPES__EntityMeta> {
-    /**
-     * Returns all features defined in the Container
-     *
-     * @returns
-     */
-    features(): Array<A_TYPES__FeatureDefineDecoratorMeta>;
-}

package/dist/src/global/A-Entity/A-Entity.meta.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.A_EntityMeta = void 0;
-const A_Meta_class_1 = require("../A-Meta/A-Meta.class");
-const A_Entity_constants_1 = require("./A-Entity.constants");
-class A_EntityMeta extends A_Meta_class_1.A_Meta {
-    /**
-     * Returns all features defined in the Container
-     *
-     * @returns
-     */
-    features() {
-        const features = this.get(A_Entity_constants_1.A_TYPES__EntityMetaKey.FEATURES);
-        return (features === null || features === void 0 ? void 0 : features.toArray().map(([, feature]) => feature)) || [];
-    }
-}
-exports.A_EntityMeta = A_EntityMeta;
-//# sourceMappingURL=A-Entity.meta.js.map

package/dist/src/global/A-Entity/A-Entity.meta.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"A-Entity.meta.js","sourceRoot":"","sources":["../../../../src/global/A-Entity/A-Entity.meta.ts"],"names":[],"mappings":";;;AAAA,yDAAgD;AAEhD,6DAA8D;AAI9D,MAAa,YAAa,SAAQ,qBAA2B;IAEzD;;;;OAIG;IACH,QAAQ;QAEJ,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,2CAAsB,CAAC,QAAQ,CAAC,CAAC;QAE3D,OAAO,CAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,OAAO,GAEnB,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAI,EAAE,CAAC;IAC7C,CAAC;CAEJ;AAhBD,oCAgBC"}

package/dist/src/global/A-Entity/A-Entity.types.d.ts

@@ -1,56 +0,0 @@
-import { A_Meta } from "../A-Meta/A-Meta.class";
-import { A_Entity } from "./A-Entity.class";
-import { ASEID } from "../ASEID/ASEID.class";
-import { A_TYPES__EntityMetaKey } from "./A-Entity.constants";
-import { A_TYPES__FeatureDefineDecoratorMeta, A_TYPES__FeatureExtendDecoratorMeta } from "../A-Feature/A-Feature.types";
-/**
- * Entity interface
- */
-export interface A_TYPES__IEntity {
-    /**
-     * The ASEID of the entity
-     */
-    aseid: ASEID;
-}
-/**
- * Entity constructor type
- * Uses the generic type T to specify the type of the entity
- */
-export type A_TYPES__Entity_Constructor<T = A_Entity> = new (...args: any[]) => T;
-/**
- * Entity initialization type
- */
-export type A_TYPES__Entity_Init = any;
-/**
- * Entity serialized type
- */
-export type A_TYPES__Entity_Serialized = {
-    /**
-     * The ASEID of the entity
-     */
-    aseid: string;
-};
-/**
- * Entity meta type
- */
-export type A_TYPES__EntityMeta = {
-    [A_TYPES__EntityMetaKey.EXTENSIONS]: A_Meta<{
-        /**
-         * Where Key the regexp for what to apply the extension
-         * A set of container names or a wildcard, or a regexp
-         *
-         *
-         * Where value is the extension instructions
-         */
-        [Key: string]: A_TYPES__FeatureExtendDecoratorMeta[];
-    }>;
-    case: any;
-    [A_TYPES__EntityMetaKey.FEATURES]: A_Meta<{
-        /**
-         * Where Key is the name of the feature
-         *
-         * Where value is the list of features
-         */
-        [Key: string]: A_TYPES__FeatureDefineDecoratorMeta;
-    }>;
-};

package/dist/src/global/A-Entity/A-Entity.types.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const A_Entity_constants_1 = require("./A-Entity.constants");
-;
-//# sourceMappingURL=A-Entity.types.js.map

package/dist/src/global/A-Entity/A-Entity.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"A-Entity.types.js","sourceRoot":"","sources":["../../../../src/global/A-Entity/A-Entity.types.ts"],"names":[],"mappings":";;AAGA,6DAA8D;AAY7D,CAAC"}

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

@@ -1,229 +0,0 @@
-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;
-    /**
-     * Title of the error
-     */
-    protected _title: string;
-    /**
-     * 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
-     */
-    title: string, 
-    /**
-     * Detailed description of the error
-     */
-    description: string);
-    /**
-     * Returns the ASEID of the error instance
-     */
-    get aseid(): 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(): string;
-    /**
-     * Returns an Error message what is a brief title of the error
-     *
-     */
-    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, param2?: string): (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 message.
-     *
-     * @param title
-     * @param description
-     */
-    protected fromMessage(message: string): void;
-    fromTitle(title: 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 title exceeds 60 characters.
-     * If it does, throws a validation A_Error.
-     *
-     * @param title
-     */
-    protected validateTitle(title: string): void;
-}