@pristine-ts/data-mapping 0.0.277

package/dist/lib/cjs/errors/data-normalizer-already-added.error.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataNormalizerAlreadyAdded = void 0;
+const common_1 = require("@pristine-ts/common");
+/**
+ * This Error is thrown when a normalizer is added more than once.
+ */
+class DataNormalizerAlreadyAdded extends common_1.LoggableError {
+    constructor(message, normalizerUniqueKey, options) {
+        super(message, {
+            normalizerUniqueKey,
+            options,
+        });
+        // Set the prototype explicitly.
+        // As specified in the documentation in TypeScript
+        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
+        Object.setPrototypeOf(this, DataNormalizerAlreadyAdded.prototype);
+    }
+}
+exports.DataNormalizerAlreadyAdded = DataNormalizerAlreadyAdded;
+//# sourceMappingURL=data-normalizer-already-added.error.js.map

package/dist/lib/cjs/errors/data-normalizer-already-added.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-normalizer-already-added.error.js","sourceRoot":"","sources":["../../../../src/errors/data-normalizer-already-added.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAGlD;;GAEG;AACH,MAAa,0BAA2B,SAAQ,sBAAa;IAEzD,YAAmB,OAAe,EAAE,mBAA2B,EAAE,OAAa;QAC1E,KAAK,CAAC,OAAO,EAAE;YACX,mBAAmB;YACnB,OAAO;SACV,CAAC,CAAC;QAGH,gCAAgC;QAChC,kDAAkD;QAClD,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;CACJ;AAdD,gEAcC"}

package/dist/lib/cjs/errors/errors.js

@@ -0,0 +1,25 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./array-data-mapping-node-invalid-source-property-type.error"), exports);
+__exportStar(require("./data-after-mapping-interceptor-already-added.error"), exports);
+__exportStar(require("./data-before-mapping-interceptor-already-added.error"), exports);
+__exportStar(require("./data-normalizer-already-added.error"), exports);
+__exportStar(require("./data-mapping-interceptor-not-found.error"), exports);
+__exportStar(require("./data-mapping-source-property-not-found.error"), exports);
+__exportStar(require("./normalizer-invalid-source-type.error"), exports);
+__exportStar(require("./undefined-source-property.error"), exports);
+//# sourceMappingURL=errors.js.map

package/dist/lib/cjs/errors/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../src/errors/errors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+FAA6E;AAC7E,uFAAqE;AACrE,wFAAsE;AACtE,wEAAsD;AACtD,6EAA2D;AAC3D,iFAA+D;AAC/D,yEAAuD;AACvD,oEAAkD"}

package/dist/lib/cjs/errors/normalizer-invalid-source-type.error.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NormalizerInvalidSourceTypeError = void 0;
+const common_1 = require("@pristine-ts/common");
+/**
+ * This Error is thrown when an invalid source type is passed to the source type while the normalizer expects another type.
+ */
+class NormalizerInvalidSourceTypeError extends common_1.LoggableError {
+    constructor(message, normalizerUniqueKey, options, source, sourceType) {
+        super(message, {
+            normalizerUniqueKey,
+            options,
+            source,
+            sourceType,
+        });
+        // Set the prototype explicitly.
+        // As specified in the documentation in TypeScript
+        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
+        Object.setPrototypeOf(this, NormalizerInvalidSourceTypeError.prototype);
+    }
+}
+exports.NormalizerInvalidSourceTypeError = NormalizerInvalidSourceTypeError;
+//# sourceMappingURL=normalizer-invalid-source-type.error.js.map

package/dist/lib/cjs/errors/normalizer-invalid-source-type.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer-invalid-source-type.error.js","sourceRoot":"","sources":["../../../../src/errors/normalizer-invalid-source-type.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAGlD;;GAEG;AACH,MAAa,gCAAiC,SAAQ,sBAAa;IAE/D,YAAmB,OAAe,EAAE,mBAA2B,EAAE,OAAY,EAAE,MAAW,EAAE,UAAe;QACvG,KAAK,CAAC,OAAO,EAAE;YACX,mBAAmB;YACnB,OAAO;YACP,MAAM;YACN,UAAU;SACb,CAAC,CAAC;QAEH,gCAAgC;QAChC,kDAAkD;QAClD,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gCAAgC,CAAC,SAAS,CAAC,CAAC;IAC5E,CAAC;CACJ;AAfD,4EAeC"}

