@yamato-daiwa/es-extensions 1.8.7 → 1.8.8

package/Distributable/cjs/RawObjectDataProcessor/RawObjectDataProcessorLocalization.english.js

@@ -53,9 +53,7 @@ const rawObjectDataProcessorLocalization__english = {
         preValidationModificationFailed: {
             title: "Pre-validation Modification Failed",
             generateDescription: ({ stringifiedCaughtError }) => "The following error has occurred during the pre-validation modification of this property/element. \n" +
-                `${stringifiedCaughtError}\n` +
-                "The data has been marked as invalid because the error handling strategy \"onPreValidationModificationFailed\" " +
-                "is \"ErrorHandlingStrategies.markingOfDataAsInvalid\" what is not recommended. "
+                stringifiedCaughtError
         },
         forbiddenUndefinedValue: {
             title: "Forbidden Undefined Value",
@@ -112,22 +110,23 @@ const rawObjectDataProcessorLocalization__english = {
         },
         associativeArrayEntriesCountIsLessThanRequiredMinimum: {
             title: "Too Few Entries in Associative Array",
-            generateDescription: ({ actualEntriesCount, minimalEntriesCount }) => `This value of associative array has ${actualEntriesCount} entries while at least ` +
+            generateDescription: ({ actualEntriesCount, minimalEntriesCount }) => `This value of associative array type has ${actualEntriesCount} entries while at least ` +
                 `${minimalEntriesCount} expected.`
         },
         associativeArrayPairsCountIsMoreThanAllowedMaximum: {
             title: "Too Many Entries in Associative Array",
-            generateDescription: ({ maximalEntriesCount, actualEntriesCount }) => `This value of associative array has ${actualEntriesCount} entries while maximally ` +
+            generateDescription: ({ maximalEntriesCount, actualEntriesCount }) => `This value of associative array type has ${actualEntriesCount} entries while maximally ` +
                 `${maximalEntriesCount} expected.`
         },
         associativeArrayPairsCountDoesNotMatchWithSpecifiedExactNumber: {
             title: "Wrong Exact Number of Entries in Associative Array",
-            generateDescription: ({ exactEntriesCount, actualEntriesCount }) => `This value of associative array has ${exactEntriesCount} entries while exactly ${actualEntriesCount} expected.`
+            generateDescription: ({ exactEntriesCount, actualEntriesCount }) => `This value of associative array type has ${exactEntriesCount} entries while exactly ${actualEntriesCount} ` +
+                "expected."
         },
         forbiddenForSpecificKeysUndefinedOrNullValuesFoundInAssociativeArrayTypeObject: {
-            title: "Forbidden for Specific Keys Undefined or Null Values in Associative Array",
-            generateDescription: ({ keysOfEitherUndefinedOrNullValues }) => "The values of the following keys are either null or explicit undefined while for these keys such values has " +
-                "been explicitly forbidden:\n" +
+            title: "Forbidden for Specific Keys of the Associative Array Undefined or Null Values",
+            generateDescription: ({ keysOfEitherUndefinedOrNullValues }) => "The values of the following keys are either null or undefined while for these keys such values has " +
+                "been forbidden.\n" +
                 keysOfEitherUndefinedOrNullValues.
                     map((keyOfEitherUndefinedOrNullValue) => `  ● ${keyOfEitherUndefinedOrNullValue}`).
                     join("\n")
@@ -141,12 +140,12 @@ const rawObjectDataProcessorLocalization__english = {
         },
         indexedArrayElementsCountIsLessThanRequiredMinimum: {
             title: "Too Few Elements in Indexed Array",
-            generateDescription: ({ minimalElementsCount, actualElementsCount }) => `This value of indexed array has ${actualElementsCount} elements while at least ` +
+            generateDescription: ({ minimalElementsCount, actualElementsCount }) => `This value of indexed array type has ${actualElementsCount} elements while at least ` +
                 `${minimalElementsCount} expected.`
         },
         indexedArrayElementsCountIsMoreThanAllowedMaximum: {
-            title: "Indexed Array has More Elements than Expected Maximum",
-            generateDescription: ({ maximalElementsCount, actualElementsCount }) => `This value of indexed array has ${actualElementsCount} elements while maximally ` +
+            title: "Too Many Elements in Indexed Array",
+            generateDescription: ({ maximalElementsCount, actualElementsCount }) => `This value of indexed array type has ${actualElementsCount} elements while maximally ` +
                 `${maximalElementsCount} expected.`
         },
         indexedArrayOrTupleElementsCountDoesNotMatchWithSpecifiedExactNumber: {
@@ -156,24 +155,26 @@ const rawObjectDataProcessorLocalization__english = {
         },
         forbiddenNaN_Value: {
             title: "Forbidden NaN Value Of Numeric Property/Element",
-            description: "The value of this numeric property or element is NaN while it has been explicitly forbidden. "
+            description: "The value of this numeric property or element is NaN while it has not been allowed. "
         },
         numericValueIsNotBelongToExpectedNumbersSet: {
             title: "Expected and Actual Numbers Set Mismatch",
             generateDescription: ({ expectedNumberSet }) => "Contrary to expectations, this numeric value is not member of " +
-                `"${rawObjectDataProcessorLocalization__english.getLocalizedNumbersSet(expectedNumberSet)}"`
+                `"${rawObjectDataProcessorLocalization__english.getLocalizedNumbersSet(expectedNumberSet)}" number set.`
         },
         valueIsNotAmongAllowedAlternatives: {
             title: "Disallowed Alternative of Value",
             generateDescription: ({ allowedAlternatives }) => "This value is not among following allowed alternatives:\n" +
-                allowedAlternatives.map((allowedAlternative) => `  ○ ${allowedAlternative}`).join("\n")
+                allowedAlternatives.
+                    map((allowedAlternative) => `  ○ ${allowedAlternative}`).
+                    join("\n")
         },
         numericValueIsSmallerThanRequiredMinimum: {
             title: "Minimal Value Fall Short",
             generateDescription: ({ requiredMinimum }) => `This value is smaller than required minimal value ${requiredMinimum}.`
         },
         numericValueIsGreaterThanAllowedMaximum: {
-            title: "Maximal Numeric Value Exceeding",
+            title: "Maximal Value Exceeding",
             generateDescription: ({ allowedMaximum }) => `This value is greater than allowed maximal value ${allowedMaximum}.`
         },
         charactersCountIsLessThanRequired: {
@@ -186,7 +187,7 @@ const rawObjectDataProcessorLocalization__english = {
         },
         charactersCountDoesNotMatchWithSpecified: {
             title: "Fixed Characters Count Mismatch",
-            generateDescription: ({ fixedCharactersCount, realCharactersCount }) => `The value has ${realCharactersCount} characters while exactly ${fixedCharactersCount} expected.`
+            generateDescription: ({ fixedCharactersCount, realCharactersCount }) => `The value has ${realCharactersCount} characters while exactly ${fixedCharactersCount} required.`
         },
         forbiddenCharactersFound: {
             title: "Forbidden Characters",
@@ -216,47 +217,45 @@ const rawObjectDataProcessorLocalization__english = {
         mutuallyExclusiveTransformationsBetweenUndefinedAndNull: {
             title: "Mutually Exclusive Transformations Between Undefined and Null",
             generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => "Both \"mustTransformUndefinedToNull\" and \"mustTransformNullToUndefined\" options has been specified with " +
-                `boolean true value for the property "${targetPropertyDotSeparatedQualifiedName}" what is the contradiction. ` +
+                `\`true\` value for the property "${targetPropertyDotSeparatedQualifiedName}" what is the contradiction. ` +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         preValidationModificationFailed: {
             title: "Pre-validation Modification Failed",
             generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => "The error has occurred during the pre-validation modification of the property/element " +
                 `"${targetPropertyDotSeparatedQualifiedName}". ` +
-                "This error has been thrown because the error handling strategy \"onPreValidationModificationFailed\" is " +
-                "\"ErrorHandlingStrategies.throwingOfError\" which is the default one. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         propertyUndefinedabilityNotSpecified: {
             title: "Property Undefinedability has not been Specified",
             generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => "It has not been specified how to process the undefined value of the property " +
-                `\`${targetPropertyDotSeparatedQualifiedName}\`. ` +
+                `"${targetPropertyDotSeparatedQualifiedName}". ` +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         propertyNullabilityNotSpecified: {
             title: "Property Nullability has not been Specified",
             generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => "It has not been specified how to process the null value of the property " +
-                `\`${targetPropertyDotSeparatedQualifiedName}\`. ` +
+                `"${targetPropertyDotSeparatedQualifiedName}". ` +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         dataTypeNotSpecified: {
             title: "Unsupported or Not Specified Data Type",
             generateDescription: ({ targetPropertyDotSeparatedQualifiedName, specifiedStringifiedType, documentationPageAnchor }) => ((0, isUndefined_1.default)(specifiedStringifiedType) ?
-                "Data type has not been " :
-                `Unsupported data type "${specifiedStringifiedType} has been"`) +
-                `specified for property/element "${targetPropertyDotSeparatedQualifiedName}". ` +
+                "Data type has not " :
+                `Unsupported data type "${specifiedStringifiedType} has "`) +
+                `been specified for property/element "${targetPropertyDotSeparatedQualifiedName}". ` +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         unableToDeletePropertyWithOutdatedKey: {
             title: "Unable to Delete Property With Outdated Key",
-            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, propertyNewKey, documentationPageAnchor }) => `Unable to delete the property "${targetPropertyDotSeparatedQualifiedName}" after renaming to ` +
-                `"${propertyNewKey}" because it is not configurable while the processing approach is the manipulations ` +
-                "with source object and \"mustLeaveEvenRenamed\" has not been set to true. " +
+            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, propertyNewKey, documentationPageAnchor }) => `Unable to delete the property "${targetPropertyDotSeparatedQualifiedName}" after creating of its copy ` +
+                `with name "${propertyNewKey}" because it is not configurable while the processing approach is the ` +
+                "manipulations with source object and \"mustLeaveEvenRenamed\" has not been set to `true`. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         unableToChangePropertyDescriptors: {
             title: "Unable to Change Property Descriptors",
-            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => `Unable to change the descriptions of property "${targetPropertyDotSeparatedQualifiedName}" because this ` +
+            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => `Unable to change the description of property "${targetPropertyDotSeparatedQualifiedName}" because this ` +
                 "property is not configurable while the processing approach is the manipulations with source object. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
@@ -272,8 +271,7 @@ const rawObjectDataProcessorLocalization__english = {
                 ((0, isNull_1.default)(targetPropertyDotSeparatedQualifiedName) ?
                     "root associative array " :
                     `associative array "${targetPropertyDotSeparatedQualifiedName}" `) +
-                "what it the contradiction. " +
-                "Either allowed keys or forbidden ones can be specified but not both." +
+                " what it the contradiction. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         incompatibleValuesTypesAlternatives: {
@@ -282,14 +280,13 @@ const rawObjectDataProcessorLocalization__english = {
                 (isIndexedArrayLikeType ?
                     "`ValuesTypesIDs.indexedArray` (aliased as `Array`) and `ValuesTypesIDs.tuple`" :
                     "`ValuesTypesIDs.fixedSchemaObject` (aliased as `Object`) and `ValuesTypesIDs.associativeArray`") +
-                "are incompatible alternatives of `ValuesTypesIDs.polymorphic` because from the viewpoint of ECMAScript " +
-                "both are the " +
-                (isIndexedArrayLikeType ? "`Array`" : "`Object`") +
+                " are incompatible alternatives of `ValuesTypesIDs.polymorphic` because from the viewpoint of ECMAScript " +
+                `both are the ${isIndexedArrayLikeType ? "`Array`" : "`Object`"}. ` +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         bothAllowedAndForbiddenCharactersSpecified: {
             title: "Both Allowed And Forbidden Characters Specified",
-            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => "Both allowed and forbidden characters has been specified for string-type property/element " +
+            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => "Both allowed and forbidden characters has been specified for the string-type property/element " +
                 `${targetPropertyDotSeparatedQualifiedName} what it the contradiction. ` +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         }
@@ -300,37 +297,25 @@ const rawObjectDataProcessorLocalization__english = {
             generateDescription: ({ targetPropertyDotSeparatedQualifiedName, stringifiedCaughtError, documentationPageAnchor }) => "The error has occurred during the pre-validation modification of the property/element " +
                 `"${targetPropertyDotSeparatedQualifiedName}".\n` +
                 `${stringifiedCaughtError}\n` +
-                "This error has been reported as warning because the error handling strategy " +
-                "\"onPreValidationModificationFailed\" is \"ErrorHandlingStrategies.warningWithoutMarkingOfDataAsInvalid\" " +
-                "what is not recommended. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         unableToDeletePropertyWithOutdatedKey: {
             title: "Unable to Delete Property With Outdated Key",
-            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, propertyNewKey, documentationPageAnchor }) => `Unable to delete the property "${targetPropertyDotSeparatedQualifiedName}" after renaming to ` +
-                `"${propertyNewKey}" because it is not configurable while the processing approach is the manipulations ` +
-                "with source object and \"mustLeaveEvenRenamed\" has not been set to true. " +
-                "This error has been reported as warning because the error handling strategy " +
-                "\"unableToChangePropertyDescriptors\" is \"ErrorHandlingStrategies.warningWithoutMarkingOfDataAsInvalid\" " +
-                "what is not recommended. " +
+            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, propertyNewKey, documentationPageAnchor }) => `Unable to delete the property "${targetPropertyDotSeparatedQualifiedName}" after creating of its copy ` +
+                `with name "${propertyNewKey}" because it is not configurable while the processing approach is the ` +
+                "manipulations with source object and \"mustLeaveEvenRenamed\" has not been set to `true`. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         unableToChangePropertyDescriptors: {
             title: "Unable to Change Property Descriptors",
-            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => `Unable to change the descriptions of property "${targetPropertyDotSeparatedQualifiedName}" because this ` +
+            generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => `Unable to change the description of property "${targetPropertyDotSeparatedQualifiedName}" because this ` +
                 "property is not configurable while the processing approach is the manipulations with source object. " +
-                "This error has been reported as warning because the error handling strategy " +
-                "\"unableToChangePropertyDescriptors\" is \"ErrorHandlingStrategies.warningWithoutMarkingOfDataAsInvalid\" " +
-                "what is not recommended. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         },
         unableToUpdatePropertyValue: {
             title: "Unable to Update property Value",
             generateDescription: ({ targetPropertyDotSeparatedQualifiedName, documentationPageAnchor }) => `The updating of the property "${targetPropertyDotSeparatedQualifiedName}" has been requested via default ` +
                 "value substitution or pre-validation modification while this property is read-only. " +
-                "This error has been reported as warning because the error handling strategy " +
-                "\"unableToChangePropertyDescriptors\" is \"ErrorHandlingStrategies.warningWithoutMarkingOfDataAsInvalid\" " +
-                "what is not recommended. " +
                 rawObjectDataProcessorLocalization__english.generateSeeMoreSentence({ documentationPageAnchor })
         }
     },

package/Distributable/esm/AJAX/AJAX_Service.js

@@ -134,7 +134,7 @@ class AJAX_Service {
                 Logger.throwErrorWithFormattedMessage({
                     errorInstance: new InvalidConfigError({
                         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.localization.defaultTitle,
                     occurrenceLocation: "AJAX_Service.normalizeURI_UntilPath(URI_PathRawDefinition)"

package/Distributable/esm/Numbers/isStringifiedNonNegativeIntegerOfRegularNotation.js

@@ -1,3 +1,3 @@
 export default function isStringifiedNonNegativeIntegerOfRegularNotation(value) {
-    return (/^[1-9]\d*$/u).test(value);
+    return (/^(?:0|^[1-9]\d*)$/u).test(value);
 }

package/Distributable/esm/Objects/getObjectPropertySafely__TEMP.d.ts

@@ -0,0 +1 @@
+export default function getObjectPropertySafely(targetObject: unknown, dotSeparatedOrArrayedPathToTargetProperty: ReadonlyArray<string | number> | string | number): unknown;

package/Distributable/esm/Objects/getObjectPropertySafely__TEMP.js

@@ -0,0 +1,53 @@
+import splitString from "../Strings/splitString";
+import Logger from "../Logging/Logger";
+import InvalidParameterValueError from "../Errors/InvalidParameterValue/InvalidParameterValueError";
+import isNonEmptyString from "../TypeGuards/Strings/isNonEmptyString";
+import isArbitraryObject from "../TypeGuards/Objects/isArbitraryObject";
+import isNaturalNumberOrZero from "../TypeGuards/Numbers/isNaturalNumberOrZero";
+export default function getObjectPropertySafely(targetObject, dotSeparatedOrArrayedPathToTargetProperty) {
+    if (!isArbitraryObject(targetObject)) {
+        return;
+    }
+    let targetPropertyPathSegments;
+    if (Array.isArray(dotSeparatedOrArrayedPathToTargetProperty) &&
+        dotSeparatedOrArrayedPathToTargetProperty.length > 0 &&
+        dotSeparatedOrArrayedPathToTargetProperty.
+            every((key) => isNonEmptyString(key) || isNaturalNumberOrZero(key))) {
+        targetPropertyPathSegments = dotSeparatedOrArrayedPathToTargetProperty;
+    }
+    else if (isNaturalNumberOrZero(dotSeparatedOrArrayedPathToTargetProperty)) {
+        targetPropertyPathSegments = [String(dotSeparatedOrArrayedPathToTargetProperty)];
+    }
+    else if (isNonEmptyString(dotSeparatedOrArrayedPathToTargetProperty)) {
+        targetPropertyPathSegments = splitString(dotSeparatedOrArrayedPathToTargetProperty, ".");
+    }
+    else {
+        Logger.logError({
+            errorType: InvalidParameterValueError.NAME,
+            title: InvalidParameterValueError.localization.defaultTitle,
+            description: InvalidParameterValueError.localization.generateDescription({
+                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."
+            }),
+            occurrenceLocation: "getObjectPropertySafely(targetObject, dotSeparatedOrArrayedPathToTargetProperty)"
+        });
+        return;
+    }
+    let objectOfCurrentDepthLevel = targetObject;
+    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 valueOfCurrentDepthLevel;
+        }
+        else if (isArbitraryObject(valueOfCurrentDepthLevel)) {
+            objectOfCurrentDepthLevel = valueOfCurrentDepthLevel;
+        }
+        else {
+            return;
+        }
+    }
+    return;
+}

package/Distributable/esm/RawObjectDataProcessor/RawObjectDataProcessor.d.ts

@@ -7,8 +7,9 @@ declare class RawObjectDataProcessor {
     private readonly localization;
     private readonly errorHandlingStrategies;
     private readonly validationErrorsMessages;
-    private readonly currentlyIteratedObjectPropertyQualifiedInitialNameSegmentsForLogging;
+    private readonly currentlyIteratedPropertyQualifiedInitialNameSegments;
     private readonly currentlyIteratedPropertyNewNamesByDepthLevelsForLogging;
+    private initialObjectSnapshot;
     static process<ProcessedData extends PossiblyReadonlyParsedJSON, InterimValidData = ProcessedData>(rawData: unknown, validDataSpecification: RawObjectDataProcessor.ObjectDataSpecification, options?: RawObjectDataProcessor.Options): RawObjectDataProcessor.ProcessingResult<ProcessedData>;
     static formatValidationErrorsList(messages: ReadonlyArray<string>, localization?: RawObjectDataProcessor.Localization): string;
     static generateValidationErrorMessage(payload: RawObjectDataProcessor.Localization.DataForMessagesBuilding, localization?: RawObjectDataProcessor.Localization): string;
@@ -24,6 +25,7 @@ declare class RawObjectDataProcessor {
     private processPolymorphicValue;
     private get currentObjectPropertyDotSeparatedQualifiedName();
     private registerValidationError;
+    private createInitialObjectSnapshotIfNotCreatedYet;
     private handleFailedPreValidationModification;
     private get isValidationOnlyMode();
     private static getNormalizedPreValidationModifications;
@@ -148,7 +150,7 @@ declare namespace RawObjectDataProcessor {
         mustMakeReadonly?: boolean;
         mustLeaveEvenRenamed?: boolean;
     }>;
-    type ConditionAssociatedWithProperty = Readonly<{
+    export type ConditionAssociatedWithProperty = Readonly<{
         predicate: ConditionAssociatedWithProperty.Predicate;
         descriptionForLogging: string;
     }>;
@@ -159,10 +161,11 @@ declare namespace RawObjectDataProcessor {
                 rawData__currentObjectDepth: ArbitraryObject;
                 rawData__full: ArbitraryObject;
                 targetPropertyDotSeparatedPath: string;
+                targetPropertyPathSegments: Array<string | number>;
             }>;
         }
     }
-    type ConditionAssociatedWithTupleElement = Readonly<{
+    export type ConditionAssociatedWithTupleElement = Readonly<{
         predicate: ConditionAssociatedWithTupleElement.Predicate;
         descriptionForLogging: string;
     }>;