@adaas/a-concept 0.0.64 → 0.1.1

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

@@ -1,6 +1,6 @@
-import { A_Component } from "../A-Component/A-Component.class";
 import { A_Container } from "../A-Container/A-Container.class";
-import { A_TYPES__A_ExtendDecorator_BehaviorConfig } from "../../decorators/A-Feature/A-Feature.decorator.types";
+import { A_TYPES__Component_Constructor } from "../A-Component/A-Component.types";
+import { A_TYPES__FeatureExtendDecoratorBehaviorConfig } from "../A-Feature/A-Feature.types";
 export declare enum A_TYPES__A_Stage_Status {
     /**
      * The stage is currently being processed
@@ -31,18 +31,6 @@ export declare enum A_TYPES__A_Stage_Status {
      * The stage has been initialized
      */
     INITIALIZED = "INITIALIZED",
-    /**
-     * The stage has been reset
-     */
-    /**
-     * The stage has been resumed
-     */
-    /**
-     * The stage has been suspended
-     */
-    /**
-     * The stage has been terminated
-     */
     /**
      * The stage has been aborted
      */
@@ -52,7 +40,7 @@ export type A_TYPES__A_StageStep = {
     /**
      * The component to be called
      */
-    component: typeof A_Component | A_Container | string;
+    component: A_TYPES__Component_Constructor | A_Container | string;
     /**
      * The method to be called on the component
      */
@@ -64,7 +52,7 @@ export type A_TYPES__A_StageStep = {
      *
      */
     name: string;
-} & A_TYPES__A_ExtendDecorator_BehaviorConfig;
+} & A_TYPES__FeatureExtendDecoratorBehaviorConfig;
 export type A_TYPES__A_Stage_JSON = {
     /**
      * The name of the stage

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

@@ -35,22 +35,6 @@ var A_TYPES__A_Stage_Status;
      * The stage has been initialized
      */
     A_TYPES__A_Stage_Status["INITIALIZED"] = "INITIALIZED";
-    /**
-     * The stage has been reset
-     */
-    // RESET = 'RESET',
-    /**
-     * The stage has been resumed
-     */
-    // RESUMED = 'RESUMED',
-    /**
-     * The stage has been suspended
-     */
-    // SUSPENDED = 'SUSPENDED',
-    /**
-     * The stage has been terminated
-     */
-    // TERMINATED = 'TERMINATED',
     /**
      * The stage has been aborted
      */

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

@@ -1 +1 @@
-{"version":3,"file":"A-Stage.types.js","sourceRoot":"","sources":["../../../../src/global/A-Stage/A-Stage.types.ts"],"names":[],"mappings":";;;AAQA,IAAY,uBAqDX;AArDD,WAAY,uBAAuB;IAC/B;;OAEG;IACH,oDAAyB,CAAA;IACzB;;OAEG;IACH,kDAAuB,CAAA;IACvB;;OAEG;IACH,4CAAiB,CAAA;IACjB;;OAEG;IACH,8CAAmB,CAAA;IACnB;;OAEG;IACH,qBAAqB;IACrB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,sDAA2B,CAAA;IAC3B;;OAEG;IACH,mBAAmB;IACnB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,2BAA2B;IAC3B;;OAEG;IACH,6BAA6B;IAC7B;;OAEG;IACH,8CAAmB,CAAA;AACvB,CAAC,EArDW,uBAAuB,uCAAvB,uBAAuB,QAqDlC"}
+{"version":3,"file":"A-Stage.types.js","sourceRoot":"","sources":["../../../../src/global/A-Stage/A-Stage.types.ts"],"names":[],"mappings":";;;AAMA,IAAY,uBAqCX;AArCD,WAAY,uBAAuB;IAC/B;;OAEG;IACH,oDAAyB,CAAA;IACzB;;OAEG;IACH,kDAAuB,CAAA;IACvB;;OAEG;IACH,4CAAiB,CAAA;IACjB;;OAEG;IACH,8CAAmB,CAAA;IACnB;;OAEG;IACH,qBAAqB;IACrB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,uBAAuB;IACvB;;OAEG;IACH,sDAA2B,CAAA;IAC3B;;OAEG;IACH,8CAAmB,CAAA;AACvB,CAAC,EArCW,uBAAuB,uCAAvB,uBAAuB,QAqClC"}

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

@@ -0,0 +1,130 @@
+import { A_TYPES__ASEID_Constructor, A_TYPES__ASEID_JSON } from "./ASEID.types";
+import { A_TYPES__Required } from "../../types/A_Common.types";
+export declare class ASEID {
+    /**
+     * ASEID Regular Expression
+     */
+    static readonly regexp: RegExp;
+    /**
+     * Tests if the identity string is an ASEID
+     *
+     * @param identity
+     * @returns
+     */
+    static isASEID(identity: string): boolean;
+    /**
+     * Concept for the ASEID
+     * Generally it is the application name or code, should correspond to the concept where the entity is used
+     * Could be ID or ASEID
+     */
+    private _concept;
+    /**
+     * 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?;
+    /**
+     * ASEID is a structured identifier for entities in the A-Concept system.
+     * using the format:
+     *  A - A-Concept
+     *  S - System
+     *  E - Entity
+     *  I - Identifier
+     *  D - iDentifier
+     *
+     * Structure: CONCEPT_NAME + @ + SCOPE + : ENTITY_NAME + : + ID + @ + VERSION
+     *
+     * Example:
+     *  - root@core:usr:0000000001
+     *
+     * [!] Concept is optional, if not provided will be used the current concept name
+     * [!] Scope is optional, if not provided will be used the root scope of the current concept
+     * [!] Version is optional, if not provided will be considered as latest version
+     *
+     * @param aseid - ASEID string representation or ASEID components as object
+     */
+    constructor(
+    /**
+     * ASEID string representation
+     */
+    aseid: string);
+    constructor(
+    /**
+     * ASEID components as object
+     */
+    props: A_TYPES__Required<Partial<A_TYPES__ASEID_Constructor>, ['id', 'entity']>);
+    /**
+     * Getters for ASEID components
+     */
+    get concept(): string;
+    /**
+     * Get the scope of the ASEID
+     */
+    get scope(): string;
+    /**
+     * Get the entity of the ASEID
+     */
+    get entity(): string;
+    /**
+     * Get the id of the ASEID
+     */
+    get id(): string;
+    /**
+     * Get the version of the ASEID (if any)
+     */
+    get version(): string | undefined;
+    /**
+     * Get the shard of the ASEID (if any)
+     */
+    get shard(): string | undefined;
+    /**
+     * get Internal Initializer based on the type of the parameter provided
+     *
+     * @param param1
+     * @returns
+     */
+    private getInitializer;
+    /**
+     * Initialize ASEID from string
+     *
+     * @param param1
+     */
+    private fromString;
+    /**
+     * Initialize ASEID from object
+     *
+     * @param param1
+     */
+    private fromObject;
+    /**
+     * String representation of the ASEID
+     *
+     * @returns
+     */
+    toString(): string;
+    /**
+     * JSON representation of the ASEID
+     *
+     * @returns
+     */
+    toJSON(): A_TYPES__ASEID_JSON;
+    protected verifyInput(param1: string | A_TYPES__Required<Partial<A_TYPES__ASEID_Constructor>, ['id', 'entity']>): void;
+}

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

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASEID = void 0;
+const A_Identity_helper_1 = require("../../helpers/A_Identity.helper");
+const A_TypeGuards_helper_1 = require("../../helpers/A_TypeGuards.helper");
+const A_Context_class_1 = require("../A-Context/A-Context.class");
+const ASEID_error_1 = require("./ASEID.error");
+class ASEID {
+    /**
+     * Tests if the identity string is an ASEID
+     *
+     * @param identity
+     * @returns
+     */
+    static isASEID(identity) {
+        return this.regexp.test(identity);
+    }
+    constructor(param1) {
+        this.verifyInput(param1);
+        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);
+    }
+    /**
+     * Getters for ASEID components
+     */
+    get concept() {
+        return this._concept || A_Context_class_1.A_Context.concept;
+    }
+    /**
+     * Get the scope of the ASEID
+     */
+    get scope() {
+        return this._scope || A_Context_class_1.A_Context.root.name;
+    }
+    /**
+     * Get the entity of the ASEID
+     */
+    get entity() {
+        return this._entity;
+    }
+    /**
+     * Get the id of the ASEID
+     */
+    get id() {
+        return this._id;
+    }
+    /**
+     * Get the version of the ASEID (if any)
+     */
+    get version() {
+        return this._version;
+    }
+    /**
+     * Get the shard of the ASEID (if any)
+     */
+    get shard() {
+        return this._shard;
+    }
+    /**
+     * get Internal Initializer based on the type of the parameter provided
+     *
+     * @param param1
+     * @returns
+     */
+    getInitializer(param1) {
+        switch (true) {
+            case A_TypeGuards_helper_1.A_TypeGuards.isString(param1):
+                return this.fromString;
+            case A_TypeGuards_helper_1.A_TypeGuards.isObject(param1):
+                return this.fromObject;
+            default:
+                throw new ASEID_error_1.ASEID_Error(ASEID_error_1.ASEID_Error.ASEIDInitializationError, 'Invalid parameters provided to ASEID constructor');
+        }
+    }
+    /**
+     * Initialize ASEID from string
+     *
+     * @param param1
+     */
+    fromString(param1) {
+        const [concept, body, version] = param1.split('@');
+        const [scope, entity, idCandidate] = body.split(':');
+        const shard = idCandidate.includes('.') ? idCandidate.split('.')[0] : undefined;
+        const id = idCandidate.includes('.') ? idCandidate.split('.')[1] : idCandidate;
+        this._concept = concept || A_Context_class_1.A_Context.root.name;
+        this._scope = scope || A_Context_class_1.A_Context.root.name;
+        this._entity = entity;
+        this._id = id;
+        this._version = version;
+        this._shard = shard;
+    }
+    /**
+     * Initialize ASEID from object
+     *
+     * @param param1
+     */
+    fromObject(param1) {
+        this._concept = param1.concept
+            ? ASEID.isASEID(param1.concept)
+                ? new ASEID(param1.concept).id
+                : param1.concept
+            : A_Context_class_1.A_Context.concept;
+        this._scope = param1.scope
+            ? A_TypeGuards_helper_1.A_TypeGuards.isNumber(param1.scope)
+                ? A_Identity_helper_1.A_IdentityHelper.formatWithLeadingZeros(param1.scope) :
+                ASEID.isASEID(param1.scope)
+                    ? new ASEID(param1.scope).id
+                    : param1.scope
+            : A_Context_class_1.A_Context.root.name;
+        this._entity = param1.entity;
+        this._id = A_TypeGuards_helper_1.A_TypeGuards.isNumber(param1.id)
+            ? A_Identity_helper_1.A_IdentityHelper.formatWithLeadingZeros(param1.id)
+            : param1.id;
+        this._version = param1.version;
+        this._shard = param1.shard;
+    }
+    /**
+     * String representation of the ASEID
+     *
+     * @returns
+     */
+    toString() {
+        return `${this.concept}@${this.scope}:${this.entity}:${this.shard ? (this.shard + '.' + this.id) : this.id}${this.version ? ('@' + this.version) : ''}`;
+    }
+    /**
+     * JSON representation of the ASEID
+     *
+     * @returns
+     */
+    toJSON() {
+        return {
+            concept: this._concept,
+            scope: this._scope,
+            entity: this._entity,
+            id: this._id,
+            version: this._version,
+            shard: this._shard
+        };
+    }
+    // --------------------------------------------------------------------------
+    // ----------------------- PROTECTED HELPERS --------------------------------
+    // --------------------------------------------------------------------------
+    verifyInput(param1) {
+        switch (true) {
+            // 1) check for string and validate it as ASEID
+            case A_TypeGuards_helper_1.A_TypeGuards.isString(param1) && !ASEID.isASEID(param1):
+                throw new ASEID_error_1.ASEID_Error(ASEID_error_1.ASEID_Error.ASEIDValidationError, 'Invalid ASEID format provided');
+            // 2) check for object and validate required fields
+            case A_TypeGuards_helper_1.A_TypeGuards.isObject(param1) && !param1.id:
+                throw new ASEID_error_1.ASEID_Error(ASEID_error_1.ASEID_Error.ASEIDValidationError, 'ASEID id is required');
+            // 3) check for object and validate required fields
+            case A_TypeGuards_helper_1.A_TypeGuards.isObject(param1) && !param1.entity:
+                throw new ASEID_error_1.ASEID_Error(ASEID_error_1.ASEID_Error.ASEIDValidationError, 'ASEID entity is required');
+        }
+    }
+}
+exports.ASEID = ASEID;
+//==========================================================================
+//============================= STATIC METHODS ===========================
+//==========================================================================
+/**
+ * ASEID Regular Expression
+ */
+ASEID.regexp = new RegExp(`^[a-z|A-Z|0-9|-]+@[a-z|A-Z|0-9|-]+:[a-z|A-Z|0-9|-]+:[a-z|A-Z|0-9|-|\\.]+(@v[0-9|\\.]+|@lts)?$`);
+//# sourceMappingURL=ASEID.class.js.map

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

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

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

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=ASEID.constants.js.map

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

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

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

@@ -0,0 +1,5 @@
+import { A_Error } from "../A-Error/A_Error.class";
+export declare class ASEID_Error extends A_Error {
+    static readonly ASEIDInitializationError = "ASEID Initialization Error";
+    static readonly ASEIDValidationError = "ASEID Validation Error";
+}

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

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASEID_Error = void 0;
+const A_Error_class_1 = require("../A-Error/A_Error.class");
+class ASEID_Error extends A_Error_class_1.A_Error {
+}
+exports.ASEID_Error = ASEID_Error;
+ASEID_Error.ASEIDInitializationError = 'ASEID Initialization Error';
+ASEID_Error.ASEIDValidationError = 'ASEID Validation Error';
+//# sourceMappingURL=ASEID.error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ASEID.error.js","sourceRoot":"","sources":["../../../../src/global/ASEID/ASEID.error.ts"],"names":[],"mappings":";;;AAAA,4DAAmD;AAInD,MAAa,WAAY,SAAQ,uBAAO;;AAAxC,kCAOC;AAJmB,oCAAwB,GAAG,4BAA4B,CAAC;AAExD,gCAAoB,GAAG,wBAAwB,CAAC"}

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

@@ -0,0 +1,65 @@
+export interface A_TYPES__ASEID_Constructor {
+    /**
+     * Concept for the ASEID
+     * Generally it is the application name or code, should correspond to the concept where the entity is used
+     * Could be ID or ASEID
+     */
+    concept?: string;
+    /**
+     * Entity Scope the primary location of the resource
+     * Organization, or organization Unit or Internal/External
+     * Could be ID or ASEID
+     *
+     */
+    scope: number | string;
+    /**
+     * Entity Type the type of the resource
+     */
+    entity: string;
+    /**
+     * Entity ID the unique identifier of the resource
+     */
+    id: number | string;
+    /**
+     * Version of the entity (optional)
+     */
+    version?: string;
+    /**
+     * Shard of the entity (optional)
+     */
+    shard?: string;
+}
+export interface A_TYPES__ASEID_ConstructorConfig {
+    /**
+     * If true, the entity ASEID will be distributed across multiple shards.
+     * In this case SHARD should be provided via Environment Variables (A_SHARD) or Configurations
+     *
+     */
+    sharding?: boolean;
+}
+export type A_TYPES__ASEID_JSON = {
+    /**
+     * Concept for the ASEID
+     */
+    concept: string;
+    /**
+     * Entity Scope the primary location of the resource
+     */
+    scope: string;
+    /**
+     * Entity Type the type of the resource
+     */
+    entity: string;
+    /**
+     * Entity ID the unique identifier of the resource
+     */
+    id: string;
+    /**
+     * Version of the entity (optional)
+     */
+    version?: string;
+    /**
+     * Shard of the entity (optional)
+     */
+    shard?: string;
+};

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ASEID.types.js","sourceRoot":"","sources":["../../../../src/global/ASEID/ASEID.types.ts"],"names":[],"mappings":";;AA8BC,CAAC;AAYD,CAAC"}

package/dist/src/helpers/A_Common.helper.d.ts

@@ -0,0 +1,28 @@
+import { A_TYPES__DeepPartial } from "../types/A_Common.types";
+export declare class A_CommonHelper {
+    /**
+     * A simple promise that resolves immediately.
+     * Can be used in async functions to create a resolved promise.
+     */
+    static resolve(): Promise<void>;
+    /**
+     * Check if a class is inherited from another class
+     *
+     * @param childClass
+     * @param parentClass
+     * @returns
+     */
+    static isInheritedFrom(childClass: any, parentClass: any): boolean;
+    /**
+     *  Omit properties from an object or array with nested objects
+     *
+     * @param input
+     * @param paths
+     * @returns
+     */
+    static omitProperties<T, S extends string>(input: T, paths: string[]): Omit<T, S>;
+    static isObject(item: unknown): item is Record<string, any>;
+    static deepMerge<T = any>(target: any, source: any, visited?: Map<any, any>): T;
+    static deepClone<T>(target: T): T;
+    static deepCloneAndMerge<T>(target: A_TYPES__DeepPartial<T>, source: T): T;
+}

package/dist/src/helpers/A_Common.helper.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A_CommonHelper = void 0;
+class A_CommonHelper {
+    /**
+     * A simple promise that resolves immediately.
+     * Can be used in async functions to create a resolved promise.
+     */
+    static resolve() {
+        return new Promise((resolve) => resolve());
+    }
+    /**
+     * Check if a class is inherited from another class
+     *
+     * @param childClass
+     * @param parentClass
+     * @returns
+     */
+    static isInheritedFrom(childClass, parentClass) {
+        let current = childClass;
+        // Traverse the prototype chain
+        while (current) {
+            if (current === parentClass) {
+                return true;
+            }
+            current = Object.getPrototypeOf(current);
+        }
+        return false;
+    }
+    /**
+     *  Omit properties from an object or array with nested objects
+     *
+     * @param input
+     * @param paths
+     * @returns
+     */
+    static omitProperties(input, paths) {
+        // Deep clone the input object or array
+        const result = JSON.parse(JSON.stringify(input));
+        // Helper function to recursively remove properties
+        function removeProperties(target, currPath) {
+            const currKey = currPath[0];
+            if (currPath.length === 1) {
+                // If current path has only one key, delete the property
+                delete target[currKey];
+            }
+            else if (target[currKey] !== undefined && typeof target[currKey] === 'object') {
+                // If current key exists and is an object, recursively call removeProperties
+                removeProperties(target[currKey], currPath.slice(1));
+            }
+        }
+        // Iterate through each path and remove corresponding properties from the result
+        paths.forEach(path => {
+            const pathKeys = path.split('.');
+            removeProperties(result, pathKeys);
+        });
+        return result;
+    }
+    static isObject(item) {
+        return item !== null && typeof item === 'object' && !Array.isArray(item);
+    }
+    static deepMerge(target, source, visited = new Map()) {
+        if (this.isObject(target) && this.isObject(source)) {
+            for (const key in source) {
+                if (this.isObject(source[key])) {
+                    if (!target[key]) {
+                        target[key] = {};
+                    }
+                    // Check if the source object has already been visited
+                    if (!visited.has(source[key])) {
+                        visited.set(source[key], {});
+                        this.deepMerge(target[key], source[key], visited);
+                    }
+                    else {
+                        target[key] = visited.get(source[key]);
+                    }
+                }
+                else {
+                    target[key] = source[key];
+                }
+            }
+        }
+        return target;
+    }
+    static deepClone(target) {
+        // Check if the value is null or undefined
+        if (target === null || target === undefined) {
+            return target;
+        }
+        // Handle primitive types (string, number, boolean, etc.)
+        if (typeof target !== 'object') {
+            return target;
+        }
+        // Handle Date
+        if (target instanceof Date) {
+            return new Date(target.getTime());
+        }
+        // Handle Array
+        if (Array.isArray(target)) {
+            return target.map(item => this.deepClone(item));
+        }
+        // Handle Function
+        if (typeof target === 'function') {
+            return target;
+        }
+        // Handle Object
+        if (target instanceof Object) {
+            const clone = {};
+            for (const key in target) {
+                if (target.hasOwnProperty(key)) {
+                    clone[key] = this.deepClone(target[key]);
+                }
+            }
+            return clone;
+        }
+        // For any other cases
+        throw new Error('Unable to clone the object. Unsupported type.');
+    }
+    static deepCloneAndMerge(target, source) {
+        if ((source === null || source === undefined) &&
+            (target === null || target === undefined))
+            return target;
+        // Check if the value is null or undefined
+        if ((target === null || target === undefined) &&
+            source) {
+            return this.deepClone(source);
+        }
+        // Handle primitive types (string, number, boolean, etc.)
+        if (typeof target !== 'object') {
+            return target;
+        }
+        // Handle Date
+        if (target instanceof Date) {
+            return new Date(target.getTime());
+        }
+        // Handle Array
+        if (Array.isArray(target)) {
+            return target.map(item => this.deepCloneAndMerge(item, source));
+        }
+        // Handle Function
+        if (typeof target === 'function') {
+            return target;
+        }
+        // Handle Object
+        if (target instanceof Object) {
+            const clone = {};
+            for (const key in target) {
+                if (source[key] !== null
+                    &&
+                        source[key] !== undefined)
+                    clone[key] = this.deepCloneAndMerge(target[key], source[key]);
+                else
+                    clone[key] = this.deepClone(target[key]);
+            }
+            for (const key in source) {
+                if (target[key] !== undefined
+                    &&
+                        target[key] !== null)
+                    clone[key] = this.deepCloneAndMerge(target[key], source[key]);
+                else
+                    clone[key] = this.deepClone(source[key]);
+            }
+            return clone;
+        }
+        // For any other cases
+        throw new Error('Unable to clone the object. Unsupported type.');
+    }
+}
+exports.A_CommonHelper = A_CommonHelper;
+//# sourceMappingURL=A_Common.helper.js.map