package/dist/lib/cjs/errors/undefined-source-property.error.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UndefinedSourcePropertyError = void 0;
+const common_1 = require("@pristine-ts/common");
+/**
+ * This Error is thrown when you are trying to add a Node which has an undefined sourceProperty value.
+ */
+class UndefinedSourcePropertyError extends common_1.LoggableError {
+    constructor(node) {
+        super("The `sourceProperty` property of the Node cannot be undefined to be added as a Node to its parent.", {
+            node,
+        });
+        // Set the prototype explicitly.
+        // As specified in the documentation in TypeScript
+        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
+        Object.setPrototypeOf(this, UndefinedSourcePropertyError.prototype);
+    }
+}
+exports.UndefinedSourcePropertyError = UndefinedSourcePropertyError;
+//# sourceMappingURL=undefined-source-property.error.js.map

package/dist/lib/cjs/errors/undefined-source-property.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undefined-source-property.error.js","sourceRoot":"","sources":["../../../../src/errors/undefined-source-property.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAIlD;;GAEG;AACH,MAAa,4BAA6B,SAAQ,sBAAa;IAE3D,YAAmB,IAAuC;QACtD,KAAK,CAAC,oGAAoG,EAAE;YACxG,IAAI;SACP,CAAC,CAAC;QAEH,gCAAgC;QAChC,kDAAkD;QAClD,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC;CACJ;AAZD,oEAYC"}

package/dist/lib/cjs/interceptors/default-data-mapping.interceptor.js

@@ -0,0 +1,44 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var DefaultDataMappingInterceptor_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultDataMappingInterceptor = void 0;
+const common_1 = require("@pristine-ts/common");
+const data_mapping_module_keyname_1 = require("../data-mapping.module.keyname");
+const tsyringe_1 = require("tsyringe");
+let DefaultDataMappingInterceptor = DefaultDataMappingInterceptor_1 = class DefaultDataMappingInterceptor {
+    afterMapping(row) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return row;
+        });
+    }
+    beforeMapping(row) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return row;
+        });
+    }
+    getUniqueKey() {
+        return DefaultDataMappingInterceptor_1.name;
+    }
+};
+exports.DefaultDataMappingInterceptor = DefaultDataMappingInterceptor;
+exports.DefaultDataMappingInterceptor = DefaultDataMappingInterceptor = DefaultDataMappingInterceptor_1 = __decorate([
+    (0, common_1.tag)("DataTransformerInterceptor"),
+    (0, common_1.moduleScoped)(data_mapping_module_keyname_1.DataMappingModuleKeyname),
+    (0, tsyringe_1.injectable)()
+], DefaultDataMappingInterceptor);
+//# sourceMappingURL=default-data-mapping.interceptor.js.map

package/dist/lib/cjs/interceptors/default-data-mapping.interceptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-data-mapping.interceptor.js","sourceRoot":"","sources":["../../../../src/interceptors/default-data-mapping.interceptor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AACA,gDAAsD;AACtD,gFAAwE;AACxE,uCAAoC;AAM7B,IAAM,6BAA6B,qCAAnC,MAAM,6BAA6B;IAChC,YAAY,CAAC,GAAQ;;YACvB,OAAO,GAAG,CAAC;QACf,CAAC;KAAA;IAEK,aAAa,CAAC,GAAQ;;YACxB,OAAO,GAAG,CAAC;QACf,CAAC;KAAA;IAED,YAAY;QACR,OAAO,+BAA6B,CAAC,IAAI,CAAC;IAC9C,CAAC;CACJ,CAAA;AAZY,sEAA6B;wCAA7B,6BAA6B;IAHzC,IAAA,YAAG,EAAC,4BAA4B,CAAC;IACjC,IAAA,qBAAY,EAAC,sDAAwB,CAAC;IACtC,IAAA,qBAAU,GAAE;GACA,6BAA6B,CAYzC"}

package/dist/lib/cjs/interceptors/interceptors.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./default-data-mapping.interceptor"), exports);
+//# sourceMappingURL=interceptors.js.map

package/dist/lib/cjs/interceptors/interceptors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptors.js","sourceRoot":"","sources":["../../../../src/interceptors/interceptors.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qEAAmD"}

package/dist/lib/cjs/interfaces/data-mapping-interceptor.interface.js

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

package/dist/lib/cjs/interfaces/data-mapping-interceptor.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-mapping-interceptor.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/data-mapping-interceptor.interface.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/interfaces/data-normalizer.interface.js

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

