@zelgadis87/utils-core 5.3.3 → 5.3.4

package/.rollup/index.mjs

@@ -2139,8 +2139,8 @@ class TimeInstant extends TimeBase {
         return timeInstantBuilder();
     }
     static fromIso8601(str) {
-        // Regex to capture: YYYY-MM-DDTHH:mm:ss.sssZ or YYYY-MM-DDTHH:mm:ss.sss±HH:mm
-        const iso8601Regex = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})\.(\d{3})(Z|[+-]\d{2}:\d{2})?$/;
+        // Regex to capture: YYYY-MM-DDTHH:mm:ss[.sss]Z or YYYY-MM-DDTHH:mm:ss[.sss]±HH:mm
+        const iso8601Regex = /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(?:\.(\d{3})|)(Z|[+-]\d{2}:\d{2})?$/;
         const match = str.match(iso8601Regex);
         if (!match) {
             throw new Error('Invalid ISO 8601 date format: ' + str);
@@ -2153,7 +2153,7 @@ class TimeInstant extends TimeBase {
         const hours = parseInt(hourStr, 10);
         const minutes = parseInt(minuteStr, 10);
         const seconds = parseInt(secondStr, 10);
-        const milliseconds = parseInt(millisecondStr, 10);
+        const milliseconds = millisecondStr ? parseInt(millisecondStr, 10) : 0;
         // Validate each component using standalone validation functions
         if (!isValidYear(year))
             throw new Error('Invalid year in: ' + str);
@@ -2589,6 +2589,216 @@ function parseTimeInstantComponents(dateString, pattern, config = {}) {
     }
     return result;
 }
+/**
+    * Parses a date string using only basic patterns that don't require Intl.
+    * This is a safer alternative to parseTimeInstantComponents that works even when Intl is not available.
+    *
+    * @param dateString The date string to parse
+    * @param pattern A basic pattern that doesn't require Intl (strongly typed)
+    * @returns Partial time instant parameters that were parsed from the string
+    * @throws Error if the string doesn't match the pattern or contains invalid values
+    */
+function parseTimeInstantBasicComponents(dateString, pattern) {
+    // Check if Intl is available, if so warn the user about the existing function
+    const isIntlAvailable = typeof Intl !== 'undefined' && typeof Intl.DateTimeFormat !== 'undefined';
+    if (isIntlAvailable)
+        console.warn('Intl is available, use parseTimeInstantComponents instead of parseTimeInstantBasicComponents.');
+    const result = {};
+    let patternIndex = 0;
+    let dateStringIndex = 0;
+    // Helper function to check if a character is a pattern token
+    const isPatternChar = (char) => ['y', 'M', 'd', 'H', 'm', 's', 'S'].includes(char);
+    // Token extraction rules dictionary
+    const tokenRules = {
+        '': { maxLength: undefined }, // Default rule
+        'H': {
+            maxLength: 2,
+            validator: (value) => /^\d{1,2}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 23,
+            description: 'Hour (0-23, 1-2 digits)'
+        },
+        'HH': {
+            maxLength: 2,
+            validator: (value) => /^\d{2}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 23,
+            description: 'Hour (00-23, exactly 2 digits)'
+        },
+        'M': {
+            maxLength: 2,
+            validator: (value) => /^\d{1,2}$/.test(value) && parseInt(value, 10) >= 1 && parseInt(value, 10) <= 12,
+            description: 'Month (1-12, 1-2 digits)'
+        },
+        'MM': {
+            maxLength: 2,
+            validator: (value) => /^\d{2}$/.test(value) && parseInt(value, 10) >= 1 && parseInt(value, 10) <= 12,
+            description: 'Month (01-12, exactly 2 digits)'
+        },
+        'd': {
+            maxLength: 2,
+            validator: (value) => /^\d{1,2}$/.test(value) && parseInt(value, 10) >= 1 && parseInt(value, 10) <= 31,
+            description: 'Day (1-31, 1-2 digits)'
+        },
+        'dd': {
+            maxLength: 2,
+            validator: (value) => /^\d{2}$/.test(value) && parseInt(value, 10) >= 1 && parseInt(value, 10) <= 31,
+            description: 'Day (01-31, exactly 2 digits)'
+        },
+        'm': {
+            maxLength: 2,
+            validator: (value) => /^\d{1,2}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 59,
+            description: 'Minutes (0-59, 1-2 digits)'
+        },
+        'mm': {
+            maxLength: 2,
+            validator: (value) => /^\d{2}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 59,
+            description: 'Minutes (00-59, exactly 2 digits)'
+        },
+        's': {
+            maxLength: 2,
+            validator: (value) => /^\d{1,2}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 59,
+            description: 'Seconds (0-59, 1-2 digits)'
+        },
+        'ss': {
+            maxLength: 2,
+            validator: (value) => /^\d{2}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 59,
+            description: 'Seconds (00-59, exactly 2 digits)'
+        },
+        'S': {
+            maxLength: 3,
+            validator: (value) => /^\d{1,3}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 999,
+            description: 'Milliseconds (0-999, 1-3 digits)'
+        },
+        'SS': {
+            maxLength: 2,
+            validator: (value) => /^\d{2}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 99,
+            description: 'Milliseconds (0-99, exactly 2 digits)'
+        },
+        'SSS': {
+            maxLength: 3,
+            validator: (value) => /^\d{3}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 999,
+            description: 'Milliseconds (000-999, exactly 3 digits)'
+        },
+        'y': {
+            maxLength: 4,
+            validator: (value) => /^\d{1,4}$/.test(value) && parseInt(value, 10) >= 0 && parseInt(value, 10) <= 9999,
+            description: 'Year (0-9999, 1-4 digits)'
+        },
+        'yy': {
+            maxLength: 2,
+            validator: (value) => /^\d{2}$/.test(value),
+            description: 'Year (2 digits)'
+        },
+        'yyyy': {
+            maxLength: 4,
+            validator: (value) => /^\d{4}$/.test(value),
+            description: 'Year (4 digits)'
+        }
+    };
+    // Helper function to extract a token value from the date string using token rules
+    const extractValue = (tokenType, tokenLength) => {
+        const tokenKey = tokenType.repeat(tokenLength);
+        const rule = tokenRules[tokenKey] || tokenRules[''];
+        // Extract consecutive digits up to maxLength
+        let endIndex = dateStringIndex;
+        let digitCount = 0;
+        const maxChars = rule.maxLength || tokenLength;
+        while (endIndex < dateString.length && /\d/.test(dateString[endIndex]) && digitCount < maxChars) {
+            endIndex++;
+            digitCount++;
+        }
+        const value = dateString.substring(dateStringIndex, endIndex);
+        dateStringIndex = endIndex;
+        // Validate the extracted value if a validator is provided
+        if (rule.validator && !rule.validator(value)) {
+            // Extract field name from description for better error messages
+            const fieldName = (rule.description || tokenKey).split(' ')[0].toLowerCase();
+            throw new Error(`Invalid ${fieldName} value: "${value}"`);
+        }
+        return value;
+    };
+    // Helper function to parse and validate a numeric value
+    const parseNumericValue = (value, min, max, field) => {
+        const num = parseInt(value, 10);
+        if (isNaN(num) || num < min || num > max)
+            throw new Error(`Invalid ${field} value: ${value}`);
+        return num;
+    };
+    while (patternIndex < pattern.length) {
+        const patternChar = pattern[patternIndex];
+        if (isPatternChar(patternChar)) {
+            // Start of a token - determine its full length
+            let tokenLength = 0;
+            while (patternIndex + tokenLength < pattern.length &&
+                pattern[patternIndex + tokenLength] === patternChar) {
+                tokenLength++;
+            }
+            // Extract and parse the corresponding value from the date string
+            const value = extractValue(patternChar, tokenLength);
+            // Check if we got enough characters for this token (after extraction)
+            if (value.length < tokenLength) {
+                throw new Error(`Date string "${dateString}" does not match pattern "${pattern}"`);
+            }
+            // Debug: log pattern processing (commented out for production)
+            // console.log( `Processing patternChar="${patternChar}" with tokenLength=${tokenLength}, value="${value}"` );
+            switch (patternChar) {
+                case 'y': {
+                    if (tokenLength === 2) {
+                        // 2-digit year
+                        const shortYear = parseNumericValue(value, 0, 99, 'year');
+                        result.year = shortYear < 50 ? 2000 + shortYear : 1900 + shortYear;
+                    }
+                    else {
+                        // 4-digit year
+                        result.year = parseNumericValue(value, 0, 9999, 'year');
+                    }
+                    break;
+                }
+                case 'M':
+                    result.month = parseNumericValue(value, 1, 12, 'month');
+                    break;
+                case 'd':
+                    result.date = parseNumericValue(value, 1, 31, 'day');
+                    break;
+                case 'H':
+                    result.hours = parseNumericValue(value, 0, 23, 'hours');
+                    break;
+                case 'm':
+                    result.minutes = parseNumericValue(value, 0, 59, 'minutes');
+                    break;
+                case 's':
+                    result.seconds = parseNumericValue(value, 0, 59, 'seconds');
+                    break;
+                case 'S': {
+                    let ms = parseInt(value, 10);
+                    if (isNaN(ms))
+                        throw new Error(`Invalid milliseconds value: ${value}`);
+                    // Normalize to milliseconds based on length
+                    if (tokenLength === 1)
+                        ms *= 100;
+                    else if (tokenLength === 2)
+                        ms *= 10;
+                    result.milliseconds = ms;
+                    break;
+                }
+                default:
+                    throw new Error(`Unsupported pattern character: ${patternChar}`);
+            }
+            patternIndex += tokenLength;
+        }
+        else {
+            // Non-pattern character (separator like '-', '/', ':', ' ', '.')
+            if (dateStringIndex >= dateString.length ||
+                dateString[dateStringIndex] !== patternChar) {
+                throw new Error(`Date string "${dateString}" does not match pattern "${pattern}"`);
+            }
+            patternIndex++;
+            dateStringIndex++;
+        }
+    }
+    // After processing the entire pattern, check if we consumed the entire date string
+    if (dateStringIndex < dateString.length) {
+        throw new Error(`Date string "${dateString}" does not match pattern "${pattern}"`);
+    }
+    return result;
+}
 
 const LEVELS = ["trace", "log", "debug", "info", "warn", "error"];
 const timestamp = () => TimeInstant.now().format('HH:mm:ss');
@@ -3263,5 +3473,5 @@ function isUpgradable(obj) {
     return isDefined(obj) && typeof obj === "object" && VERSION_FIELD in obj && isNumber(obj.$version) && isPositiveNumber(obj.$version);
 }
 
-export { Cached, DataUpgrader, Deferred, DeferredCanceledError, ErrorCannotInstantiatePresentOptionalWithEmptyValue, ErrorGetEmptyOptional, ErrorSetEmptyOptional, Lazy, LazyAsync, LazyDictionary, Logger, NEVER, NonExhaustiveSwitchError, Operation, Optional, PredicateBuilder, RandomTimeDuration, RateThrottler, Semaphore, Sorter, StringParts, TimeDuration, TimeFrequency, TimeInstant, TimeRange, TimeUnit, TimeoutError, alwaysFalse, alwaysTrue, and, arrayGet, arrayIncludes, asError, asPromise, average, awaitAtMost, capitalizeWord, clamp, clampInt0_100, constant, constantFalse, constantNull, constantOne, constantTrue, constantUndefined, constantZero, cssDeclarationRulesDictionaryToCss, decrement, decrementBy, delayPromise, dictToEntries, dictToList, divideBy, ellipsis, ensureArray, ensureDefined, ensureNegativeNumber, ensureNonNegativeNumber, ensureNonPositiveNumber, ensurePositiveNumber, ensureReadableArray, entriesToDict, entriesToEntries, entriesToList, extendArray, extendArrayWith, fill, filterMap, filterMapReduce, filterWithTypePredicate, findInArray, findIndexInArray, first$1 as first, flatMapTruthys, getCauseMessageFromError, getCauseStackFromError, getMessageFromError, getStackFromError, groupByBoolean, groupByBooleanWith, groupByNumber, groupByNumberWith, groupByString, groupByStringWith, groupBySymbol, groupBySymbolWith, hashCode, head, identity, ifDefined, ifNullOrUndefined, iff, includes, increment, incrementBy, indexByNumber, indexByNumberWith, indexByString, indexByStringWith, indexBySymbol, indexBySymbolWith, indexByWith, isAllowedTimeDuration, isArray, isDefined, isEmpty, isError, isFalse, isFunction, isNegativeNumber, isNullOrUndefined, isNullOrUndefinedOrEmpty, isNumber, isPositiveNumber, isString, isTimeInstant, isTrue, isUpgradable, isZero, jsonCloneDeep, last$1 as last, listToDict, mapDefined, mapEntries, mapFirstTruthy, mapTruthys, max, maxBy, min, minBy, multiplyBy, noop, not, omitFromJsonObject, or, pad, padLeft, padRight, parseJson, partition, pick, pipedInvoke, pipedInvokeFromArray, pluralize, promiseSequence, randomId, randomNumberInInterval, range, repeat, reverse$1 as reverse, round, roundAwayFromZero, roundToLower, roundToNearest, roundToUpper, roundTowardsZero, shallowArrayEquals, shallowRecordEquals, sortedArray, splitWords, stringToNumber, stringifyJson, sum, sumBy, tail, throttle, throwIfNullOrUndefined, transformCssDictionary, tryToParseJson, tryToParseNumber, uniq, uniqBy, uniqByKey, unzip, upsert, withTryCatch, withTryCatchAsync, wrapWithString, xor, zip };
+export { Cached, DataUpgrader, Deferred, DeferredCanceledError, ErrorCannotInstantiatePresentOptionalWithEmptyValue, ErrorGetEmptyOptional, ErrorSetEmptyOptional, Lazy, LazyAsync, LazyDictionary, Logger, NEVER, NonExhaustiveSwitchError, Operation, Optional, PredicateBuilder, RandomTimeDuration, RateThrottler, Semaphore, Sorter, StringParts, TimeDuration, TimeFrequency, TimeInstant, TimeRange, TimeUnit, TimeoutError, alwaysFalse, alwaysTrue, and, arrayGet, arrayIncludes, asError, asPromise, average, awaitAtMost, capitalizeWord, clamp, clampInt0_100, constant, constantFalse, constantNull, constantOne, constantTrue, constantUndefined, constantZero, cssDeclarationRulesDictionaryToCss, decrement, decrementBy, delayPromise, dictToEntries, dictToList, divideBy, ellipsis, ensureArray, ensureDefined, ensureNegativeNumber, ensureNonNegativeNumber, ensureNonPositiveNumber, ensurePositiveNumber, ensureReadableArray, entriesToDict, entriesToEntries, entriesToList, extendArray, extendArrayWith, fill, filterMap, filterMapReduce, filterWithTypePredicate, findInArray, findIndexInArray, first$1 as first, flatMapTruthys, getCauseMessageFromError, getCauseStackFromError, getMessageFromError, getStackFromError, groupByBoolean, groupByBooleanWith, groupByNumber, groupByNumberWith, groupByString, groupByStringWith, groupBySymbol, groupBySymbolWith, hashCode, head, identity, ifDefined, ifNullOrUndefined, iff, includes, increment, incrementBy, indexByNumber, indexByNumberWith, indexByString, indexByStringWith, indexBySymbol, indexBySymbolWith, indexByWith, isAllowedTimeDuration, isArray, isDefined, isEmpty, isError, isFalse, isFunction, isNegativeNumber, isNullOrUndefined, isNullOrUndefinedOrEmpty, isNumber, isPositiveNumber, isString, isTimeInstant, isTrue, isUpgradable, isZero, jsonCloneDeep, last$1 as last, listToDict, mapDefined, mapEntries, mapFirstTruthy, mapTruthys, max, maxBy, min, minBy, multiplyBy, noop, not, omitFromJsonObject, or, pad, padLeft, padRight, parseJson, parseTimeInstantBasicComponents, parseTimeInstantComponents, partition, pick, pipedInvoke, pipedInvokeFromArray, pluralize, promiseSequence, randomId, randomNumberInInterval, range, repeat, reverse$1 as reverse, round, roundAwayFromZero, roundToLower, roundToNearest, roundToUpper, roundTowardsZero, shallowArrayEquals, shallowRecordEquals, sortedArray, splitWords, stringToNumber, stringifyJson, sum, sumBy, tail, throttle, throwIfNullOrUndefined, transformCssDictionary, tryToParseJson, tryToParseNumber, uniq, uniqBy, uniqByKey, unzip, upsert, withTryCatch, withTryCatchAsync, wrapWithString, xor, zip };
 //# sourceMappingURL=index.mjs.map