@pristine-ts/data-mapping-common 2.0.8 → 2.0.10

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

@@ -117,61 +117,125 @@ class DataMappingNode extends base_data_mapping_node_1.BaseDataMappingNode {
             if (sourceElement === undefined) {
                 return;
             }
+            // Whether source-keyed properties should be carried through to the destination.
+            // When `excludeExtraneousValues === true`, only renamed destination keys (written by
+            // sub-nodes below) end up on the destination — source keys are dropped.
+            const includeSourceKeys = (options === null || options === void 0 ? void 0 : options.excludeExtraneousValues) === false;
             if (this.type === data_mapping_node_type_enum_1.DataMappingNodeTypeEnum.ObjectArray) {
+                // Array case: handled below in its own loop. Just pre-allocate the array here.
                 destination[this.destinationProperty] = [];
             }
             else {
-                if (this.destinationType) {
-                    destination[this.destinationProperty] = (0, class_transformer_1.plainToInstance)(this.destinationType, sourceElement);
-                }
-                else {
-                    destination[this.destinationProperty] = {};
-                }
-                if ((options === null || options === void 0 ? void 0 : options.excludeExtraneousValues) === false) {
-                    if (typeof sourceElement === "object" || Array.isArray(sourceElement)) {
-                        Object.keys(sourceElement).forEach(property => {
-                            destination[this.destinationProperty][property] = sourceElement[property];
-                        });
-                    }
-                }
+                // Single-object case: build the destination value once, then let sub-nodes overlay
+                // renamed keys onto it.
+                destination[this.destinationProperty] = this.buildDestinationObject(sourceElement, includeSourceKeys);
             }
             const destinationElement = destination[this.destinationProperty];
             if (this.type === data_mapping_node_type_enum_1.DataMappingNodeTypeEnum.ObjectArray) {
-                // 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 objects. Instead, it contains: '${typeof array}'.`, this.sourceProperty);
+                const sourceArray = source[this.sourceProperty];
+                if (Array.isArray(sourceArray) === 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 objects. Instead, it contains: '${typeof sourceArray}'.`, this.sourceProperty);
                 }
-                let index = 0;
-                for (const element of array) {
-                    let dest = {};
-                    if (this.destinationType) {
-                        if (typeof this.destinationType === "function" && !this.destinationType.prototype) {
-                            const destinationType = this.destinationType;
-                            dest = (0, class_transformer_1.plainToInstance)(destinationType(source, this.sourceProperty, index).constructor, (options === null || options === void 0 ? void 0 : options.excludeExtraneousValues) === false ? element : {});
-                        }
-                        else if (this.destinationType.prototype) {
-                            dest = (0, class_transformer_1.plainToInstance)(this.destinationType, {});
-                        }
-                    }
-                    if ((options === null || options === void 0 ? void 0 : options.excludeExtraneousValues) === false) {
-                        Object.keys(element).forEach(property => {
-                            dest[property] = element[property];
-                        });
-                    }
-                    for (const key in this.nodes) {
-                        if (this.nodes.hasOwnProperty(key) === false) {
-                            continue;
-                        }
-                        const node = this.nodes[key];
-                        yield node.map(element, dest, normalizersMap, options);
-                    }
+                // For each source element: build the destination object (whose concrete class may
+                // depend on the element index when `destinationType` is a factory callback), let the
+                // sub-nodes overlay their renamed keys, then push.
+                for (let index = 0; index < sourceArray.length; index++) {
+                    const element = sourceArray[index];
+                    const dest = this.buildArrayMemberDestination(source, element, index, includeSourceKeys);
+                    yield this.runSubNodes(element, dest, normalizersMap, options);
                     destinationElement.push(dest);
                 }
-                index++;
                 return;
             }
-            // When the current node is not an array, we simply iterate
+            // Single-object case: sub-nodes write into the destination we just built above.
+            yield this.runSubNodes(sourceElement, destinationElement, normalizersMap, options);
+        });
+    }
+    /**
+     * Build the destination object for the single-object case.
+     *
+     * If a `destinationType` (class constructor) is set, instantiate the class. Otherwise return
+     * a plain object. When `includeSourceKeys` is true, the source's own enumerable properties are
+     * seeded onto the result so they survive the mapping; sub-nodes then overlay renamed keys on top.
+     *
+     * Note: the single-object case treats `destinationType` strictly as a class constructor.
+     * Factory callbacks only make sense for the per-element ObjectArray case below.
+     */
+    buildDestinationObject(sourceElement, includeSourceKeys) {
+        const seedFromSource = includeSourceKeys
+            && sourceElement !== null
+            && (typeof sourceElement === "object" || Array.isArray(sourceElement));
+        if (this.destinationType !== undefined) {
+            return (0, class_transformer_1.plainToInstance)(this.destinationType, seedFromSource ? sourceElement : {});
+        }
+        const result = {};
+        if (seedFromSource) {
+            Object.keys(sourceElement).forEach(property => {
+                result[property] = sourceElement[property];
+            });
+        }
+        return result;
+    }
+    /**
+     * Build the destination object for a single element of an ObjectArray. Mirrors
+     * `buildDestinationObject`, with two extra wrinkles unique to arrays:
+     *
+     *   1. `destinationType` can be a *factory callback* instead of a fixed class. The callback
+     *      receives the source array's parent + the element's index and returns an instance of
+     *      the concrete class to use. This is how polymorphic arrays work (e.g. some elements
+     *      become `Cat`, others `Dog`).
+     *   2. The seed value is the per-element object, not the whole array.
+     */
+    buildArrayMemberDestination(source, element, index, includeSourceKeys) {
+        const seedFromSource = includeSourceKeys && element !== null && typeof element === "object";
+        if (this.destinationType === undefined) {
+            // Untyped array — produce a plain object, optionally seeded with the element's own keys.
+            const result = {};
+            if (seedFromSource) {
+                Object.keys(element).forEach(property => {
+                    result[property] = element[property];
+                });
+            }
+            return result;
+        }
+        const memberConstructor = this.resolveArrayMemberConstructor(source, index);
+        return (0, class_transformer_1.plainToInstance)(memberConstructor, seedFromSource ? element : {});
+    }
+    /**
+     * Resolve the concrete class constructor for a single element of an ObjectArray.
+     *
+     * `destinationType` here is one of two things:
+     *
+     *   - a **class constructor** (uniform array — every element maps to the same class), or
+     *   - a **factory callback** of shape `(source, sourceProperty, index) => instance`
+     *     (polymorphic array — class is chosen per element).
+     *
+     * JavaScript gives us no clean way to distinguish a class constructor from a callback —
+     * both are `typeof === "function"`. The conventional discriminant: a class constructor has
+     * a `.prototype` object (where its instance methods live); an arrow function does not.
+     *
+     * Caveat: a regular `function() { ... }` expression used as a callback would also have a
+     * `.prototype` and would be mis-classified as a class. The public type only documents the
+     * arrow-function form (`ArrayMemberTypeFactoryCallbackType = (...) => any`), and in practice
+     * callers use arrow functions, so this is safe for documented usage.
+     */
+    resolveArrayMemberConstructor(source, index) {
+        const destinationType = this.destinationType;
+        const isFactoryCallback = typeof destinationType === "function"
+            && destinationType.prototype === undefined;
+        if (isFactoryCallback) {
+            const factory = destinationType;
+            const sampleInstance = factory(source, this.sourceProperty, index);
+            return sampleInstance.constructor;
+        }
+        return destinationType;
+    }
+    /**
+     * Run every direct child node against `(sourceElement, destinationElement)`. Each child
+     * writes its mapped destination property onto `destinationElement`.
+     */
+    runSubNodes(sourceElement, destinationElement, normalizersMap, options) {
+        return __awaiter(this, void 0, void 0, function* () {
             for (const key in this.nodes) {
                 if (this.nodes.hasOwnProperty(key) === false) {
                     continue;
@@ -215,22 +279,28 @@ class DataMappingNode extends base_data_mapping_node_1.BaseDataMappingNode {
         }
     }
     /**
-     * This method exports this node.
+     * This method exports this node. The exported representation is a plain object — it does not mutate
+     * the live tree, so the same builder can continue to be used for mapping after `export()` is called.
+     *
+     * `destinationType` is intentionally not serialized: class constructors aren't transferable, and
+     * factory callbacks (`ArrayMemberTypeFactoryCallbackType`) hold closures. To rehydrate a schema with
+     * the same destination instantiation behavior, decorate the destination class with class-transformer's
+     * `@Type()` and pass the destination class to `DataMapper.map()`.
      */
     export() {
-        const nodes = this.nodes;
-        for (const key in nodes) {
-            if (nodes.hasOwnProperty(key) === false) {
+        const exportedNodes = {};
+        for (const key in this.nodes) {
+            if (this.nodes.hasOwnProperty(key) === false) {
                 continue;
             }
-            nodes[key] = nodes[key].export();
+            exportedNodes[key] = this.nodes[key].export();
         }
         return {
             "_type": this.type,
             "sourceProperty": this.sourceProperty,
             "destinationProperty": this.destinationProperty,
             "isOptional": this.isOptional,
-            "nodes": nodes,
+            "nodes": exportedNodes,
         };
     }
 }

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

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

package/dist/lib/cjs/options/auto-data-mapping-builder.options.js

@@ -3,11 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AutoDataMappingBuilderOptions = void 0;
 class AutoDataMappingBuilderOptions {
     constructor(options) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         this.isOptionalDefaultValue = (_a = options === null || options === void 0 ? void 0 : options.isOptionalDefaultValue) !== null && _a !== void 0 ? _a : true;
         this.excludeExtraneousValues = (_b = options === null || options === void 0 ? void 0 : options.excludeExtraneousValues) !== null && _b !== void 0 ? _b : false;
         this.throwOnErrors = (_c = options === null || options === void 0 ? void 0 : options.throwOnErrors) !== null && _c !== void 0 ? _c : false;
         this.logErrors = (_d = options === null || options === void 0 ? void 0 : options.logErrors) !== null && _d !== void 0 ? _d : false;
+        this.disableCache = (_e = options === null || options === void 0 ? void 0 : options.disableCache) !== null && _e !== void 0 ? _e : false;
     }
 }
 exports.AutoDataMappingBuilderOptions = AutoDataMappingBuilderOptions;

package/dist/lib/cjs/options/auto-data-mapping-builder.options.js.map

@@ -1 +1 @@
-{"version":3,"file":"auto-data-mapping-builder.options.js","sourceRoot":"","sources":["../../../../src/options/auto-data-mapping-builder.options.ts"],"names":[],"mappings":";;;AAAA,MAAa,6BAA6B;IA2BxC,YAAY,OAAgD;;QAC1D,IAAI,CAAC,sBAAsB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,sBAAsB,mCAAI,IAAI,CAAC;QACtE,IAAI,CAAC,uBAAuB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,uBAAuB,mCAAI,KAAK,CAAC;QACzE,IAAI,CAAC,aAAa,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa,mCAAI,KAAK,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,mCAAI,KAAK,CAAC;IAC/C,CAAC;CACF;AAjCD,sEAiCC"}
+{"version":3,"file":"auto-data-mapping-builder.options.js","sourceRoot":"","sources":["../../../../src/options/auto-data-mapping-builder.options.ts"],"names":[],"mappings":";;;AAAA,MAAa,6BAA6B;IAwCxC,YAAY,OAAgD;;QAC1D,IAAI,CAAC,sBAAsB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,sBAAsB,mCAAI,IAAI,CAAC;QACtE,IAAI,CAAC,uBAAuB,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,uBAAuB,mCAAI,KAAK,CAAC;QACzE,IAAI,CAAC,aAAa,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,aAAa,mCAAI,KAAK,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,SAAS,mCAAI,KAAK,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,YAAY,mCAAI,KAAK,CAAC;IACrD,CAAC;CACF;AA/CD,sEA+CC"}

package/dist/lib/cjs/reporters/console-error.reporter.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConsoleErrorReporter = void 0;
+/**
+ * Built-in default reporter. Writes a header line + the error + a structured context payload
+ * to `console.error`. Used when no custom reporter is supplied to DataMapper — gives the
+ * frontend (and any non-DI caller) useful output out of the box.
+ *
+ * Exposed as a class-with-static-method so callers can compose it from their own reporters,
+ * e.g. `(err, ctx) => { sendToSentry(err); ConsoleErrorReporter.report(err, ctx); }`.
+ */
+class ConsoleErrorReporter {
+}
+exports.ConsoleErrorReporter = ConsoleErrorReporter;
+/**
+ * Matches the `DataMapperErrorReporter` shape so a method reference (`ConsoleErrorReporter.report`)
+ * can be passed wherever the callback type is expected.
+ */
+ConsoleErrorReporter.report = (error, context) => {
+    // eslint-disable-next-line no-console
+    console.error("[DataMapper] autoMap caught an error.", error, context);
+};
+//# sourceMappingURL=console-error.reporter.js.map

package/dist/lib/cjs/reporters/console-error.reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-error.reporter.js","sourceRoot":"","sources":["../../../../src/reporters/console-error.reporter.ts"],"names":[],"mappings":";;;AAEA;;;;;;;GAOG;AACH,MAAa,oBAAoB;;AAAjC,oDASC;AARC;;;GAGG;AACoB,2BAAM,GAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;IAC1E,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC,CAAC"}

package/dist/lib/cjs/reporters/reporters.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("./console-error.reporter"), exports);
+//# sourceMappingURL=reporters.js.map

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

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