@yamato-daiwa/es-extensions 1.9.0-alpha.4 → 1.9.1

package/Distributable/cjs/AJAX/AJAX_Service.js

@@ -139,7 +139,7 @@ class AJAX_Service {
                 Logger_1.default.throwErrorWithFormattedMessage({
                     errorInstance: new InvalidConfigError_1.default({
                         customMessage: "The \"alternatingURI_PathPart\" has been specified while the static field " +
-                            "\"API_SERVER_URI_CONSTANT_PART\" has not been set."
+                            "\"API_SERVER_URI_CONSTANT_PART__WITHOUT_TRAILING_SLASH\" has not been set."
                     }),
                     title: InvalidConfigError_1.default.localization.defaultTitle,
                     occurrenceLocation: "AJAX_Service.normalizeURI_UntilPath(URI_PathRawDefinition)"

package/Distributable/cjs/Numbers/isStringifiedNonNegativeIntegerOfRegularNotation.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = isStringifiedNonNegativeIntegerOfRegularNotation;
 function isStringifiedNonNegativeIntegerOfRegularNotation(value) {
-    return (/^[1-9]\d*$/u).test(value);
+    return (/^(?:0|^[1-9]\d*)$/u).test(value);
 }

package/Distributable/cjs/Objects/getObjectPropertySafely.js

@@ -9,44 +9,46 @@ const Logger_1 = __importDefault(require("../Logging/Logger"));
 const InvalidParameterValueError_1 = __importDefault(require("../Errors/InvalidParameterValue/InvalidParameterValueError"));
 const isNonEmptyString_1 = __importDefault(require("../TypeGuards/Strings/isNonEmptyString"));
 const isArbitraryObject_1 = __importDefault(require("../TypeGuards/Objects/isArbitraryObject"));
+const isNaturalNumberOrZero_1 = __importDefault(require("../TypeGuards/Numbers/isNaturalNumberOrZero"));
 function getObjectPropertySafely(targetObject, dotSeparatedOrArrayedPathToTargetProperty) {
-    if (!(0, isNonEmptyString_1.default)(dotSeparatedOrArrayedPathToTargetProperty) &&
-        (!Array.isArray(dotSeparatedOrArrayedPathToTargetProperty) ||
-            dotSeparatedOrArrayedPathToTargetProperty.some((key) => !(0, isNonEmptyString_1.default)(key)))) {
-        Logger_1.default.logError({
-            errorType: InvalidParameterValueError_1.default.NAME,
-            title: InvalidParameterValueError_1.default.localization.defaultTitle,
-            description: InvalidParameterValueError_1.default.localization.generateDescription({
-                parameterNumber: 2,
-                parameterName: "dotSeparatedOrArrayedPathToTargetProperty",
-                messageSpecificPart: "This parameter must be either non-empty string or array of non-empty strings."
-            }),
-            occurrenceLocation: "getObjectPropertySafely(targetObject, dotSeparatedOrArrayedPathToTargetProperty)"
-        });
-        return;
-    }
     if (!(0, isArbitraryObject_1.default)(targetObject)) {
         return;
     }
     let targetPropertyPathSegments;
-    if (Array.isArray(dotSeparatedOrArrayedPathToTargetProperty)) {
+    if (Array.isArray(dotSeparatedOrArrayedPathToTargetProperty) &&
+        dotSeparatedOrArrayedPathToTargetProperty.length > 0 &&
+        dotSeparatedOrArrayedPathToTargetProperty.
+            every((key) => (0, isNonEmptyString_1.default)(key) || (0, isNaturalNumberOrZero_1.default)(key))) {
         targetPropertyPathSegments = dotSeparatedOrArrayedPathToTargetProperty;
     }
-    else {
+    else if ((0, isNaturalNumberOrZero_1.default)(dotSeparatedOrArrayedPathToTargetProperty)) {
+        targetPropertyPathSegments = [String(dotSeparatedOrArrayedPathToTargetProperty)];
+    }
+    else if ((0, isNonEmptyString_1.default)(dotSeparatedOrArrayedPathToTargetProperty)) {
         targetPropertyPathSegments = (0, splitString_1.default)(dotSeparatedOrArrayedPathToTargetProperty, ".");
     }
-    if (targetPropertyPathSegments.length === 0) {
+    else {
+        Logger_1.default.throwErrorWithFormattedMessage({
+            errorInstance: new InvalidParameterValueError_1.default({
+                parameterNumber: 2,
+                parameterName: "dotSeparatedOrArrayedPathToTargetProperty",
+                messageSpecificPart: "This parameter must be either a non-empty string, or a non-negative integer, or a non-empty array " +
+                    "of strings and/or non-negative integers."
+            }),
+            title: InvalidParameterValueError_1.default.localization.defaultTitle,
+            occurrenceLocation: "getObjectPropertySafely(targetObject, dotSeparatedOrArrayedPathToTargetProperty)"
+        });
         return;
     }
     let objectOfCurrentDepthLevel = targetObject;
-    for (let depthLevel = 1; depthLevel <= targetPropertyPathSegments.length; depthLevel++) {
-        const isLastDepthLevel = depthLevel === targetPropertyPathSegments.length;
-        const valueOfNextDepthLevel = objectOfCurrentDepthLevel[targetPropertyPathSegments[depthLevel - 1]];
+    for (let depthLevel__numerationFrom1 = 1; depthLevel__numerationFrom1 <= targetPropertyPathSegments.length; depthLevel__numerationFrom1++) {
+        const isLastDepthLevel = depthLevel__numerationFrom1 === targetPropertyPathSegments.length;
+        const valueOfCurrentDepthLevel = objectOfCurrentDepthLevel[targetPropertyPathSegments[depthLevel__numerationFrom1 - 1]];
         if (isLastDepthLevel) {
-            return valueOfNextDepthLevel;
+            return valueOfCurrentDepthLevel;
         }
-        else if ((0, isArbitraryObject_1.default)(valueOfNextDepthLevel)) {
-            objectOfCurrentDepthLevel = valueOfNextDepthLevel;
+        else if ((0, isArbitraryObject_1.default)(valueOfCurrentDepthLevel)) {
+            objectOfCurrentDepthLevel = valueOfCurrentDepthLevel;
         }
         else {
             return;

package/Distributable/cjs/Objects/setObjectProperties.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = setObjectProperties;
+const splitString_1 = __importDefault(require("../Strings/splitString"));
+const isNonNullObject_1 = __importDefault(require("../TypeGuards/Objects/isNonNullObject"));
+const isUndefined_1 = __importDefault(require("../TypeGuards/EmptyTypes/isUndefined"));
+const isStringifiedNonNegativeIntegerOfRegularNotation_1 = __importDefault(require("../Numbers/isStringifiedNonNegativeIntegerOfRegularNotation"));
+function setObjectProperties(targetObject, order) {
+    for (const [fullyQualifiedName, propertyDescriptor] of Object.entries(order)) {
+        const targetPropertyPathSegments = (0, splitString_1.default)(fullyQualifiedName, ".");
+        let objectOfCurrentDepthLevel = targetObject;
+        for (let depthLevel__numerationFrom1 = 1; depthLevel__numerationFrom1 <= targetPropertyPathSegments.length; depthLevel__numerationFrom1++) {
+            const isLastDepthLevel = depthLevel__numerationFrom1 === targetPropertyPathSegments.length;
+            const propertyKeyForCurrentDepthLevel = targetPropertyPathSegments[depthLevel__numerationFrom1 - 1];
+            let valueOfNextDepthLevel = Reflect.get(objectOfCurrentDepthLevel, propertyKeyForCurrentDepthLevel);
+            if (isLastDepthLevel) {
+                if ((0, isNonNullObject_1.default)(objectOfCurrentDepthLevel)) {
+                    Object.defineProperty(objectOfCurrentDepthLevel, propertyKeyForCurrentDepthLevel, {
+                        value: propertyDescriptor.value,
+                        enumerable: propertyDescriptor.enumerable ?? true,
+                        configurable: propertyDescriptor.configurable ?? true,
+                        writable: propertyDescriptor.writable ?? true
+                    });
+                }
+                else {
+                    return;
+                }
+            }
+            else if ((0, isNonNullObject_1.default)(valueOfNextDepthLevel)) {
+                objectOfCurrentDepthLevel = valueOfNextDepthLevel;
+            }
+            else if ((0, isUndefined_1.default)(valueOfNextDepthLevel) && propertyDescriptor.mustCreateParentsObjectsIfNotPresent === true) {
+                const propertyKeyForNextDepthLevel = targetPropertyPathSegments[depthLevel__numerationFrom1];
+                valueOfNextDepthLevel = (0, isStringifiedNonNegativeIntegerOfRegularNotation_1.default)(propertyKeyForNextDepthLevel) ? [] : {};
+                Object.defineProperty(objectOfCurrentDepthLevel, propertyKeyForCurrentDepthLevel, {
+                    value: valueOfNextDepthLevel,
+                    enumerable: true,
+                    configurable: true,
+                    writable: true
+                });
+                objectOfCurrentDepthLevel = valueOfNextDepthLevel;
+            }
+            else {
+                return;
+            }
+        }
+    }
+}

package/Distributable/cjs/RawObjectDataProcessor/RawObjectDataProcessor.js

@@ -30,6 +30,8 @@ const isEitherUndefinedOrNull_1 = __importDefault(require("../TypeGuards/EmptyTy
 const isNeitherUndefinedNorNull_1 = __importDefault(require("../TypeGuards/EmptyTypes/isNeitherUndefinedNorNull"));
 const emptyStringToNull_1 = __importDefault(require("../ValueTransformers/emptyStringToNull"));
 const getLastElementOfArray_1 = __importDefault(require("../Arrays/01-RetrievingOfElements/getLastElementOfArray"));
+const ValuesDeepCopier_1 = __importDefault(require("../ValuesDeepCopier"));
+const getObjectPropertySafely_1 = __importDefault(require("../Objects/getObjectPropertySafely"));
 class RawObjectDataProcessor {
     static defaultLocalization = RawObjectDataProcessorLocalization_english_1.default;
     rawData;
@@ -37,8 +39,9 @@ class RawObjectDataProcessor {
     localization;
     errorHandlingStrategies;
     validationErrorsMessages = [];
-    currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging = [];
+    currentlyIteratedPropertyQualifiedInitialNameSegments = [];
     currentlyIteratedPropertyNewNamesByDepthLevelsForLogging = [];
+    initialObjectSnapshot;
     static process(rawData, validDataSpecification, options = {}) {
         const localization = options.localization ?? RawObjectDataProcessor.defaultLocalization;
         if (typeof rawData !== "object") {
@@ -155,6 +158,15 @@ class RawObjectDataProcessor {
             onUnableToUpdatePropertyValue: errorHandlingStrategies.onUnableToUpdatePropertyValue ??
                 RawObjectDataProcessor.ErrorHandlingStrategies.throwingOfError
         };
+        switch (this.processingApproach) {
+            case RawObjectDataProcessor.ProcessingApproaches.assemblingOfNewObject: {
+                this.initialObjectSnapshot = this.rawData;
+                break;
+            }
+            case RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject: {
+                this.initialObjectSnapshot = null;
+            }
+        }
     }
     processFixedSchemaObjectTypeValue({ targetObjectTypeValueSpecification, parentObject, targetPropertyStringifiedValueBeforeFirstPreValidationModification, ...compoundParameter }) {
         let targetObjectTypeSourceValue;
@@ -186,7 +198,7 @@ class RawObjectDataProcessor {
         }
         let processedValueWorkpiece = this.processingApproach === RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject ?
             targetObjectTypeSourceValue : {};
-        const currentObjectDepthLevel__countFromZero = this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.length;
+        const currentObjectDepthLevel__countFromZero = this.currentlyIteratedPropertyQualifiedInitialNameSegments.length;
         const initialNamesOfNotCheckedYetProperties = new Set(Object.keys(targetObjectTypeSourceValue));
         let hasAtLeastOneInvalidPropertyBeenDetected = false;
         let hasAllChildrenPropertiesValuesDefinitelyNotChanged = true;
@@ -199,7 +211,8 @@ class RawObjectDataProcessor {
                 if (possibleSchema.actualIf({
                     rawData__currentObjectDepth: targetObjectTypeSourceValue,
                     rawData__full: this.rawData,
-                    targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName
+                    targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName,
+                    targetPropertyPathSegments: [...this.currentlyIteratedPropertyQualifiedInitialNameSegments]
                 })) {
                     propertiesSpecification = possibleSchema.properties;
                     break;
@@ -220,11 +233,13 @@ class RawObjectDataProcessor {
         }
         for (const [childPropertyInitialName, childPropertySpecification] of Object.entries(propertiesSpecification)) {
             initialNamesOfNotCheckedYetProperties.delete(childPropertyInitialName);
-            this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging[currentObjectDepthLevel__countFromZero] = childPropertyInitialName;
+            this.currentlyIteratedPropertyQualifiedInitialNameSegments[currentObjectDepthLevel__countFromZero] =
+                childPropertyInitialName;
             let childPropertyFinalName;
             if ((0, isUndefined_1.default)(childPropertySpecification.newName)) {
                 childPropertyFinalName = childPropertyInitialName;
                 this.currentlyIteratedPropertyNewNamesByDepthLevelsForLogging[currentObjectDepthLevel__countFromZero] = null;
+                this.createInitialObjectSnapshotIfNotCreatedYet();
             }
             else {
                 childPropertyFinalName = childPropertySpecification.newName;
@@ -257,6 +272,7 @@ class RawObjectDataProcessor {
                     (0, ArbitraryValueFormatter_1.stringifyAndFormatArbitraryValue)(childPropertyMutableValue);
                 hasChildPropertyValueDefinitelyNotChanged = false;
                 hasAllChildrenPropertiesValuesDefinitelyNotChanged = false;
+                this.createInitialObjectSnapshotIfNotCreatedYet();
             }
             for (const preValidationModification of preValidationModifications) {
                 try {
@@ -301,10 +317,25 @@ class RawObjectDataProcessor {
                     continue;
                 }
                 if ((0, isNotUndefined_1.default)(childPropertySpecification.undefinedForbiddenIf)) {
+                    const rawData__full = this.createInitialObjectSnapshotIfNotCreatedYet();
+                    let rawData__currentObjectDepth;
+                    switch (this.processingApproach) {
+                        case RawObjectDataProcessor.ProcessingApproaches.assemblingOfNewObject: {
+                            rawData__currentObjectDepth = targetObjectTypeSourceValue;
+                            break;
+                        }
+                        case RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject: {
+                            rawData__currentObjectDepth =
+                                this.currentlyIteratedPropertyQualifiedInitialNameSegments.length > 1 ?
+                                    (0, getObjectPropertySafely_1.default)(rawData__full, this.currentlyIteratedPropertyQualifiedInitialNameSegments.slice(0, -1)) :
+                                    rawData__full;
+                        }
+                    }
                     if (childPropertySpecification.undefinedForbiddenIf.predicate({
-                        rawData__currentObjectDepth: targetObjectTypeSourceValue,
-                        rawData__full: this.rawData,
-                        targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName
+                        rawData__full,
+                        rawData__currentObjectDepth,
+                        targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName,
+                        targetPropertyPathSegments: [...this.currentlyIteratedPropertyQualifiedInitialNameSegments]
                     })) {
                         hasAtLeastOneInvalidPropertyBeenDetected = true;
                         this.registerValidationError({
@@ -324,30 +355,47 @@ class RawObjectDataProcessor {
                     }
                 }
                 else if ((0, isNotUndefined_1.default)(childPropertySpecification.undefinedValueSubstitution)) {
+                    this.createInitialObjectSnapshotIfNotCreatedYet();
                     childPropertyMutableValue = childPropertySpecification.undefinedValueSubstitution;
                     hasChildPropertyValueDefinitelyNotChanged = false;
                     hasAllChildrenPropertiesValuesDefinitelyNotChanged = false;
                 }
             }
-            else if ("mustBeUndefinedIf" in childPropertySpecification &&
-                childPropertySpecification.mustBeUndefinedIf?.predicate({
-                    rawData__currentObjectDepth: targetObjectTypeSourceValue,
-                    rawData__full: this.rawData,
-                    targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName
+            else if ("mustBeUndefinedIf" in childPropertySpecification) {
+                const rawData__full = this.createInitialObjectSnapshotIfNotCreatedYet();
+                let rawData__currentObjectDepth;
+                switch (this.processingApproach) {
+                    case RawObjectDataProcessor.ProcessingApproaches.assemblingOfNewObject: {
+                        rawData__currentObjectDepth = targetObjectTypeSourceValue;
+                        break;
+                    }
+                    case RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject: {
+                        rawData__currentObjectDepth =
+                            this.currentlyIteratedPropertyQualifiedInitialNameSegments.length > 1 ?
+                                (0, getObjectPropertySafely_1.default)(rawData__full, this.currentlyIteratedPropertyQualifiedInitialNameSegments.slice(0, -1)) :
+                                rawData__full;
+                    }
+                }
+                if (childPropertySpecification.mustBeUndefinedIf?.predicate({
+                    rawData__currentObjectDepth,
+                    rawData__full,
+                    targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName,
+                    targetPropertyPathSegments: [...this.currentlyIteratedPropertyQualifiedInitialNameSegments]
                 }) === true) {
-                this.registerValidationError({
-                    title: this.localization.validationErrors.conditionallyForbiddenNonUndefinedValue.title,
-                    description: this.localization.validationErrors.conditionallyForbiddenNonUndefinedValue.generateDescription({
-                        verbalConditionWhenMustBeUndefinedWithoutEndOfSentenceMark: childPropertySpecification.mustBeUndefinedIf.descriptionForLogging
-                    }),
-                    targetPropertyDotSeparatedQualifiedInitialName: this.currentObjectPropertyDotSeparatedQualifiedName,
-                    targetPropertyNewName: childPropertySpecification.newName ?? null,
-                    targetPropertyValue: childPropertyMutableValue,
-                    targetPropertyValueSpecification: childPropertySpecification,
-                    targetPropertyStringifiedValueBeforeFirstPreValidationModification: childPropertyStringifiedValueBeforeFirstPreValidationModification,
-                    documentationPageAnchor: "VALIDATION_ERRORS_MESSAGES-CONDITIONALLY_FORBIDDEN_NON_UNDEFINED_VALUE"
-                });
-                continue;
+                    this.registerValidationError({
+                        title: this.localization.validationErrors.conditionallyForbiddenNonUndefinedValue.title,
+                        description: this.localization.validationErrors.conditionallyForbiddenNonUndefinedValue.generateDescription({
+                            verbalConditionWhenMustBeUndefinedWithoutEndOfSentenceMark: childPropertySpecification.mustBeUndefinedIf.descriptionForLogging
+                        }),
+                        targetPropertyDotSeparatedQualifiedInitialName: this.currentObjectPropertyDotSeparatedQualifiedName,
+                        targetPropertyNewName: childPropertySpecification.newName ?? null,
+                        targetPropertyValue: childPropertyMutableValue,
+                        targetPropertyValueSpecification: childPropertySpecification,
+                        targetPropertyStringifiedValueBeforeFirstPreValidationModification: childPropertyStringifiedValueBeforeFirstPreValidationModification,
+                        documentationPageAnchor: "VALIDATION_ERRORS_MESSAGES-CONDITIONALLY_FORBIDDEN_NON_UNDEFINED_VALUE"
+                    });
+                    continue;
+                }
             }
             if (!(0, isBoolean_1.default)(childPropertySpecification.isNullForbidden) &&
                 (0, isUndefined_1.default)(childPropertySpecification.nullForbiddenIf) &&
@@ -379,10 +427,25 @@ class RawObjectDataProcessor {
                     continue;
                 }
                 if ((0, isNotUndefined_1.default)(childPropertySpecification.nullForbiddenIf)) {
+                    const rawData__full = this.createInitialObjectSnapshotIfNotCreatedYet();
+                    let rawData__currentObjectDepth;
+                    switch (this.processingApproach) {
+                        case RawObjectDataProcessor.ProcessingApproaches.assemblingOfNewObject: {
+                            rawData__currentObjectDepth = targetObjectTypeSourceValue;
+                            break;
+                        }
+                        case RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject: {
+                            rawData__currentObjectDepth =
+                                this.currentlyIteratedPropertyQualifiedInitialNameSegments.length > 1 ?
+                                    (0, getObjectPropertySafely_1.default)(rawData__full, this.currentlyIteratedPropertyQualifiedInitialNameSegments.slice(0, -1)) :
+                                    rawData__full;
+                        }
+                    }
                     if (childPropertySpecification.nullForbiddenIf.predicate({
-                        rawData__currentObjectDepth: targetObjectTypeSourceValue,
-                        rawData__full: this.rawData,
-                        targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName
+                        rawData__full,
+                        rawData__currentObjectDepth,
+                        targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName,
+                        targetPropertyPathSegments: [...this.currentlyIteratedPropertyQualifiedInitialNameSegments]
                     })) {
                         hasAtLeastOneInvalidPropertyBeenDetected = true;
                         this.registerValidationError({
@@ -402,30 +465,47 @@ class RawObjectDataProcessor {
                     }
                 }
                 else if ((0, isNotUndefined_1.default)(childPropertySpecification.nullValueSubstitution)) {
+                    this.createInitialObjectSnapshotIfNotCreatedYet();
                     childPropertyMutableValue = childPropertySpecification.nullValueSubstitution;
                     hasChildPropertyValueDefinitelyNotChanged = false;
                     hasAllChildrenPropertiesValuesDefinitelyNotChanged = false;
                 }
             }
-            else if ("mustBeNullIf" in childPropertySpecification &&
-                childPropertySpecification.mustBeNullIf?.predicate({
-                    rawData__currentObjectDepth: targetObjectTypeSourceValue,
-                    rawData__full: this.rawData,
-                    targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName
+            else if ("mustBeNullIf" in childPropertySpecification) {
+                const rawData__full = this.createInitialObjectSnapshotIfNotCreatedYet();
+                let rawData__currentObjectDepth;
+                switch (this.processingApproach) {
+                    case RawObjectDataProcessor.ProcessingApproaches.assemblingOfNewObject: {
+                        rawData__currentObjectDepth = targetObjectTypeSourceValue;
+                        break;
+                    }
+                    case RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject: {
+                        rawData__currentObjectDepth =
+                            this.currentlyIteratedPropertyQualifiedInitialNameSegments.length > 1 ?
+                                (0, getObjectPropertySafely_1.default)(rawData__full, this.currentlyIteratedPropertyQualifiedInitialNameSegments.slice(0, -1).join(".")) :
+                                rawData__full;
+                    }
+                }
+                if (childPropertySpecification.mustBeNullIf?.predicate({
+                    rawData__currentObjectDepth,
+                    rawData__full,
+                    targetPropertyDotSeparatedPath: this.currentObjectPropertyDotSeparatedQualifiedName,
+                    targetPropertyPathSegments: [...this.currentlyIteratedPropertyQualifiedInitialNameSegments]
                 }) === true) {
-                this.registerValidationError({
-                    title: this.localization.validationErrors.conditionallyForbiddenNonNullValue.title,
-                    description: this.localization.validationErrors.conditionallyForbiddenNonNullValue.generateDescription({
-                        verbalConditionWhenMustBeNullWithoutEndOfSentenceMark: childPropertySpecification.mustBeNullIf.descriptionForLogging
-                    }),
-                    targetPropertyDotSeparatedQualifiedInitialName: this.currentObjectPropertyDotSeparatedQualifiedName,
-                    targetPropertyNewName: childPropertySpecification.newName ?? null,
-                    targetPropertyValue: childPropertyMutableValue,
-                    targetPropertyValueSpecification: childPropertySpecification,
-                    targetPropertyStringifiedValueBeforeFirstPreValidationModification: childPropertyStringifiedValueBeforeFirstPreValidationModification,
-                    documentationPageAnchor: "VALIDATION_ERRORS_MESSAGES-CONDITIONALLY_FORBIDDEN_NON_NULL_VALUE"
-                });
-                continue;
+                    this.registerValidationError({
+                        title: this.localization.validationErrors.conditionallyForbiddenNonNullValue.title,
+                        description: this.localization.validationErrors.conditionallyForbiddenNonNullValue.generateDescription({
+                            verbalConditionWhenMustBeNullWithoutEndOfSentenceMark: childPropertySpecification.mustBeNullIf.descriptionForLogging
+                        }),
+                        targetPropertyDotSeparatedQualifiedInitialName: this.currentObjectPropertyDotSeparatedQualifiedName,
+                        targetPropertyNewName: childPropertySpecification.newName ?? null,
+                        targetPropertyValue: childPropertyMutableValue,
+                        targetPropertyValueSpecification: childPropertySpecification,
+                        targetPropertyStringifiedValueBeforeFirstPreValidationModification: childPropertyStringifiedValueBeforeFirstPreValidationModification,
+                        documentationPageAnchor: "VALIDATION_ERRORS_MESSAGES-CONDITIONALLY_FORBIDDEN_NON_NULL_VALUE"
+                    });
+                    continue;
+                }
             }
             if ((0, isNeitherUndefinedNorNull_1.default)(childPropertyMutableValue)) {
                 const childPropertyValueProcessingResult = this.processSingleNeitherUndefinedNorNullValue({
@@ -608,7 +688,7 @@ class RawObjectDataProcessor {
                 }
             }
         }
-        this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.splice(-1, 1);
+        this.currentlyIteratedPropertyQualifiedInitialNameSegments.splice(-1, 1);
         this.currentlyIteratedPropertyNewNamesByDepthLevelsForLogging.splice(-1, 1);
         if (targetObjectTypeValueSpecification.mustExpectOnlySpecifiedProperties === true &&
             initialNamesOfNotCheckedYetProperties.size > 0) {
@@ -654,8 +734,12 @@ class RawObjectDataProcessor {
         else if (this.isValidationOnlyMode) {
             return { thisOneIsValidButPostProcessingDisabledForPerformanceBecauseDataIsInvalidInLarge: true };
         }
-        for (const postValidationModification of RawObjectDataProcessor.
-            getNormalizedPostValidationModifications(targetObjectTypeValueSpecification.postValidationModifications)) {
+        const normalizedPostValidationModifications = RawObjectDataProcessor.
+            getNormalizedPostValidationModifications(targetObjectTypeValueSpecification.postValidationModifications);
+        if (normalizedPostValidationModifications.length > 0) {
+            this.createInitialObjectSnapshotIfNotCreatedYet();
+        }
+        for (const postValidationModification of normalizedPostValidationModifications) {
             processedValueWorkpiece = postValidationModification(processedValueWorkpiece);
         }
         for (const keyOfPropertyWhichWillBeDeleted of targetObjectTypeValueSpecification.propertiesWillBeDeletedAfterPostValidationModifications ?? []) {
@@ -775,7 +859,7 @@ class RawObjectDataProcessor {
         }
         let processedValueWorkpiece = this.processingApproach === RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject ?
             targetObjectTypeSourceValue : {};
-        const currentObjectDepthLevel__countFromZero = this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.length;
+        const currentObjectDepthLevel__countFromZero = this.currentlyIteratedPropertyQualifiedInitialNameSegments.length;
         let hasAtLeastOneInvalidValueBeenDetected = false;
         const forbiddenKeys = targetAssociativeArrayTypeValueSpecification.forbiddenKeys ?? [];
         let allowedKeys;
@@ -800,8 +884,7 @@ class RawObjectDataProcessor {
         let hasAllEntriesDefinitelyNotChanged = true;
         const foundDisallowedKeys = [];
         for (const [initialKey, rawValue] of Object.entries(targetObjectTypeSourceValue)) {
-            this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging[currentObjectDepthLevel__countFromZero] =
-                initialKey;
+            this.currentlyIteratedPropertyQualifiedInitialNameSegments[currentObjectDepthLevel__countFromZero] = initialKey;
             if (!allowedKeys.includes(initialKey)) {
                 foundDisallowedKeys.push(initialKey);
             }
@@ -810,8 +893,9 @@ class RawObjectDataProcessor {
             if ((0, isNotNull_1.default)(newNameOfKey)) {
                 this.currentlyIteratedPropertyNewNamesByDepthLevelsForLogging[currentObjectDepthLevel__countFromZero] =
                     newNameOfKey;
+                this.createInitialObjectSnapshotIfNotCreatedYet();
             }
-            if (hasAllEntriesDefinitelyNotChanged && finalKey !== initialKey) {
+            if (hasAllEntriesDefinitelyNotChanged && (0, isNotNull_1.default)(newNameOfKey)) {
                 hasAllEntriesDefinitelyNotChanged = false;
             }
             let hasValueDefinitelyNotChanged = true;
@@ -828,6 +912,7 @@ class RawObjectDataProcessor {
                 stringifiedValueBeforeFirstPreValidationModification = (0, ArbitraryValueFormatter_1.stringifyAndFormatArbitraryValue)(mutableValue);
                 hasValueDefinitelyNotChanged = false;
                 hasAllEntriesDefinitelyNotChanged = false;
+                this.createInitialObjectSnapshotIfNotCreatedYet();
             }
             for (const preValidationModification of preValidationModifications) {
                 try {
@@ -963,7 +1048,7 @@ class RawObjectDataProcessor {
                 }
             }
         }
-        this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.splice(-1, 1);
+        this.currentlyIteratedPropertyQualifiedInitialNameSegments.splice(-1, 1);
         this.currentlyIteratedPropertyNewNamesByDepthLevelsForLogging.splice(-1, 1);
         if (foundDisallowedKeys.length > 0) {
             hasTargetAssociativeArraySpecificEntryIndependentViolations = true;
@@ -1007,8 +1092,12 @@ class RawObjectDataProcessor {
         else if (this.isValidationOnlyMode) {
             return { thisOneIsValidButPostProcessingDisabledForPerformanceBecauseDataIsInvalidInLarge: true };
         }
-        for (const postValidationModification of RawObjectDataProcessor.
-            getNormalizedPostValidationModifications(targetAssociativeArrayTypeValueSpecification.postValidationModifications)) {
+        const normalizedPostValidationModifications = RawObjectDataProcessor.
+            getNormalizedPostValidationModifications(targetAssociativeArrayTypeValueSpecification.postValidationModifications);
+        if (normalizedPostValidationModifications.length > 0) {
+            this.createInitialObjectSnapshotIfNotCreatedYet();
+        }
+        for (const postValidationModification of normalizedPostValidationModifications) {
             processedValueWorkpiece = postValidationModification(processedValueWorkpiece);
         }
         return {
@@ -1118,12 +1207,11 @@ class RawObjectDataProcessor {
         }
         let processedValueWorkpiece = this.processingApproach === RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject ?
             targetArrayedTypeSourceValue : [];
-        const currentObjectDepthLevel__beginWithZero = this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.length;
+        const currentObjectDepthLevel__beginWithZero = this.currentlyIteratedPropertyQualifiedInitialNameSegments.length;
         let hasAtLeastOneInvalidElementBeenDetected = false;
         let hasAllElementsDefinitelyNotChanged = true;
         for (const [index, rawElement] of targetArrayedTypeSourceValue.entries()) {
-            this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging[currentObjectDepthLevel__beginWithZero] =
-                index;
+            this.currentlyIteratedPropertyQualifiedInitialNameSegments[currentObjectDepthLevel__beginWithZero] = index;
             let hasElementDefinitelyNotChanged = true;
             const preValidationModifications = RawObjectDataProcessor.
                 getNormalizedPreValidationModifications({
@@ -1138,6 +1226,7 @@ class RawObjectDataProcessor {
                 stringifiedElementBeforeFirstPreValidationModification = (0, ArbitraryValueFormatter_1.stringifyAndFormatArbitraryValue)(mutableElement);
                 hasElementDefinitelyNotChanged = false;
                 hasAllElementsDefinitelyNotChanged = false;
+                this.createInitialObjectSnapshotIfNotCreatedYet();
             }
             for (const preValidationModification of preValidationModifications) {
                 try {
@@ -1217,7 +1306,7 @@ class RawObjectDataProcessor {
                 }
             }
         }
-        this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.splice(-1, 1);
+        this.currentlyIteratedPropertyQualifiedInitialNameSegments.splice(-1, 1);
         for (const customValidator of RawObjectDataProcessor.getNormalizedCustomValidators(targetIndexedArrayTypeValueSpecification.customValidators)) {
             if (!customValidator.validationFunction({
                 value: targetArrayedTypeSourceValue,
@@ -1246,8 +1335,12 @@ class RawObjectDataProcessor {
         else if (this.isValidationOnlyMode) {
             return { thisOneIsValidButPostProcessingDisabledForPerformanceBecauseDataIsInvalidInLarge: true };
         }
-        for (const postValidationModification of RawObjectDataProcessor.
-            getNormalizedPostValidationModifications(targetIndexedArrayTypeValueSpecification.postValidationModifications)) {
+        const normalizedPostValidationModifications = RawObjectDataProcessor.
+            getNormalizedPostValidationModifications(targetIndexedArrayTypeValueSpecification.postValidationModifications);
+        if (normalizedPostValidationModifications.length > 0) {
+            this.createInitialObjectSnapshotIfNotCreatedYet();
+        }
+        for (const postValidationModification of normalizedPostValidationModifications) {
             processedValueWorkpiece = postValidationModification(processedValueWorkpiece);
         }
         return {
@@ -1322,13 +1415,12 @@ class RawObjectDataProcessor {
         }
         let processedValueWorkpiece = this.processingApproach === RawObjectDataProcessor.ProcessingApproaches.manipulationsWithSourceObject ?
             targetArrayedTypeSourceValue : [];
-        const currentObjectDepthLevel__beginWithZero = this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.length;
+        const currentObjectDepthLevel__beginWithZero = this.currentlyIteratedPropertyQualifiedInitialNameSegments.length;
         let hasAtLeastOneInvalidElementBeenDetected = false;
         let hasAllElementsDefinitelyNotChanged = true;
         for (const [elementStringifiedIndex, elementSpecification] of Object.entries(targetTupleTypeValueSpecification.elements)) {
             const elementIndex = Number.parseInt(elementStringifiedIndex, 10);
-            this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging[currentObjectDepthLevel__beginWithZero] =
-                elementIndex;
+            this.currentlyIteratedPropertyQualifiedInitialNameSegments[currentObjectDepthLevel__beginWithZero] = elementIndex;
             let hasElementDefinitelyNotChanged = true;
             const preValidationModifications = RawObjectDataProcessor.
                 getNormalizedPreValidationModifications({
@@ -1342,6 +1434,7 @@ class RawObjectDataProcessor {
                 stringifiedElementBeforeFirstPreValidationModification = (0, ArbitraryValueFormatter_1.stringifyAndFormatArbitraryValue)(mutableElement);
                 hasElementDefinitelyNotChanged = false;
                 hasAllElementsDefinitelyNotChanged = false;
+                this.createInitialObjectSnapshotIfNotCreatedYet();
             }
             for (const preValidationModification of preValidationModifications) {
                 try {
@@ -1546,7 +1639,7 @@ class RawObjectDataProcessor {
                 }
             }
         }
-        this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.splice(-1, 1);
+        this.currentlyIteratedPropertyQualifiedInitialNameSegments.splice(-1, 1);
         for (const customValidator of RawObjectDataProcessor.getNormalizedCustomValidators(targetTupleTypeValueSpecification.customValidators)) {
             if (!customValidator.validationFunction({
                 value: targetArrayedTypeSourceValue,
@@ -1575,8 +1668,12 @@ class RawObjectDataProcessor {
         else if (this.isValidationOnlyMode) {
             return { thisOneIsValidButPostProcessingDisabledForPerformanceBecauseDataIsInvalidInLarge: true };
         }
-        for (const postValidationModification of RawObjectDataProcessor.
-            getNormalizedPostValidationModifications(targetTupleTypeValueSpecification.postValidationModifications)) {
+        const normalizedPostValidationModifications = RawObjectDataProcessor.
+            getNormalizedPostValidationModifications(targetTupleTypeValueSpecification.postValidationModifications);
+        if (normalizedPostValidationModifications.length > 0) {
+            this.createInitialObjectSnapshotIfNotCreatedYet();
+        }
+        for (const postValidationModification of normalizedPostValidationModifications) {
             processedValueWorkpiece = postValidationModification(processedValueWorkpiece);
         }
         return {
@@ -1961,7 +2058,7 @@ class RawObjectDataProcessor {
                 description: this.localization.validationErrors.valueTypeDoesNotMatchWithExpected.
                     generateDescription({
                     actualNativeType: typeof targetValue__expectedToBeString,
-                    expectedTypeID: RawObjectDataProcessor.ValuesTypesIDs.number
+                    expectedTypeID: RawObjectDataProcessor.ValuesTypesIDs.string
                 }),
                 targetPropertyDotSeparatedQualifiedInitialName: this.currentObjectPropertyDotSeparatedQualifiedName,
                 targetPropertyNewName: (0, getLastElementOfArray_1.default)(this.currentlyIteratedPropertyNewNamesByDepthLevelsForLogging),
@@ -2292,11 +2389,18 @@ class RawObjectDataProcessor {
         });
     }
     get currentObjectPropertyDotSeparatedQualifiedName() {
-        return this.currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging.join(".");
+        return this.currentlyIteratedPropertyQualifiedInitialNameSegments.join(".");
     }
     registerValidationError(payload) {
         this.validationErrorsMessages.push(RawObjectDataProcessor.generateValidationErrorMessage(payload, this.localization));
     }
+    createInitialObjectSnapshotIfNotCreatedYet() {
+        if (this.processingApproach === RawObjectDataProcessor.ProcessingApproaches.assemblingOfNewObject) {
+            return this.rawData;
+        }
+        return this.initialObjectSnapshot ??
+            (this.initialObjectSnapshot = ValuesDeepCopier_1.default.deeplyCloneObjectLikeValueAsPossible(this.rawData));
+    }
     handleFailedPreValidationModification({ error, propertyOrElementMutableValue, propertyOrElementValueSpecification, propertyOrElementStringifiedValueBeforeFirstPreValidationModification, occurrenceMethodName }) {
         switch (this.errorHandlingStrategies.onPreValidationModificationFailed) {
             case RawObjectDataProcessor.ErrorHandlingStrategies.throwingOfError: {