package/dist/lib/cjs/interfaces/data-normalizer.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-normalizer.interface.js","sourceRoot":"","sources":["../../../../src/interfaces/data-normalizer.interface.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/interfaces/interfaces.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./data-normalizer.interface"), exports);
+__exportStar(require("./data-mapping-interceptor.interface"), exports);
+//# sourceMappingURL=interfaces.js.map

package/dist/lib/cjs/interfaces/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C;AAC5C,uEAAqD"}

package/dist/lib/cjs/mappers/data.mapper.js

@@ -0,0 +1,112 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataMapper = void 0;
+const common_1 = require("@pristine-ts/common");
+const data_mapping_module_keyname_1 = require("../data-mapping.module.keyname");
+const tsyringe_1 = require("tsyringe");
+const class_transformer_1 = require("class-transformer");
+const data_mapping_interceptor_not_found_error_1 = require("../errors/data-mapping-interceptor-not-found.error");
+let DataMapper = class DataMapper {
+    constructor(dataNormalizers, dataTransformerInterceptors) {
+        this.dataNormalizers = dataNormalizers;
+        this.dataTransformerInterceptors = dataTransformerInterceptors;
+        this.dataNormalizersMap = {};
+        this.dataTransformerInterceptorsMap = {};
+        dataNormalizers.forEach(dataNormalizer => {
+            this.dataNormalizersMap[dataNormalizer.getUniqueKey()] = dataNormalizer;
+        });
+        dataTransformerInterceptors.forEach(interceptor => {
+            this.dataTransformerInterceptorsMap[interceptor.getUniqueKey()] = interceptor;
+        });
+    }
+    /**
+     * This method takes an array of source and maps each item.
+     *
+     * @param builder
+     * @param source
+     * @param destinationType
+     */
+    mapAll(builder, source, destinationType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const destination = [];
+            for (const element of source) {
+                destination.push(yield this.map(builder, element, destinationType));
+            }
+            return destination;
+        });
+    }
+    /**
+     * This method takes a builder, a source and maps it according to the builder. You can pass a `destinationType (optional)`
+     * that is an object that will be constructed.
+     *
+     * @param builder
+     * @param source
+     * @param destinationType
+     */
+    map(builder, source, destinationType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let destination = {};
+            let interceptedSource = source;
+            // Execute the before interceptors.
+            for (const element of builder.beforeMappingInterceptors) {
+                const interceptor = this.dataTransformerInterceptorsMap[element.key];
+                if (interceptor === undefined) {
+                    throw new data_mapping_interceptor_not_found_error_1.DataMappingInterceptorNotFoundError("The interceptor wasn't found and cannot be loaded.", element.key);
+                }
+                // todo: Pass the options when we start using them.
+                interceptedSource = yield interceptor.beforeMapping(interceptedSource);
+            }
+            // Loop over the properties defined in the builder
+            for (const key in builder.nodes) {
+                if (builder.nodes.hasOwnProperty(key) === false) {
+                    continue;
+                }
+                const node = builder.nodes[key];
+                yield node.map(interceptedSource, destination, this.dataNormalizersMap);
+            }
+            // Execute the before interceptors.
+            for (const element of builder.afterMappingInterceptors) {
+                const interceptor = this.dataTransformerInterceptorsMap[element.key];
+                if (interceptor === undefined) {
+                    throw new data_mapping_interceptor_not_found_error_1.DataMappingInterceptorNotFoundError("The interceptor wasn't found and cannot be loaded.", element.key);
+                }
+                // todo pass the options when we start using it.
+                destination = yield interceptor.afterMapping(destination);
+            }
+            if (destinationType) {
+                destination = (0, class_transformer_1.plainToInstance)(destinationType, destination);
+            }
+            return destination;
+        });
+    }
+};
+exports.DataMapper = DataMapper;
+exports.DataMapper = DataMapper = __decorate([
+    (0, common_1.moduleScoped)(data_mapping_module_keyname_1.DataMappingModuleKeyname),
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.injectAll)("DataNormalizerInterface")),
+    __param(1, (0, tsyringe_1.injectAll)("DataTransformerInterceptor")),
+    __metadata("design:paramtypes", [Array, Array])
+], DataMapper);
+//# sourceMappingURL=data.mapper.js.map

package/dist/lib/cjs/mappers/data.mapper.js.map

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

package/dist/lib/cjs/mappers/mappers.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./data.mapper"), exports);
+//# sourceMappingURL=mappers.js.map

package/dist/lib/cjs/mappers/mappers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappers.js","sourceRoot":"","sources":["../../../../src/mappers/mappers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/lib/cjs/nodes/base-data-mapping.node.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseDataMappingNode = void 0;
+const undefined_source_property_error_1 = require("../errors/undefined-source-property.error");
+class BaseDataMappingNode {
+    constructor() {
+        this.nodes = {};
+    }
+    /**
+     * This method is called by the node itself to tell its parent that it has been build and is ready to be added.
+     * We use this mechanism to force the `end()` method on the leaf to be called so we can do some validations before
+     * adding it to the tree.
+     *
+     * @param node
+     */
+    addNode(node) {
+        if (node.sourceProperty === undefined) {
+            throw new undefined_source_property_error_1.UndefinedSourcePropertyError(node);
+        }
+        this.nodes[node.sourceProperty] = node;
+    }
+}
+exports.BaseDataMappingNode = BaseDataMappingNode;
+//# sourceMappingURL=base-data-mapping.node.js.map

package/dist/lib/cjs/nodes/base-data-mapping.node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-data-mapping.node.js","sourceRoot":"","sources":["../../../../src/nodes/base-data-mapping.node.ts"],"names":[],"mappings":";;;AAEA,+FAAuF;AAEvF,MAAsB,mBAAmB;IAAzC;QACW,UAAK,GAAoE,EAAE,CAAC;IAkBvF,CAAC;IAhBG;;;;;;OAMG;IACI,OAAO,CAAC,IAAuC;QAClD,IAAG,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE;YAClC,MAAM,IAAI,8DAA4B,CAAC,IAAI,CAAC,CAAC;SAChD;QAED,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAC3C,CAAC;CAGJ;AAnBD,kDAmBC"}

package/dist/lib/cjs/nodes/data-mapping.leaf.js

@@ -0,0 +1,184 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataMappingLeaf = void 0;
+const data_mapping_node_type_enum_1 = require("../enums/data-mapping-node-type.enum");
+const data_normalizer_already_added_error_1 = require("../errors/data-normalizer-already-added.error");
+const data_mapping_source_property_not_found_error_1 = require("../errors/data-mapping-source-property-not-found.error");
+const array_data_mapping_node_invalid_source_property_type_error_1 = require("../errors/array-data-mapping-node-invalid-source-property-type.error");
+class DataMappingLeaf {
+    constructor(root, parent, type = data_mapping_node_type_enum_1.DataMappingNodeTypeEnum.Leaf) {
+        this.root = root;
+        this.parent = parent;
+        this.type = type;
+        /**
+         * This property contains an array of Normalizers to apply sequentially when mapping this property.
+         */
+        this.normalizers = [];
+        /**
+         * This property contains an array of Normalizers that must be excluded from normalizers defined by parents.
+         */
+        this.excludedNormalizers = new Set();
+        /**
+         * This method specified whether it's possible that this element not be present in the `source` object.
+         */
+        this.isOptional = false;
+    }
+    /**
+     * This is a setter for `sourceProperty`.
+     * @param sourceProperty
+     */
+    setSourceProperty(sourceProperty) {
+        this.sourceProperty = sourceProperty;
+        return this;
+    }
+    /**
+     * This is a setter for `destinationProperty`.
+     * @param destinationProperty
+     */
+    setDestinationProperty(destinationProperty) {
+        this.destinationProperty = destinationProperty;
+        return this;
+    }
+    /**
+     * This is a setter for `isOptional`.
+     * @param isOptional
+     */
+    setIsOptional(isOptional) {
+        this.isOptional = isOptional;
+        return this;
+    }
+    /**
+     * This methods adds a normalizer but checks that this normalizer hasn't been added already (either at the root) or
+     * directly on this leaf.
+     *
+     * @param normalizerUniqueKey
+     * @param options
+     */
+    addNormalizer(normalizerUniqueKey, options) {
+        if (this.hasNormalizer(normalizerUniqueKey)) {
+            throw new data_normalizer_already_added_error_1.DataNormalizerAlreadyAdded("The data normalizer '" + normalizerUniqueKey + "' has already been added to the leaf with destination property: '" + this.destinationProperty + "'.", normalizerUniqueKey, options);
+        }
+        if (this.root.hasNormalizer(normalizerUniqueKey)) {
+            throw new data_normalizer_already_added_error_1.DataNormalizerAlreadyAdded("The data normalizer '" + normalizerUniqueKey + "' has already been added to the root and cannot be also added to the leaf with destination property: '" + this.destinationProperty + "'.", normalizerUniqueKey, options);
+        }
+        this.normalizers.push({
+            key: normalizerUniqueKey,
+            options,
+        });
+        return this;
+    }
+    /**
+     * This method simply returns whether the normalizer was already added to this node.
+     * @param normalizerUniqueKey
+     */
+    hasNormalizer(normalizerUniqueKey) {
+        return this.normalizers.find(element => element.key === normalizerUniqueKey) !== undefined;
+    }
+    /**
+     * This method adds a normalizer that must be excluded from the normalizers applied at a higher level.à
+     * @param normalizerUniqueKey
+     */
+    excludeNormalizer(normalizerUniqueKey) {
+        if (this.excludedNormalizers.has(normalizerUniqueKey)) {
+            throw new data_normalizer_already_added_error_1.DataNormalizerAlreadyAdded("The EXCLUDED data normalizer '" + normalizerUniqueKey + "' has already been added to this source property: '" + this.sourceProperty + "'.", normalizerUniqueKey);
+        }
+        this.excludedNormalizers.add(normalizerUniqueKey);
+        return this;
+    }
+    /**
+     * This method adds this node to its parent and returns the parent.
+     */
+    end() {
+        // todo: Validate that we actually have all the properties needed (sourceProperty and destinationProperty) for example.
+        this.parent.addNode(this);
+        return this.parent;
+    }
+    /**
+     * This method maps the `sourceProperty` from the `source` object and maps it to the `destinationProperty` of the
+     * `destination` object while applying the normalizers.
+     *
+     * @param source
+     * @param destination
+     * @param normalizersMap
+     */
+    map(source, destination, normalizersMap) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (source.hasOwnProperty(this.sourceProperty) === false) {
+                if (this.isOptional) {
+                    return;
+                }
+                throw new data_mapping_source_property_not_found_error_1.DataMappingSourcePropertyNotFoundError("The property '" + this.sourceProperty + "' isn't found in the Source object and isn't marked as Optional. If you want to ignore this property, use the 'setIsOptional(true)' method in the builder.", this.sourceProperty);
+            }
+            const normalizers = this.root.normalizers.filter(element => this.excludedNormalizers.has(element.key) === false);
+            normalizers.push(...this.normalizers);
+            if (this.type === data_mapping_node_type_enum_1.DataMappingNodeTypeEnum.ScalarArray) {
+                // This means that the source[propertyKey] contains an array of objects and each object should be mapped
+                const array = source[this.sourceProperty];
+                if (Array.isArray(array) === false) {
+                    throw new array_data_mapping_node_invalid_source_property_type_error_1.ArrayDataMappingNodeInvalidSourcePropertyTypeError(`According to your schema, the property '${this.sourceProperty}' in the source object must contain an Array of Scalar. Instead, it contains: '${typeof array}'.`, this.sourceProperty);
+                }
+                destination[this.destinationProperty] = [];
+                for (let value of array) {
+                    normalizers.forEach(element => {
+                        const normalizer = normalizersMap[element.key];
+                        value = normalizer.normalize(value, element.options);
+                    });
+                    destination[this.destinationProperty].push(value);
+                }
+                return;
+            }
+            let value = source[this.sourceProperty];
+            normalizers.forEach(element => {
+                const normalizer = normalizersMap[element.key];
+                value = normalizer.normalize(value, element.options);
+            });
+            destination[this.destinationProperty] = value;
+            return;
+        });
+    }
+    /**
+     * This method imports a schema.
+     *
+     * @param schema
+     */
+    import(schema) {
+        this.normalizers = schema.normalizers;
+        this.excludedNormalizers = new Set();
+        if (schema.hasOwnProperty("excludedNormalizers")) {
+            for (const item in schema.excludedNormalizers) {
+                this.excludeNormalizer(item);
+            }
+        }
+        this.isOptional = schema.isOptional;
+        this.sourceProperty = schema.sourceProperty;
+        this.destinationProperty = schema.destinationProperty;
+    }
+    /**
+     * This method exports this node.
+     */
+    export() {
+        const excludedNormalizers = {};
+        for (const element of this.excludedNormalizers.values()) {
+            excludedNormalizers[element] = true;
+        }
+        return {
+            "_type": this.type,
+            "sourceProperty": this.sourceProperty,
+            "destinationProperty": this.destinationProperty,
+            "isOptional": this.isOptional,
+            "normalizers": this.normalizers,
+            "excludedNormalizers": excludedNormalizers,
+        };
+    }
+}
+exports.DataMappingLeaf = DataMappingLeaf;
+//# sourceMappingURL=data-mapping.leaf.js.map

package/dist/lib/cjs/nodes/data-mapping.leaf.js.map

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