@dereekb/util 12.5.9 → 12.6.0

package/fetch/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util/fetch",
-  "version": "12.5.9",
+  "version": "12.6.0",
   ".": {
     "types": "./src/index.d.ts",
     "node": {

package/index.cjs.js

@@ -8068,6 +8068,20 @@ function cssClassesSet(cssClasses) {
   return result;
 }
 
+/**
+ * Inverts a string record, inverting the key and value of each entry in the record.
+ *
+ * @param record
+ * @returns
+ */
+function invertStringRecord(record) {
+  const inverted = {};
+  Object.entries(record).forEach(([key, value]) => {
+    inverted[value] = key;
+  });
+  return inverted;
+}
+
 const JPEG_MIME_TYPE = 'image/jpeg';
 const PNG_MIME_TYPE = 'image/png';
 const WEBP_MIME_TYPE = 'image/webp';
@@ -8076,37 +8090,82 @@ const HEIF_MIME_TYPE = 'image/heif';
 const TIFF_MIME_TYPE = 'image/tiff';
 const SVG_MIME_TYPE = 'image/svg+xml';
 const RAW_MIME_TYPE = 'image/raw';
-function mimetypeForImageType(imageType) {
-  let result = undefined;
-  switch (imageType) {
-    case 'jpeg':
-    case 'jpg':
-      result = JPEG_MIME_TYPE;
-      break;
-    case 'png':
-      result = PNG_MIME_TYPE;
-      break;
-    case 'webp':
-      result = WEBP_MIME_TYPE;
-      break;
-    case 'gif':
-      result = GIF_MIME_TYPE;
-      break;
-    case 'svg':
-      result = SVG_MIME_TYPE;
-      break;
-    case 'raw':
-      result = RAW_MIME_TYPE;
-      break;
-    case 'tiff':
-      result = TIFF_MIME_TYPE;
-      break;
-    case 'heif':
-      result = HEIF_MIME_TYPE;
-      break;
-  }
+const IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD = {
+  jpeg: JPEG_MIME_TYPE,
+  jpg: JPEG_MIME_TYPE,
+  png: PNG_MIME_TYPE,
+  webp: WEBP_MIME_TYPE,
+  gif: GIF_MIME_TYPE,
+  svg: SVG_MIME_TYPE,
+  raw: RAW_MIME_TYPE,
+  heif: HEIF_MIME_TYPE,
+  tiff: TIFF_MIME_TYPE
+};
+const IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = invertStringRecord(IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD);
+function mimeTypeForImageFileExtension(extension) {
+  return extension ? IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD[extension] : undefined;
+}
+function imageFileExtensionForMimeType(mimeType) {
+  return mimeType ? IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD[mimeType] : undefined;
+}
+const PDF_MIME_TYPE = 'application/pdf';
+const DOCX_MIME_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+const XLSX_MIME_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+const TXT_MIME_TYPE = 'text/plain';
+const CSV_MIME_TYPE = 'text/csv';
+const HTML_MIME_TYPE = 'text/html';
+const XML_MIME_TYPE = 'application/xml';
+const JSON_MIME_TYPE = 'application/json';
+const YAML_MIME_TYPE = 'application/yaml';
+const MARKDOWN_MIME_TYPE = 'text/markdown';
+const DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD = {
+  pdf: PDF_MIME_TYPE,
+  docx: DOCX_MIME_TYPE,
+  xlsx: XLSX_MIME_TYPE,
+  txt: TXT_MIME_TYPE,
+  csv: CSV_MIME_TYPE,
+  html: HTML_MIME_TYPE,
+  xml: XML_MIME_TYPE,
+  json: JSON_MIME_TYPE,
+  yaml: YAML_MIME_TYPE,
+  md: MARKDOWN_MIME_TYPE
+};
+const DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = invertStringRecord(DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD);
+function mimeTypeForDocumentFileExtension(extension) {
+  return extension ? DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD[extension] : undefined;
+}
+/**
+ * Returns the document file extension for the given mimetype, or undefined if the mimetype is not known/recognized.
+ *
+ * @param mimeType The mimetype to get the document file extension for.
+ * @returns The document file extension for the given mimetype, or undefined if the mimetype is not known.
+ */
+function documentFileExtensionForMimeType(mimeType) {
+  return mimeType ? DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD[mimeType] : undefined;
+}
+const ZIP_FILE_MIME_TYPE = 'application/zip';
+const APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD = {
+  zip: ZIP_FILE_MIME_TYPE
+};
+const APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = invertStringRecord(APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD);
+function mimeTypeForApplicationFileExtension(extension) {
+  return extension ? APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD[extension] : undefined;
+}
+function applicationFileExtensionForMimeType(mimeType) {
+  return mimeType ? APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD[mimeType] : undefined;
+}
+function mimeTypeForFileExtension(extension) {
+  const result = mimeTypeForImageFileExtension(extension) ?? mimeTypeForDocumentFileExtension(extension);
+  return result;
+}
+function fileExtensionForMimeType(mimeType) {
+  const result = imageFileExtensionForMimeType(mimeType) ?? documentFileExtensionForMimeType(mimeType) ?? applicationFileExtensionForMimeType(mimeType);
   return result;
 }
+/**
+ * @deprecated Use mimeTypeForImageFileExtension instead.
+ */
+const mimetypeForImageType = mimeTypeForImageFileExtension;
 
 /**
  * Creates a CharacterPrefixSuffixInstance
@@ -10702,6 +10761,24 @@ function monthDaySlashDateToDateString(slashDate) {
   const result = `${year}-${month}-${day}`;
   return result;
 }
+function dateFromDateOrTimeMillisecondsNumber(input) {
+  if (input == null) {
+    return input;
+  } else if (isDate(input)) {
+    return input;
+  } else {
+    return unixMillisecondsNumberToDate(input);
+  }
+}
+/**
+ * Converts a unix timestamp number to a Date object.
+ *
+ * @param dateTimeNumber - Unix timestamp number to convert
+ * @returns Date object if timestamp is valid, null/undefined if timestamp is null/undefined
+ */
+function unixMillisecondsNumberToDate(dateTimeNumber) {
+  return dateTimeNumber != null ? new Date(dateTimeNumber) : dateTimeNumber;
+}
 /**
  * Converts the input DateOrMilliseconds to a Date.
  *
@@ -11410,11 +11487,11 @@ function objectIsEmpty(obj) {
  * @param input - Date object or unix timestamp number to convert
  * @returns Unix timestamp number if input is valid, null/undefined if input is null/undefined
  */
-function unixTimeNumberFromDateOrTimeNumber(input) {
+function unixDateTimeSecondsNumberFromDateOrTimeNumber(input) {
   if (input == null) {
     return input;
   } else if (isDate(input)) {
-    return unixTimeNumberFromDate(input);
+    return unixDateTimeSecondsNumberFromDate(input);
   } else {
     return input;
   }
@@ -11424,19 +11501,19 @@ function unixTimeNumberFromDateOrTimeNumber(input) {
  *
  * @returns Current time as unix timestamp number
  */
-function unixTimeNumberForNow() {
-  return unixTimeNumberFromDate(new Date());
+function unixDateTimeSecondsNumberForNow() {
+  return unixDateTimeSecondsNumberFromDate(new Date());
 }
-function unixTimeNumberFromDate(date) {
+function unixDateTimeSecondsNumberFromDate(date) {
   return date != null ? Math.ceil(date.getTime() / 1000) : date;
 }
-function dateFromDateOrTimeNumber(input) {
+function dateFromDateOrTimeSecondsNumber(input) {
   if (input == null) {
     return input;
   } else if (isDate(input)) {
     return input;
   } else {
-    return unixTimeNumberToDate(input);
+    return unixDateTimeSecondsNumberToDate(input);
   }
 }
 /**
@@ -11445,9 +11522,29 @@ function dateFromDateOrTimeNumber(input) {
  * @param dateTimeNumber - Unix timestamp number to convert
  * @returns Date object if timestamp is valid, null/undefined if timestamp is null/undefined
  */
-function unixTimeNumberToDate(dateTimeNumber) {
+function unixDateTimeSecondsNumberToDate(dateTimeNumber) {
   return dateTimeNumber != null ? new Date(dateTimeNumber * 1000) : dateTimeNumber;
 }
+/**
+ * @deprecated use unixDateTimeSecondsNumberFromDateOrTimeNumber instead
+ */
+const unixTimeNumberFromDateOrTimeNumber = unixDateTimeSecondsNumberFromDateOrTimeNumber;
+/**
+ * @deprecated use unixDateTimeSecondsNumberForNow instead
+ */
+const unixTimeNumberForNow = unixDateTimeSecondsNumberForNow;
+/**
+ * @deprecated use unixDateTimeSecondsNumberFromDate instead
+ */
+const unixTimeNumberFromDate = unixDateTimeSecondsNumberFromDate;
+/**
+ * @deprecated use dateFromDateOrTimeSecondsNumber instead
+ */
+const dateFromDateOrTimeNumber = dateFromDateOrTimeSecondsNumber;
+/**
+ * @deprecated use unixDateTimeSecondsNumberToDate instead
+ */
+const unixTimeNumberToDate = unixDateTimeSecondsNumberToDate;
 
 /**
  * Returns expiration details for the input configuration.
@@ -11466,7 +11563,7 @@ function expirationDetails(input) {
     defaultExpiresFromDateToNow,
     expiresIn
   } = input;
-  const parsedExpiresFromDate = expiresFromDate != null ? dateFromDateOrTimeNumber(expiresFromDate) : null;
+  const parsedExpiresFromDate = expiresFromDate != null ? dateFromDateOrTimeMillisecondsNumber(expiresFromDate) : null;
   function getNow(nowOverride) {
     const now = nowOverride ?? inputNow ?? new Date();
     return now;
@@ -14278,9 +14375,63 @@ async function iterateFilteredPages(inputPage, loadFn, iterFn) {
   return count;
 }
 
+function slashPathDirectoryTree(nodeValues, options) {
+  const {
+    includeChildrenWithMissingParentFolder
+  } = options ?? {};
+  /**
+   * Create all nodes first.
+   */
+  const nodes = nodeValues.map(x => ({
+    depth: x.slashPathDetails.parts.length - 1,
+    value: x
+  }));
+  const nodeMap = new Map();
+  nodes.forEach(node => {
+    // only add typed files to the node map
+    if (!node.value.slashPathDetails.typedFile) {
+      const key = node.value.slashPathDetails.parts.join('/');
+      nodeMap.set(key, node);
+    }
+  });
+  /**
+   * Create the tree second, and add the root children nodes.
+   */
+  const children = [];
+  nodes.forEach(node => {
+    const {
+      slashPathDetails
+    } = node.value;
+    const parts = slashPathDetails.parts;
+    if (parts.length > 1) {
+      const parentParts = parts.slice(0, parts.length - 1);
+      const parentKey = parentParts.join('/');
+      const parent = nodeMap.get(parentKey);
+      if (parent) {
+        if (!parent.children) {
+          parent.children = [];
+        }
+        parent.children.push(node);
+        node.parent = parent;
+      } else if (includeChildrenWithMissingParentFolder) {
+        children.push(node);
+      }
+    } else {
+      children.push(node);
+    }
+  });
+  const root = {
+    depth: -1,
+    children
+  };
+  return root;
+}
+
 exports.ALL_DOUBLE_SLASHES_REGEX = ALL_DOUBLE_SLASHES_REGEX;
 exports.ALL_SLASHES_REGEX = ALL_SLASHES_REGEX;
 exports.ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX = ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX;
+exports.APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD = APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD;
+exports.APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD;
 exports.ASSERTION_ERROR_CODE = ASSERTION_ERROR_CODE;
 exports.ASSERTION_HANDLER = ASSERTION_HANDLER;
 exports.AUTH_ADMIN_ROLE = AUTH_ADMIN_ROLE;
@@ -14299,6 +14450,7 @@ exports.BooleanStringKeyArrayUtility = BooleanStringKeyArrayUtility;
 exports.BooleanStringKeyArrayUtilityInstance = BooleanStringKeyArrayUtilityInstance;
 exports.CATCH_ALL_HANDLE_RESULT_KEY = CATCH_ALL_HANDLE_RESULT_KEY;
 exports.COMMA_JOINER = COMMA_JOINER;
+exports.CSV_MIME_TYPE = CSV_MIME_TYPE;
 exports.CUT_VALUE_TO_ZERO_PRECISION = CUT_VALUE_TO_ZERO_PRECISION;
 exports.DASH_CHARACTER_PREFIX_INSTANCE = DASH_CHARACTER_PREFIX_INSTANCE;
 exports.DATE_NOW_VALUE = DATE_NOW_VALUE;
@@ -14311,6 +14463,9 @@ exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS = DEFAULT_SLASH_PATH_ILLEGAL_CHARA
 exports.DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT = DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT;
 exports.DEFAULT_SLASH_PATH_PATH_MATCHER_NON_MATCHING_FILL_VALUE = DEFAULT_SLASH_PATH_PATH_MATCHER_NON_MATCHING_FILL_VALUE;
 exports.DEFAULT_UNKNOWN_MODEL_TYPE_STRING = DEFAULT_UNKNOWN_MODEL_TYPE_STRING;
+exports.DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD = DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD;
+exports.DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD;
+exports.DOCX_MIME_TYPE = DOCX_MIME_TYPE;
 exports.DOLLAR_AMOUNT_PRECISION = DOLLAR_AMOUNT_PRECISION;
 exports.DOLLAR_AMOUNT_STRING_REGEX = DOLLAR_AMOUNT_STRING_REGEX;
 exports.DataDoesNotExistError = DataDoesNotExistError;
@@ -14330,12 +14485,16 @@ exports.HAS_PORT_NUMBER_REGEX = HAS_PORT_NUMBER_REGEX;
 exports.HAS_WEBSITE_DOMAIN_NAME_REGEX = HAS_WEBSITE_DOMAIN_NAME_REGEX;
 exports.HEIF_MIME_TYPE = HEIF_MIME_TYPE;
 exports.HOURS_IN_DAY = HOURS_IN_DAY;
+exports.HTML_MIME_TYPE = HTML_MIME_TYPE;
 exports.HTTP_OR_HTTPS_REGEX = HTTP_OR_HTTPS_REGEX;
 exports.HashSet = HashSet;
+exports.IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD = IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD;
+exports.IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD;
 exports.ISO8601_DAY_STRING_REGEX = ISO8601_DAY_STRING_REGEX;
 exports.ISO8601_DAY_STRING_START_REGEX = ISO8601_DAY_STRING_START_REGEX;
 exports.ISO_8601_DATE_STRING_REGEX = ISO_8601_DATE_STRING_REGEX;
 exports.JPEG_MIME_TYPE = JPEG_MIME_TYPE;
+exports.JSON_MIME_TYPE = JSON_MIME_TYPE;
 exports.LAT_LNG_PATTERN = LAT_LNG_PATTERN;
 exports.LAT_LNG_PATTERN_MAX_PRECISION = LAT_LNG_PATTERN_MAX_PRECISION;
 exports.LAT_LONG_100KM_PRECISION = LAT_LONG_100KM_PRECISION;
@@ -14350,6 +14509,7 @@ exports.LAT_LONG_1M_PRECISION = LAT_LONG_1M_PRECISION;
 exports.LAT_LONG_GRAINS_OF_SAND_PRECISION = LAT_LONG_GRAINS_OF_SAND_PRECISION;
 exports.LEADING_SLASHES_REGEX = LEADING_SLASHES_REGEX;
 exports.MAP_IDENTITY = MAP_IDENTITY;
+exports.MARKDOWN_MIME_TYPE = MARKDOWN_MIME_TYPE;
 exports.MAX_BITWISE_SET_SIZE = MAX_BITWISE_SET_SIZE;
 exports.MAX_LATITUDE_VALUE = MAX_LATITUDE_VALUE;
 exports.MAX_LONGITUDE_VALUE = MAX_LONGITUDE_VALUE;
@@ -14370,6 +14530,7 @@ exports.NOOP_MODIFIER = NOOP_MODIFIER;
 exports.NUMBER_STRING_DENCODER_64 = NUMBER_STRING_DENCODER_64;
 exports.NUMBER_STRING_DENCODER_64_DEFAULT_NEGATIVE_PREFIX = NUMBER_STRING_DENCODER_64_DEFAULT_NEGATIVE_PREFIX;
 exports.NUMBER_STRING_DENCODER_64_DIGITS = NUMBER_STRING_DENCODER_64_DIGITS;
+exports.PDF_MIME_TYPE = PDF_MIME_TYPE;
 exports.PHONE_EXTENSION_NUMBER_REGEX = PHONE_EXTENSION_NUMBER_REGEX;
 exports.PNG_MIME_TYPE = PNG_MIME_TYPE;
 exports.PRIMATIVE_KEY_DENCODER_VALUE = PRIMATIVE_KEY_DENCODER_VALUE;
@@ -14400,6 +14561,7 @@ exports.TOTAL_LONGITUDE_RANGE = TOTAL_LONGITUDE_RANGE;
 exports.TOTAL_SPAN_OF_LONGITUDE = TOTAL_SPAN_OF_LONGITUDE;
 exports.TRAILING_FILE_TYPE_SEPARATORS_REGEX = TRAILING_FILE_TYPE_SEPARATORS_REGEX;
 exports.TRAILING_SLASHES_REGEX = TRAILING_SLASHES_REGEX;
+exports.TXT_MIME_TYPE = TXT_MIME_TYPE;
 exports.TimerCancelledError = TimerCancelledError;
 exports.TypedServiceRegistryInstance = TypedServiceRegistryInstance;
 exports.UNLOADED_PAGE = UNLOADED_PAGE;
@@ -14413,7 +14575,11 @@ exports.UnauthorizedServerErrorResponse = UnauthorizedServerErrorResponse;
 exports.WEBP_MIME_TYPE = WEBP_MIME_TYPE;
 exports.WEBSITE_TLD_DETECTION_REGEX = WEBSITE_TLD_DETECTION_REGEX;
 exports.WEB_PROTOCOL_PREFIX_REGEX = WEB_PROTOCOL_PREFIX_REGEX;
+exports.XLSX_MIME_TYPE = XLSX_MIME_TYPE;
+exports.XML_MIME_TYPE = XML_MIME_TYPE;
+exports.YAML_MIME_TYPE = YAML_MIME_TYPE;
 exports.ZIP_CODE_STRING_REGEX = ZIP_CODE_STRING_REGEX;
+exports.ZIP_FILE_MIME_TYPE = ZIP_FILE_MIME_TYPE;
 exports.addHttpToUrl = addHttpToUrl;
 exports.addLatLngPoints = addLatLngPoints;
 exports.addMilliseconds = addMilliseconds;
@@ -14436,6 +14602,7 @@ exports.allObjectsAreEqual = allObjectsAreEqual;
 exports.allValuesAreMaybeNot = allValuesAreMaybeNot;
 exports.allValuesAreNotMaybe = allValuesAreNotMaybe;
 exports.allowValueOnceFilter = allowValueOnceFilter;
+exports.applicationFileExtensionForMimeType = applicationFileExtensionForMimeType;
 exports.applyBestFit = applyBestFit;
 exports.applySplitStringTreeWithMultipleValues = applySplitStringTreeWithMultipleValues;
 exports.applyToMultipleFields = applyToMultipleFields;
@@ -14535,7 +14702,9 @@ exports.cutToPrecision = cutToPrecision;
 exports.cutValueToInteger = cutValueToInteger;
 exports.cutValueToPrecision = cutValueToPrecision;
 exports.cutValueToPrecisionFunction = cutValueToPrecisionFunction;
+exports.dateFromDateOrTimeMillisecondsNumber = dateFromDateOrTimeMillisecondsNumber;
 exports.dateFromDateOrTimeNumber = dateFromDateOrTimeNumber;
+exports.dateFromDateOrTimeSecondsNumber = dateFromDateOrTimeSecondsNumber;
 exports.dateFromLogicalDate = dateFromLogicalDate;
 exports.dateFromMinuteOfDay = dateFromMinuteOfDay;
 exports.dateOrMillisecondsToDate = dateOrMillisecondsToDate;
@@ -14558,6 +14727,7 @@ exports.dencodeBitwiseSet = dencodeBitwiseSet;
 exports.depthFirstExploreTreeTraversalFactoryFunction = depthFirstExploreTreeTraversalFactoryFunction;
 exports.diffLatLngBoundPoints = diffLatLngBoundPoints;
 exports.diffLatLngPoints = diffLatLngPoints;
+exports.documentFileExtensionForMimeType = documentFileExtensionForMimeType;
 exports.dollarAmountString = dollarAmountString;
 exports.dollarAmountStringWithUnitFunction = dollarAmountStringWithUnitFunction;
 exports.e164PhoneNumberExtensionPair = e164PhoneNumberExtensionPair;
@@ -14584,6 +14754,7 @@ exports.expirationDetails = expirationDetails;
 exports.exploreTreeFunction = exploreTreeFunction;
 exports.exponentialPromiseRateLimiter = exponentialPromiseRateLimiter;
 exports.extendLatLngBound = extendLatLngBound;
+exports.fileExtensionForMimeType = fileExtensionForMimeType;
 exports.filterAndMapFunction = filterAndMapFunction;
 exports.filterEmptyArrayValues = filterEmptyArrayValues;
 exports.filterEmptyPojoValues = filterEmptyPojoValues;
@@ -14694,6 +14865,7 @@ exports.hashSetForIndexed = hashSetForIndexed;
 exports.hourToFractionalHour = hourToFractionalHour;
 exports.hoursAndMinutesToString = hoursAndMinutesToString;
 exports.idBatchFactory = idBatchFactory;
+exports.imageFileExtensionForMimeType = imageFileExtensionForMimeType;
 exports.incrementingNumberFactory = incrementingNumberFactory;
 exports.indexDeltaGroup = indexDeltaGroup;
 exports.indexDeltaGroupFunction = indexDeltaGroupFunction;
@@ -14711,6 +14883,7 @@ exports.invertBooleanReturnFunction = invertBooleanReturnFunction;
 exports.invertDecision = invertDecision;
 exports.invertFilter = invertFilter;
 exports.invertMaybeBoolean = invertMaybeBoolean;
+exports.invertStringRecord = invertStringRecord;
 exports.isAllowed = isAllowed;
 exports.isClassLikeType = isClassLikeType;
 exports.isCompleteUnitedStatesAddress = isCompleteUnitedStatesAddress;
@@ -14895,6 +15068,10 @@ exports.mergeObjectsFunction = mergeObjectsFunction;
 exports.mergeSlashPaths = mergeSlashPaths;
 exports.messageFromError = messageFromError;
 exports.millisecondsToMinutesAndSeconds = millisecondsToMinutesAndSeconds;
+exports.mimeTypeForApplicationFileExtension = mimeTypeForApplicationFileExtension;
+exports.mimeTypeForDocumentFileExtension = mimeTypeForDocumentFileExtension;
+exports.mimeTypeForFileExtension = mimeTypeForFileExtension;
+exports.mimeTypeForImageFileExtension = mimeTypeForImageFileExtension;
 exports.mimetypeForImageType = mimetypeForImageType;
 exports.minAndMaxFunction = minAndMaxFunction;
 exports.minAndMaxIndex = minAndMaxIndex;
@@ -15079,6 +15256,7 @@ exports.setsAreEquivalent = setsAreEquivalent;
 exports.simpleSortValuesFunctionWithSortRef = simpleSortValuesFunctionWithSortRef;
 exports.simplifyWhitespace = simplifyWhitespace;
 exports.slashPathDetails = slashPathDetails;
+exports.slashPathDirectoryTree = slashPathDirectoryTree;
 exports.slashPathFactory = slashPathFactory;
 exports.slashPathFolder = slashPathFolder;
 exports.slashPathFolderFactory = slashPathFolderFactory;
@@ -15165,6 +15343,11 @@ exports.uniqueCaseInsensitiveStringsSet = uniqueCaseInsensitiveStringsSet;
 exports.uniqueKeys = uniqueKeys;
 exports.uniqueModels = uniqueModels;
 exports.unitedStatesAddressString = unitedStatesAddressString;
+exports.unixDateTimeSecondsNumberForNow = unixDateTimeSecondsNumberForNow;
+exports.unixDateTimeSecondsNumberFromDate = unixDateTimeSecondsNumberFromDate;
+exports.unixDateTimeSecondsNumberFromDateOrTimeNumber = unixDateTimeSecondsNumberFromDateOrTimeNumber;
+exports.unixDateTimeSecondsNumberToDate = unixDateTimeSecondsNumberToDate;
+exports.unixMillisecondsNumberToDate = unixMillisecondsNumberToDate;
 exports.unixTimeNumberForNow = unixTimeNumberForNow;
 exports.unixTimeNumberFromDate = unixTimeNumberFromDate;
 exports.unixTimeNumberFromDateOrTimeNumber = unixTimeNumberFromDateOrTimeNumber;

package/index.esm.js

@@ -8066,6 +8066,20 @@ function cssClassesSet(cssClasses) {
   return result;
 }
 
+/**
+ * Inverts a string record, inverting the key and value of each entry in the record.
+ *
+ * @param record
+ * @returns
+ */
+function invertStringRecord(record) {
+  const inverted = {};
+  Object.entries(record).forEach(([key, value]) => {
+    inverted[value] = key;
+  });
+  return inverted;
+}
+
 const JPEG_MIME_TYPE = 'image/jpeg';
 const PNG_MIME_TYPE = 'image/png';
 const WEBP_MIME_TYPE = 'image/webp';
@@ -8074,37 +8088,82 @@ const HEIF_MIME_TYPE = 'image/heif';
 const TIFF_MIME_TYPE = 'image/tiff';
 const SVG_MIME_TYPE = 'image/svg+xml';
 const RAW_MIME_TYPE = 'image/raw';
-function mimetypeForImageType(imageType) {
-  let result = undefined;
-  switch (imageType) {
-    case 'jpeg':
-    case 'jpg':
-      result = JPEG_MIME_TYPE;
-      break;
-    case 'png':
-      result = PNG_MIME_TYPE;
-      break;
-    case 'webp':
-      result = WEBP_MIME_TYPE;
-      break;
-    case 'gif':
-      result = GIF_MIME_TYPE;
-      break;
-    case 'svg':
-      result = SVG_MIME_TYPE;
-      break;
-    case 'raw':
-      result = RAW_MIME_TYPE;
-      break;
-    case 'tiff':
-      result = TIFF_MIME_TYPE;
-      break;
-    case 'heif':
-      result = HEIF_MIME_TYPE;
-      break;
-  }
+const IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD = {
+  jpeg: JPEG_MIME_TYPE,
+  jpg: JPEG_MIME_TYPE,
+  png: PNG_MIME_TYPE,
+  webp: WEBP_MIME_TYPE,
+  gif: GIF_MIME_TYPE,
+  svg: SVG_MIME_TYPE,
+  raw: RAW_MIME_TYPE,
+  heif: HEIF_MIME_TYPE,
+  tiff: TIFF_MIME_TYPE
+};
+const IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = invertStringRecord(IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD);
+function mimeTypeForImageFileExtension(extension) {
+  return extension ? IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD[extension] : undefined;
+}
+function imageFileExtensionForMimeType(mimeType) {
+  return mimeType ? IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD[mimeType] : undefined;
+}
+const PDF_MIME_TYPE = 'application/pdf';
+const DOCX_MIME_TYPE = 'application/vnd.openxmlformats-officedocument.wordprocessingml.document';
+const XLSX_MIME_TYPE = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet';
+const TXT_MIME_TYPE = 'text/plain';
+const CSV_MIME_TYPE = 'text/csv';
+const HTML_MIME_TYPE = 'text/html';
+const XML_MIME_TYPE = 'application/xml';
+const JSON_MIME_TYPE = 'application/json';
+const YAML_MIME_TYPE = 'application/yaml';
+const MARKDOWN_MIME_TYPE = 'text/markdown';
+const DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD = {
+  pdf: PDF_MIME_TYPE,
+  docx: DOCX_MIME_TYPE,
+  xlsx: XLSX_MIME_TYPE,
+  txt: TXT_MIME_TYPE,
+  csv: CSV_MIME_TYPE,
+  html: HTML_MIME_TYPE,
+  xml: XML_MIME_TYPE,
+  json: JSON_MIME_TYPE,
+  yaml: YAML_MIME_TYPE,
+  md: MARKDOWN_MIME_TYPE
+};
+const DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = invertStringRecord(DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD);
+function mimeTypeForDocumentFileExtension(extension) {
+  return extension ? DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD[extension] : undefined;
+}
+/**
+ * Returns the document file extension for the given mimetype, or undefined if the mimetype is not known/recognized.
+ *
+ * @param mimeType The mimetype to get the document file extension for.
+ * @returns The document file extension for the given mimetype, or undefined if the mimetype is not known.
+ */
+function documentFileExtensionForMimeType(mimeType) {
+  return mimeType ? DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD[mimeType] : undefined;
+}
+const ZIP_FILE_MIME_TYPE = 'application/zip';
+const APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD = {
+  zip: ZIP_FILE_MIME_TYPE
+};
+const APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD = invertStringRecord(APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD);
+function mimeTypeForApplicationFileExtension(extension) {
+  return extension ? APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD[extension] : undefined;
+}
+function applicationFileExtensionForMimeType(mimeType) {
+  return mimeType ? APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD[mimeType] : undefined;
+}
+function mimeTypeForFileExtension(extension) {
+  const result = mimeTypeForImageFileExtension(extension) ?? mimeTypeForDocumentFileExtension(extension);
+  return result;
+}
+function fileExtensionForMimeType(mimeType) {
+  const result = imageFileExtensionForMimeType(mimeType) ?? documentFileExtensionForMimeType(mimeType) ?? applicationFileExtensionForMimeType(mimeType);
   return result;
 }
+/**
+ * @deprecated Use mimeTypeForImageFileExtension instead.
+ */
+const mimetypeForImageType = mimeTypeForImageFileExtension;
 
 /**
  * Creates a CharacterPrefixSuffixInstance
@@ -10700,6 +10759,24 @@ function monthDaySlashDateToDateString(slashDate) {
   const result = `${year}-${month}-${day}`;
   return result;
 }
+function dateFromDateOrTimeMillisecondsNumber(input) {
+  if (input == null) {
+    return input;
+  } else if (isDate(input)) {
+    return input;
+  } else {
+    return unixMillisecondsNumberToDate(input);
+  }
+}
+/**
+ * Converts a unix timestamp number to a Date object.
+ *
+ * @param dateTimeNumber - Unix timestamp number to convert
+ * @returns Date object if timestamp is valid, null/undefined if timestamp is null/undefined
+ */
+function unixMillisecondsNumberToDate(dateTimeNumber) {
+  return dateTimeNumber != null ? new Date(dateTimeNumber) : dateTimeNumber;
+}
 /**
  * Converts the input DateOrMilliseconds to a Date.
  *
@@ -11408,11 +11485,11 @@ function objectIsEmpty(obj) {
  * @param input - Date object or unix timestamp number to convert
  * @returns Unix timestamp number if input is valid, null/undefined if input is null/undefined
  */
-function unixTimeNumberFromDateOrTimeNumber(input) {
+function unixDateTimeSecondsNumberFromDateOrTimeNumber(input) {
   if (input == null) {
     return input;
   } else if (isDate(input)) {
-    return unixTimeNumberFromDate(input);
+    return unixDateTimeSecondsNumberFromDate(input);
   } else {
     return input;
   }
@@ -11422,19 +11499,19 @@ function unixTimeNumberFromDateOrTimeNumber(input) {
  *
  * @returns Current time as unix timestamp number
  */
-function unixTimeNumberForNow() {
-  return unixTimeNumberFromDate(new Date());
+function unixDateTimeSecondsNumberForNow() {
+  return unixDateTimeSecondsNumberFromDate(new Date());
 }
-function unixTimeNumberFromDate(date) {
+function unixDateTimeSecondsNumberFromDate(date) {
   return date != null ? Math.ceil(date.getTime() / 1000) : date;
 }
-function dateFromDateOrTimeNumber(input) {
+function dateFromDateOrTimeSecondsNumber(input) {
   if (input == null) {
     return input;
   } else if (isDate(input)) {
     return input;
   } else {
-    return unixTimeNumberToDate(input);
+    return unixDateTimeSecondsNumberToDate(input);
   }
 }
 /**
@@ -11443,9 +11520,29 @@ function dateFromDateOrTimeNumber(input) {
  * @param dateTimeNumber - Unix timestamp number to convert
  * @returns Date object if timestamp is valid, null/undefined if timestamp is null/undefined
  */
-function unixTimeNumberToDate(dateTimeNumber) {
+function unixDateTimeSecondsNumberToDate(dateTimeNumber) {
   return dateTimeNumber != null ? new Date(dateTimeNumber * 1000) : dateTimeNumber;
 }
+/**
+ * @deprecated use unixDateTimeSecondsNumberFromDateOrTimeNumber instead
+ */
+const unixTimeNumberFromDateOrTimeNumber = unixDateTimeSecondsNumberFromDateOrTimeNumber;
+/**
+ * @deprecated use unixDateTimeSecondsNumberForNow instead
+ */
+const unixTimeNumberForNow = unixDateTimeSecondsNumberForNow;
+/**
+ * @deprecated use unixDateTimeSecondsNumberFromDate instead
+ */
+const unixTimeNumberFromDate = unixDateTimeSecondsNumberFromDate;
+/**
+ * @deprecated use dateFromDateOrTimeSecondsNumber instead
+ */
+const dateFromDateOrTimeNumber = dateFromDateOrTimeSecondsNumber;
+/**
+ * @deprecated use unixDateTimeSecondsNumberToDate instead
+ */
+const unixTimeNumberToDate = unixDateTimeSecondsNumberToDate;
 
 /**
  * Returns expiration details for the input configuration.
@@ -11464,7 +11561,7 @@ function expirationDetails(input) {
     defaultExpiresFromDateToNow,
     expiresIn
   } = input;
-  const parsedExpiresFromDate = expiresFromDate != null ? dateFromDateOrTimeNumber(expiresFromDate) : null;
+  const parsedExpiresFromDate = expiresFromDate != null ? dateFromDateOrTimeMillisecondsNumber(expiresFromDate) : null;
   function getNow(nowOverride) {
     const now = nowOverride ?? inputNow ?? new Date();
     return now;
@@ -14276,4 +14373,56 @@ async function iterateFilteredPages(inputPage, loadFn, iterFn) {
   return count;
 }
 
-export { ALL_DOUBLE_SLASHES_REGEX, ALL_SLASHES_REGEX, ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX, ASSERTION_ERROR_CODE, ASSERTION_HANDLER, AUTH_ADMIN_ROLE, AUTH_ONBOARDED_ROLE, AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE, AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE, AUTH_TOS_SIGNED_ROLE, AUTH_USER_ROLE, AbstractUniqueModel, Assert, AssertMax, AssertMin, AssertionError, AssertionIssueHandler, BooleanStringKeyArrayUtility, BooleanStringKeyArrayUtilityInstance, CATCH_ALL_HANDLE_RESULT_KEY, COMMA_JOINER, CUT_VALUE_TO_ZERO_PRECISION, DASH_CHARACTER_PREFIX_INSTANCE, DATE_NOW_VALUE, DEFAULT_CUT_STRING_END_TEXT, DEFAULT_LAT_LNG_STRING_VALUE, DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG, DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG, DEFAULT_READABLE_ERROR_CODE, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT, DEFAULT_SLASH_PATH_PATH_MATCHER_NON_MATCHING_FILL_VALUE, DEFAULT_UNKNOWN_MODEL_TYPE_STRING, DOLLAR_AMOUNT_PRECISION, DOLLAR_AMOUNT_STRING_REGEX, DataDoesNotExistError, DataIsExpiredError, Day, DestroyFunctionObject, E164PHONE_NUMBER_REGEX, E164PHONE_NUMBER_WITH_EXTENSION_REGEX, E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX, ExploreTreeVisitNodeDecision, FINAL_PAGE, FIRST_PAGE, FRACTIONAL_HOURS_PRECISION_FUNCTION, FlattenTreeAddNodeDecision, FullStorageObject, GIF_MIME_TYPE, HAS_PORT_NUMBER_REGEX, HAS_WEBSITE_DOMAIN_NAME_REGEX, HEIF_MIME_TYPE, HOURS_IN_DAY, HTTP_OR_HTTPS_REGEX, HashSet, ISO8601_DAY_STRING_REGEX, ISO8601_DAY_STRING_START_REGEX, ISO_8601_DATE_STRING_REGEX, JPEG_MIME_TYPE, KeyValueTypleValueFilter, LAT_LNG_PATTERN, LAT_LNG_PATTERN_MAX_PRECISION, LAT_LONG_100KM_PRECISION, LAT_LONG_100M_PRECISION, LAT_LONG_10CM_PRECISION, LAT_LONG_10KM_PRECISION, LAT_LONG_10M_PRECISION, LAT_LONG_1CM_PRECISION, LAT_LONG_1KM_PRECISION, LAT_LONG_1MM_PRECISION, LAT_LONG_1M_PRECISION, LAT_LONG_GRAINS_OF_SAND_PRECISION, LEADING_SLASHES_REGEX, MAP_IDENTITY, MAX_BITWISE_SET_SIZE, MAX_LATITUDE_VALUE, MAX_LONGITUDE_VALUE, MINUTES_IN_DAY, MINUTES_IN_HOUR, MINUTE_OF_DAY_MAXMIMUM, MINUTE_OF_DAY_MINIUMUM, MIN_LATITUDE_VALUE, MIN_LONGITUDE_VALUE, MONTH_DAY_SLASH_DATE_STRING_REGEX, MS_IN_DAY, MS_IN_HOUR, MS_IN_MINUTE, MS_IN_SECOND, MemoryStorageInstance, ModelRelationUtility, NOOP_MODIFIER, NUMBER_STRING_DENCODER_64, NUMBER_STRING_DENCODER_64_DEFAULT_NEGATIVE_PREFIX, NUMBER_STRING_DENCODER_64_DIGITS, PHONE_EXTENSION_NUMBER_REGEX, PNG_MIME_TYPE, PRIMATIVE_KEY_DENCODER_VALUE, PageCalculator, PropertyDescriptorUtility, RAW_MIME_TYPE, REGEX_SPECIAL_CHARACTERS, REGEX_SPECIAL_CHARACTERS_SET, RelationChange, SECONDS_IN_MINUTE, SHARED_MEMORY_STORAGE, SLASH_PATH_FILE_TYPE_SEPARATOR, SLASH_PATH_SEPARATOR, SORT_VALUE_EQUAL, SORT_VALUE_GREATER_THAN, SORT_VALUE_LESS_THAN, SPACE_JOINER, SPLIT_STRING_TREE_NODE_ROOT_VALUE, SVG_MIME_TYPE, ServerErrorResponse, SetDeltaChange, SimpleStorageObject, SlashPathPathMatcherPartCode, StorageObject, StorageObjectUtility, StoredDataError, SyncState, TIFF_MIME_TYPE, TOTAL_LATITUDE_RANGE, TOTAL_LONGITUDE_RANGE, TOTAL_SPAN_OF_LONGITUDE, TRAILING_FILE_TYPE_SEPARATORS_REGEX, TRAILING_SLASHES_REGEX, TimeAM, TimerCancelledError, TypedServiceRegistryInstance, UNLOADED_PAGE, UNSET_INDEX_NUMBER, US_STATE_CODE_STRING_REGEX, UTC_DATE_STRING_REGEX, UTC_TIMEZONE_STRING, UTF_8_START_CHARACTER, UTF_PRIVATE_USAGE_AREA_START, UnauthorizedServerErrorResponse, WEBP_MIME_TYPE, WEBSITE_TLD_DETECTION_REGEX, WEB_PROTOCOL_PREFIX_REGEX, ZIP_CODE_STRING_REGEX, addHttpToUrl, addLatLngPoints, addMilliseconds, addModifiers, addPlusPrefixToNumber, addPrefix, addPrefixFunction, addSuffix, addSuffixFunction, addToSet, addToSetCopy, addToSplitStringTree, addTrailingSlash, allFalsyOrEmptyKeys, allIndexesInIndexRange, allKeyValueTuples, allMaybeSoKeys, allNonUndefinedKeys, allObjectsAreEqual, allValuesAreMaybeNot, allValuesAreNotMaybe, allowValueOnceFilter, applyBestFit, applySplitStringTreeWithMultipleValues, applyToMultipleFields, approximateTimerEndDate, areEqualContext, areEqualPOJOValues, areEqualPOJOValuesUsingPojoFilter, arrayContainsDuplicateValue, arrayContentsDiffer, arrayDecision, arrayDecisionFunction, arrayFactory, arrayInputFactory, arrayToLowercase, arrayToMap, arrayToObject, arrayToUppercase, asArray, asDecisionFunction, asGetter, asIndexRangeCheckFunctionConfig, asIterable, asMinuteOfDay, asNumber, asObjectCopyFactory, asPromise, asSet, assignValuesToPOJO, assignValuesToPOJOFunction, authClaims, authRoleClaimsService, authRolesSetHasRoles, baseWebsiteUrl, batch, batchCalc, bitwiseObjectDencoder, bitwiseObjectEncoder, bitwiseObjectdecoder, bitwiseSetDecoder, bitwiseSetDencoder, booleanFactory, booleanKeyArrayUtility, boundNumber, boundNumberFunction, boundToRectangle, breadthFirstExploreTreeTraversalFactoryFunction, build, cachedGetter, calculateExpirationDate, capLatValue, capitalizeFirstLetter, caseInsensitiveFilterByIndexOfDecisionFactory, caseInsensitiveString, catchAllHandlerKey, chainMapFunction, chainMapSameFunctions, characterPrefixSuffixInstance, checkAnyHaveExpired, checkAtleastOneNotExpired, coerceToEmailParticipants, combineMaps, compareEqualityWithValueFromItemsFunction, compareEqualityWithValueFromItemsFunctionFactory, compareFnOrder, compareWithMappedValuesFunction, computeNextFractionalHour, computeNextFreeIndexFunction, computeNextFreeIndexOnSortedValuesFunction, concatArrays, concatArraysUnique, containsAllStringsAnyCase, containsAllValues, containsAnyStringAnyCase, containsAnyValue, containsAnyValueFromSet, containsNoValueFromSet, containsNoneOfValue, containsStringAnyCase, convertEmailParticipantStringToParticipant, convertMaybeToArray, convertParticipantToEmailParticipantString, convertToArray, copyArray, copyField, copyLatLngBound, copyLatLngPoint, copyObject, copySetAndDo, countAllInNestedArray, countPOJOKeys, countPOJOKeysFunction, cronExpressionRepeatingEveryNMinutes, cssClassesSet, cutString, cutStringFunction, cutToPrecision, cutValueToInteger, cutValueToPrecision, cutValueToPrecisionFunction, dateFromDateOrTimeNumber, dateFromLogicalDate, dateFromMinuteOfDay, dateOrMillisecondsToDate, dateToHoursAndMinutes, dateToMinuteOfDay, dayOfWeek, daysOfWeekArray, daysOfWeekFromEnabledDays, daysOfWeekNameFunction, daysOfWeekNameMap, decisionFunction, decodeHashedValues, decodeHashedValuesWithDecodeMap, decodeModelKeyTypePair, defaultFilterFromPOJOFunctionNoCopy, defaultForwardFunctionFactory, defaultLatLngPoint, defaultLatLngString, dencodeBitwiseSet, depthFirstExploreTreeTraversalFactoryFunction, diffLatLngBoundPoints, diffLatLngPoints, dollarAmountString, dollarAmountStringWithUnitFunction, e164PhoneNumberExtensionPair, e164PhoneNumberFromE164PhoneNumberExtensionPair, enabledDaysFromDaysOfWeek, encodeBitwiseSet, encodeModelKeyTypePair, errorMessageContainsString, errorMessageContainsStringFunction, escapeStringCharactersFunction, escapeStringForRegex, excludeValues, excludeValuesFromArray, excludeValuesFromSet, existsInIterable, expandArrayMapTuples, expandArrayValueTuples, expandFlattenTreeFunction, expandIndexSet, expandSlashPathPathMatcherPartToDecisionFunctions, expandTreeFunction, expandTrees, expirationDetails, exploreTreeFunction, exponentialPromiseRateLimiter, extendLatLngBound, filterAndMapFunction, filterEmptyArrayValues, filterEmptyPojoValues, filterEmptyValues, filterFalsyAndEmptyValues, filterFromIterable, filterFromPOJO, filterFromPOJOFunction, filterKeyValueTupleFunction, filterKeyValueTuples, filterKeyValueTuplesFunction, filterKeyValueTuplesInputToFilter, filterKeysOnPOJOFunction, filterMaybeArrayFunction, filterMaybeArrayValues, filterMaybeValues, filterNullAndUndefinedValues, filterOnlyUndefinedValues, filterTuplesOnPOJOFunction, filterUndefinedValues, filterUniqueByIndex, filterUniqueCaseInsensitiveStrings, filterUniqueFunction, filterUniqueTransform, filterUniqueValues, filterValuesByDistance, filterValuesByDistanceNoOrder, filterValuesToSet, filterValuesUsingSet, filteredPage, findAllCharacterOccurences, findAllCharacterOccurencesFunction, findBest, findBestIndexMatch, findBestIndexMatchFunction, findBestIndexSetPair, findBestSplitStringTreeChildMatch, findBestSplitStringTreeChildMatchPath, findBestSplitStringTreeMatch, findBestSplitStringTreeMatchPath, findFirstCharacterOccurence, findInIterable, findIndexOfFirstDuplicateValue, findItemsByIndex, findNext, findPOJOKeys, findPOJOKeysFunction, findStringsRegexString, findToIndexSet, findValuesFrom, firstAndLastCharacterOccurrence, firstAndLastValue, firstValue, firstValueFromIterable, fitToIndexRangeFunction, fixExtraQueryParameters, fixMultiSlashesInSlashPath, flattenArray, flattenArrayOrValueArray, flattenArrayToSet, flattenArrayUnique, flattenArrayUniqueCaseInsensitiveStrings, flattenTree, flattenTreeToArray, flattenTreeToArrayFunction, flattenTrees, flattenWhitespace, forEachInIterable, forEachKeyValue, forEachKeyValueOnPOJOFunction, forEachWithArray, forwardFunction, fractionalHoursToMinutes, generateIfDoesNotExist, getArrayNextIndex, getBaseLog, getDayOffset, getDayTomorrow, getDayYesterday, getDaysOfWeekNames, getFunctionType, getNextDay, getNextPageNumber, getOverlappingRectangle, getPageNumber, getPreviousDay, getValueFromGetter, groupValues, handlerBindAccessor, handlerConfigurerFactory, handlerFactory, handlerMappedSetFunction, handlerMappedSetFunctionFactory, handlerSetFunction, hasDifferentStringsNoCase, hasDifferentValues, hasHttpPrefix, hasNonNullValue, hasPortNumber, hasSameTimezone, hasSameValues, hasValueFunction, hasValueOrNotEmpty, hasValueOrNotEmptyObject, hasWebsiteDomain, hasWebsiteTopLevelDomain, hashSetForIndexed, hourToFractionalHour, hoursAndMinutesToString, idBatchFactory, incrementingNumberFactory, indexDeltaGroup, indexDeltaGroupFunction, indexRange, indexRangeCheckFunction, indexRangeCheckReaderFunction, indexRangeForArray, indexRangeOverlapsIndexRange, indexRangeOverlapsIndexRangeFunction, indexRangeReaderPairFactory, indexRefMap, indexedValuesArrayAccessorFactory, insertIntoBooleanKeyArray, invertBooleanReturnFunction, invertDecision, invertFilter, invertMaybeBoolean, isAllowed, isClassLikeType, isCompleteUnitedStatesAddress, isConsideredUtcTimezoneString, isDate, isDefaultLatLngPoint, isDefaultLatLngPointValue, isDefaultReadableError, isDefinedAndNotFalse, isDollarAmountString, isE164PhoneNumber, isE164PhoneNumberWithExtension, isEmptyIterable, isEqualContext, isEqualDate, isEqualToValueDecisionFunction, isEvenNumber, isFalseBooleanKeyArray, isFinalPage, isGetter, isISO8601DateString, isISO8601DayString, isISO8601DayStringStart, isInAllowedDaysOfWeekSet, isInNumberBoundFunction, isInSetDecisionFunction, isIndexNumberInIndexRange, isIndexNumberInIndexRangeFunction, isIndexRangeInIndexRange, isIndexRangeInIndexRangeFunction, isIterable, isKnownHttpWebsiteProtocol, isLatLngBound, isLatLngBoundWithinLatLngBound, isLatLngPoint, isLatLngPointWithinLatLngBound, isLatLngString, isLogicalDateStringCode, isMapIdentityFunction, isMaybeNot, isMaybeNotOrTrue, isMaybeSo, isMinuteOfDay, isModelKey, isMonthDaySlashDate, isNonClassFunction, isNotFalse, isNotNullOrEmptyString, isNumberDivisibleBy, isObjectWithConstructor, isOddNumber, isPast, isPromise, isPromiseLike, isSameLatLngBound, isSameLatLngPoint, isSameNonNullValue, isSameVector, isSelectedDecisionFunctionFactory, isSelectedIndexDecisionFunction, isServerError, isSlashPathFile, isSlashPathFolder, isSlashPathTypedFile, isStandardInternetAccessibleWebsiteUrl, isStringOrTrue, isThrottled, isTrueBooleanKeyArray, isUTCDateString, isUnderThreshold, isUniqueKeyedFunction, isUsStateCodeString, isValidLatLngPoint, isValidLatitude, isValidLongitude, isValidNumberBound, isValidPhoneExtensionNumber, isValidSlashPath, isWebsiteUrl, isWebsiteUrlWithPrefix, isWithinLatLngBoundFunction, isolateSlashPath, isolateSlashPathFunction, isolateWebsitePathFunction, itemCountForBatchIndex, iterableToArray, iterableToMap, iterableToSet, iterablesAreSetEquivalent, iterate, iterateFilteredPages, joinHostAndPort, joinStrings, joinStringsWithCommas, joinStringsWithSpaces, keepCharactersAfterFirstCharacterOccurence, keepCharactersAfterFirstCharacterOccurenceFunction, keepFromSetCopy, keepValuesFromArray, keepValuesFromSet, keyValueMapFactory, labeledValueMap, lastValue, latLngBound, latLngBoundCenterPoint, latLngBoundEastBound, latLngBoundFromInput, latLngBoundFullyWrapsMap, latLngBoundFunction, latLngBoundNorthBound, latLngBoundNorthEastPoint, latLngBoundNorthWestPoint, latLngBoundOverlapsLatLngBound, latLngBoundSouthBound, latLngBoundSouthEastPoint, latLngBoundSouthWestPoint, latLngBoundStrictlyWrapsMap, latLngBoundTuple, latLngBoundTupleFunction, latLngBoundWestBound, latLngBoundWrapsMap, latLngDataPointFunction, latLngPoint, latLngPointFromString, latLngPointFunction, latLngPointPrecisionFunction, latLngString, latLngStringFunction, latLngTuple, latLngTupleFunction, limitArray, lonLatTuple, lowercaseFirstLetter, mailToUrlString, makeBestFit, makeCopyModelFieldFunction, makeDateMonthForMonthOfYear, makeDefaultNonConcurrentTaskKeyFactory, makeGetter, makeHandler, makeHashDecodeMap, makeKeyPairs, makeModelConversionFieldValuesFunction, makeModelMap, makeModelMapFunctions, makeMultiModelKeyMap, makeTimer, makeValuesGroupMap, makeWithFactory, makeWithFactoryInput, mapArrayFunction, mapFunctionOutput, mapFunctionOutputPair, mapGetter, mapGetterFactory, mapIdentityFunction, mapIterable, mapKeysIntersectionObjectToArray, mapMaybeFunction, mapObjectKeysFunction, mapObjectKeysToLowercase, mapObjectMap, mapObjectMapFunction, mapObjectToTargetObject, mapPromiseOrValue, mapToObject, mapToTuples, mapValuesToSet, mappedUseAsyncFunction, mappedUseFunction, mapsHaveSameKeys, maybeMergeModelModifiers, maybeMergeModifiers, maybeModifierMapToFunction, maybeSet, mergeArrays, mergeArraysIntoArray, mergeFilterFunctions, mergeModifiers, mergeObjects, mergeObjectsFunction, mergeSlashPaths, messageFromError, millisecondsToMinutesAndSeconds, mimetypeForImageType, minAndMaxFunction, minAndMaxIndex, minAndMaxIndexFunction, minAndMaxIndexItemsFunction, minAndMaxNumber, minutesToFractionalHours, minutesToHoursAndMinutes, modelFieldConversions, modelFieldMapFunction, modelFieldMapFunctions, modelTypeDataPairFactory, modifier, modifierMapToFunction, modifyModelMapFunction, modifyModelMapFunctions, monthDaySlashDateToDateString, monthOfYearFromDate, monthOfYearFromDateMonth, monthOfYearFromUTCDate, multiKeyValueMapFactory, multiValueMapBuilder, neMostLatLngPoint, nearestDivisibleValues, numberStringDencoder, numberStringDencoderDecodedNumberValueFunction, numberStringDencoderEncodedStringValueFunction, numberStringDencoderFunction, objectCopyFactory, objectDeltaArrayCompressor, objectFieldEqualityChecker, objectFlatMergeMatrix, objectHasKey, objectHasKeys, objectHasNoKeys, objectIsEmpty, objectKeyEqualityComparatorFunction, objectKeysEqualityComparatorFunction, objectMergeMatrix, objectToMap, objectToTuples, overlapsLatLngBoundFunction, overrideInObject, overrideInObjectFunctionFactory, padStartFunction, pairGroupValues, parseISO8601DayStringToUTCDate, partialServerError, passThrough, percentNumberFromDecimal, percentNumberToDecimal, performAsyncTask, performAsyncTasks, performBatchLoop, performMakeLoop, performTaskCountLoop, performTaskLoop, performTasksFromFactoryInParallelFunction, performTasksInParallel, performTasksInParallelFunction, pickOneRandomly, poll, primativeKeyDencoder, primativeKeyDencoderMap, primativeKeyStringDencoder, primativeValuesDelta, promiseReference, protectedFactory, pushArrayItemsIntoArray, pushElementOntoArray, pushItemOrArrayItemsIntoArray, randomArrayFactory, randomArrayIndex, randomBoolean, randomEmailFactory, randomFromArrayFactory, randomLatLngFactory, randomLatLngFromCenterFactory, randomNumber, randomNumberFactory, randomPhoneNumberFactory, randomPickFactory, range, rangedIndexedValuesArrayAccessorFactory, rangedIndexedValuesArrayAccessorInfoFactory, readBooleanKeySafetyWrap, readDomainFromEmailAddress, readDomainsFromEmailAddresses, readEmailDomainFromUrlOrEmailAddress, readIndexNumber, readKeysFrom, readKeysFromFilterUniqueFunctionAdditionalKeys, readKeysFromFilterUniqueFunctionAdditionalKeysInput, readKeysFunction, readKeysSetFrom, readKeysSetFunction, readKeysToMap, readModelKey, readModelKeyFromObject, readModelKeys, readModelKeysFromObjects, readMultipleKeysToMap, readPortNumber, readUniqueModelKey, readWebsiteProtocol, readableError, readableStreamToBase64, readableStreamToBuffer, readableStreamToStringFunction, rectangleOverlapsRectangle, reduceBooleansFn, reduceBooleansWithAnd, reduceBooleansWithAndFn, reduceBooleansWithOr, reduceBooleansWithOrFn, reduceNumbers, reduceNumbersFn, reduceNumbersWithAdd, reduceNumbersWithAddFn, reduceNumbersWithMax, reduceNumbersWithMaxFn, reduceNumbersWithMin, reduceNumbersWithMinFn, removeByKeyFromBooleanKeyArray, removeCharactersAfterFirstCharacterOccurence, removeCharactersAfterFirstCharacterOccurenceFunction, removeExtensionFromPhoneNumber, removeFromBooleanKeyArray, removeFromSet, removeFromSetCopy, removeHttpFromUrl, removeModelsWithKey, removeModelsWithSameKey, removeModifiers, removeTrailingFileTypeSeparators, removeTrailingSlashes, removeValuesAtIndexesFromArrayCopy, removeWebProtocolPrefix, repeatString, replaceCharacterAtIndexIf, replaceCharacterAtIndexWith, replaceInvalidFilePathTypeSeparatorsInSlashPath, replaceInvalidFilePathTypeSeparatorsInSlashPathFunction, replaceLastCharacterIf, replaceLastCharacterIfIsFunction, replaceMultipleFilePathsInSlashPath, replaceStringsFunction, requireModelKey, resetPeriodPromiseRateLimiter, restoreOrder, restoreOrderWithValues, reverseCompareFn, roundNumberToStepFunction, roundNumberUpToStep, roundToPrecision, roundToPrecisionFunction, roundingFunction, runAsyncTaskForValue, runAsyncTasksForValues, runNamedAsyncTasks, runNamedAsyncTasksFunction, safeCompareEquality, safeEqualityComparatorFunction, safeFindBestIndexMatch, searchStringFilterFunction, secondsToMinutesAndSeconds, separateValues, separateValuesToSets, sequentialIncrementingNumberStringModelIdFactory, serverError, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, setDeltaChangeKeys, setDeltaFunction, setHasValueFunction, setIncludes, setIncludesFunction, setKeysOnMap, setWebProtocolPrefix, setsAreEquivalent, simpleSortValuesFunctionWithSortRef, simplifyWhitespace, slashPathDetails, slashPathFactory, slashPathFolder, slashPathFolderFactory, slashPathInvalidError, slashPathName, slashPathParts, slashPathPathMatcher, slashPathPathMatcherConfig, slashPathStartTypeFactory, slashPathSubPathMatcher, slashPathType, slashPathValidationFactory, sliceIndexRangeFunction, sliceStringFunction, sortAscendingIndexNumberRefFunction, sortByIndexAscendingCompareFunction, sortByIndexRangeAscendingCompareFunction, sortByLabelFunction, sortByNumberFunction, sortByStringFunction, sortCompareNumberFunction, sortNumbersAscendingFunction, sortValues, sortValuesFunctionOrMapIdentityWithSortRef, sortValuesFunctionWithSortRef, spaceSeparatedCssClasses, splitCommaSeparatedString, splitCommaSeparatedStringToSet, splitFront, splitJoinNameString, splitJoinRemainder, splitStringAtFirstCharacterOccurence, splitStringAtFirstCharacterOccurenceFunction, splitStringAtIndex, splitStringTreeFactory, startOfDayForSystemDateInUTC, startOfDayForUTCDateInUTC, stepsFromIndex, stepsFromIndexFunction, stringCharactersToIndexRecord, stringContains, stringFactoryFromFactory, stringFromDateFactory, stringFromTimeFactory, stringToBoolean, stringToLowercaseFunction, stringToUppercaseFunction, stringTrimFunction, sumOfIntegersBetween, swMostLatLngPoint, symmetricDifferenceArray, symmetricDifferenceArrayBetweenSets, symmetricDifferenceWithModels, takeFront, takeLast, takeValuesFromIterable, telUrlString, telUrlStringForE164PhoneNumberPair, terminatingFactoryFromArray, throwKeyIsRequired, timePeriodCounter, timer, toAbsoluteSlashPathStartType, toCaseInsensitiveStringArray, toMinuteOfDay, toModelFieldConversions, toModelMapFunctions, toReadableError, toRelativeSlashPathStartType, toggleInSet, toggleInSetCopy, toggleTimerRunning, transformNumberFunction, transformNumberFunctionConfig, transformStringFunction, transformStringFunctionConfig, transformStrings, trimArray, tryWithPromiseFactoriesFunction, typedServiceRegistry, unique, uniqueCaseInsensitiveStrings, uniqueCaseInsensitiveStringsSet, uniqueKeys, uniqueModels, unitedStatesAddressString, unixTimeNumberForNow, unixTimeNumberFromDate, unixTimeNumberFromDateOrTimeNumber, unixTimeNumberToDate, updateMaybeValue, urlWithoutParameters, useAsync, useCallback, useContextFunction, useIterableOrValue, useModelOrKey, usePromise, useValue, validLatLngPoint, validLatLngPointFunction, valueAtIndex, valuesAreBothNullishOrEquivalent, valuesFromPOJO, valuesFromPOJOFunction, vectorMinimumSizeResizeFunction, vectorsAreEqual, waitForMs, websiteDomainAndPathPair, websiteDomainAndPathPairFromWebsiteUrl, websitePathAndQueryPair, websitePathFromWebsiteDomainAndPath, websitePathFromWebsiteUrl, websiteUrlDetails, websiteUrlFromPaths, wrapIndexRangeFunction, wrapLatLngPoint, wrapLngValue, wrapMapFunctionOutput, wrapNumberFunction, wrapTuples, wrapUseAsyncFunction, wrapUseFunction };
+function slashPathDirectoryTree(nodeValues, options) {
+  const {
+    includeChildrenWithMissingParentFolder
+  } = options ?? {};
+  /**
+   * Create all nodes first.
+   */
+  const nodes = nodeValues.map(x => ({
+    depth: x.slashPathDetails.parts.length - 1,
+    value: x
+  }));
+  const nodeMap = new Map();
+  nodes.forEach(node => {
+    // only add typed files to the node map
+    if (!node.value.slashPathDetails.typedFile) {
+      const key = node.value.slashPathDetails.parts.join('/');
+      nodeMap.set(key, node);
+    }
+  });
+  /**
+   * Create the tree second, and add the root children nodes.
+   */
+  const children = [];
+  nodes.forEach(node => {
+    const {
+      slashPathDetails
+    } = node.value;
+    const parts = slashPathDetails.parts;
+    if (parts.length > 1) {
+      const parentParts = parts.slice(0, parts.length - 1);
+      const parentKey = parentParts.join('/');
+      const parent = nodeMap.get(parentKey);
+      if (parent) {
+        if (!parent.children) {
+          parent.children = [];
+        }
+        parent.children.push(node);
+        node.parent = parent;
+      } else if (includeChildrenWithMissingParentFolder) {
+        children.push(node);
+      }
+    } else {
+      children.push(node);
+    }
+  });
+  const root = {
+    depth: -1,
+    children
+  };
+  return root;
+}
+
+export { ALL_DOUBLE_SLASHES_REGEX, ALL_SLASHES_REGEX, ALL_SLASH_PATH_FILE_TYPE_SEPARATORS_REGEX, APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD, APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, ASSERTION_ERROR_CODE, ASSERTION_HANDLER, AUTH_ADMIN_ROLE, AUTH_ONBOARDED_ROLE, AUTH_ROLE_CLAIMS_DEFAULT_CLAIM_VALUE, AUTH_ROLE_CLAIMS_DEFAULT_EMPTY_VALUE, AUTH_TOS_SIGNED_ROLE, AUTH_USER_ROLE, AbstractUniqueModel, Assert, AssertMax, AssertMin, AssertionError, AssertionIssueHandler, BooleanStringKeyArrayUtility, BooleanStringKeyArrayUtilityInstance, CATCH_ALL_HANDLE_RESULT_KEY, COMMA_JOINER, CSV_MIME_TYPE, CUT_VALUE_TO_ZERO_PRECISION, DASH_CHARACTER_PREFIX_INSTANCE, DATE_NOW_VALUE, DEFAULT_CUT_STRING_END_TEXT, DEFAULT_LAT_LNG_STRING_VALUE, DEFAULT_RANDOM_EMAIL_FACTORY_CONFIG, DEFAULT_RANDOM_PHONE_NUMBER_FACTORY_CONFIG, DEFAULT_READABLE_ERROR_CODE, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTERS, DEFAULT_SLASH_PATH_ILLEGAL_CHARACTER_REPLACEMENT, DEFAULT_SLASH_PATH_PATH_MATCHER_NON_MATCHING_FILL_VALUE, DEFAULT_UNKNOWN_MODEL_TYPE_STRING, DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD, DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, DOCX_MIME_TYPE, DOLLAR_AMOUNT_PRECISION, DOLLAR_AMOUNT_STRING_REGEX, DataDoesNotExistError, DataIsExpiredError, Day, DestroyFunctionObject, E164PHONE_NUMBER_REGEX, E164PHONE_NUMBER_WITH_EXTENSION_REGEX, E164PHONE_NUMBER_WITH_OPTIONAL_EXTENSION_REGEX, ExploreTreeVisitNodeDecision, FINAL_PAGE, FIRST_PAGE, FRACTIONAL_HOURS_PRECISION_FUNCTION, FlattenTreeAddNodeDecision, FullStorageObject, GIF_MIME_TYPE, HAS_PORT_NUMBER_REGEX, HAS_WEBSITE_DOMAIN_NAME_REGEX, HEIF_MIME_TYPE, HOURS_IN_DAY, HTML_MIME_TYPE, HTTP_OR_HTTPS_REGEX, HashSet, IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD, IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD, ISO8601_DAY_STRING_REGEX, ISO8601_DAY_STRING_START_REGEX, ISO_8601_DATE_STRING_REGEX, JPEG_MIME_TYPE, JSON_MIME_TYPE, KeyValueTypleValueFilter, LAT_LNG_PATTERN, LAT_LNG_PATTERN_MAX_PRECISION, LAT_LONG_100KM_PRECISION, LAT_LONG_100M_PRECISION, LAT_LONG_10CM_PRECISION, LAT_LONG_10KM_PRECISION, LAT_LONG_10M_PRECISION, LAT_LONG_1CM_PRECISION, LAT_LONG_1KM_PRECISION, LAT_LONG_1MM_PRECISION, LAT_LONG_1M_PRECISION, LAT_LONG_GRAINS_OF_SAND_PRECISION, LEADING_SLASHES_REGEX, MAP_IDENTITY, MARKDOWN_MIME_TYPE, MAX_BITWISE_SET_SIZE, MAX_LATITUDE_VALUE, MAX_LONGITUDE_VALUE, MINUTES_IN_DAY, MINUTES_IN_HOUR, MINUTE_OF_DAY_MAXMIMUM, MINUTE_OF_DAY_MINIUMUM, MIN_LATITUDE_VALUE, MIN_LONGITUDE_VALUE, MONTH_DAY_SLASH_DATE_STRING_REGEX, MS_IN_DAY, MS_IN_HOUR, MS_IN_MINUTE, MS_IN_SECOND, MemoryStorageInstance, ModelRelationUtility, NOOP_MODIFIER, NUMBER_STRING_DENCODER_64, NUMBER_STRING_DENCODER_64_DEFAULT_NEGATIVE_PREFIX, NUMBER_STRING_DENCODER_64_DIGITS, PDF_MIME_TYPE, PHONE_EXTENSION_NUMBER_REGEX, PNG_MIME_TYPE, PRIMATIVE_KEY_DENCODER_VALUE, PageCalculator, PropertyDescriptorUtility, RAW_MIME_TYPE, REGEX_SPECIAL_CHARACTERS, REGEX_SPECIAL_CHARACTERS_SET, RelationChange, SECONDS_IN_MINUTE, SHARED_MEMORY_STORAGE, SLASH_PATH_FILE_TYPE_SEPARATOR, SLASH_PATH_SEPARATOR, SORT_VALUE_EQUAL, SORT_VALUE_GREATER_THAN, SORT_VALUE_LESS_THAN, SPACE_JOINER, SPLIT_STRING_TREE_NODE_ROOT_VALUE, SVG_MIME_TYPE, ServerErrorResponse, SetDeltaChange, SimpleStorageObject, SlashPathPathMatcherPartCode, StorageObject, StorageObjectUtility, StoredDataError, SyncState, TIFF_MIME_TYPE, TOTAL_LATITUDE_RANGE, TOTAL_LONGITUDE_RANGE, TOTAL_SPAN_OF_LONGITUDE, TRAILING_FILE_TYPE_SEPARATORS_REGEX, TRAILING_SLASHES_REGEX, TXT_MIME_TYPE, TimeAM, TimerCancelledError, TypedServiceRegistryInstance, UNLOADED_PAGE, UNSET_INDEX_NUMBER, US_STATE_CODE_STRING_REGEX, UTC_DATE_STRING_REGEX, UTC_TIMEZONE_STRING, UTF_8_START_CHARACTER, UTF_PRIVATE_USAGE_AREA_START, UnauthorizedServerErrorResponse, WEBP_MIME_TYPE, WEBSITE_TLD_DETECTION_REGEX, WEB_PROTOCOL_PREFIX_REGEX, XLSX_MIME_TYPE, XML_MIME_TYPE, YAML_MIME_TYPE, ZIP_CODE_STRING_REGEX, ZIP_FILE_MIME_TYPE, addHttpToUrl, addLatLngPoints, addMilliseconds, addModifiers, addPlusPrefixToNumber, addPrefix, addPrefixFunction, addSuffix, addSuffixFunction, addToSet, addToSetCopy, addToSplitStringTree, addTrailingSlash, allFalsyOrEmptyKeys, allIndexesInIndexRange, allKeyValueTuples, allMaybeSoKeys, allNonUndefinedKeys, allObjectsAreEqual, allValuesAreMaybeNot, allValuesAreNotMaybe, allowValueOnceFilter, applicationFileExtensionForMimeType, applyBestFit, applySplitStringTreeWithMultipleValues, applyToMultipleFields, approximateTimerEndDate, areEqualContext, areEqualPOJOValues, areEqualPOJOValuesUsingPojoFilter, arrayContainsDuplicateValue, arrayContentsDiffer, arrayDecision, arrayDecisionFunction, arrayFactory, arrayInputFactory, arrayToLowercase, arrayToMap, arrayToObject, arrayToUppercase, asArray, asDecisionFunction, asGetter, asIndexRangeCheckFunctionConfig, asIterable, asMinuteOfDay, asNumber, asObjectCopyFactory, asPromise, asSet, assignValuesToPOJO, assignValuesToPOJOFunction, authClaims, authRoleClaimsService, authRolesSetHasRoles, baseWebsiteUrl, batch, batchCalc, bitwiseObjectDencoder, bitwiseObjectEncoder, bitwiseObjectdecoder, bitwiseSetDecoder, bitwiseSetDencoder, booleanFactory, booleanKeyArrayUtility, boundNumber, boundNumberFunction, boundToRectangle, breadthFirstExploreTreeTraversalFactoryFunction, build, cachedGetter, calculateExpirationDate, capLatValue, capitalizeFirstLetter, caseInsensitiveFilterByIndexOfDecisionFactory, caseInsensitiveString, catchAllHandlerKey, chainMapFunction, chainMapSameFunctions, characterPrefixSuffixInstance, checkAnyHaveExpired, checkAtleastOneNotExpired, coerceToEmailParticipants, combineMaps, compareEqualityWithValueFromItemsFunction, compareEqualityWithValueFromItemsFunctionFactory, compareFnOrder, compareWithMappedValuesFunction, computeNextFractionalHour, computeNextFreeIndexFunction, computeNextFreeIndexOnSortedValuesFunction, concatArrays, concatArraysUnique, containsAllStringsAnyCase, containsAllValues, containsAnyStringAnyCase, containsAnyValue, containsAnyValueFromSet, containsNoValueFromSet, containsNoneOfValue, containsStringAnyCase, convertEmailParticipantStringToParticipant, convertMaybeToArray, convertParticipantToEmailParticipantString, convertToArray, copyArray, copyField, copyLatLngBound, copyLatLngPoint, copyObject, copySetAndDo, countAllInNestedArray, countPOJOKeys, countPOJOKeysFunction, cronExpressionRepeatingEveryNMinutes, cssClassesSet, cutString, cutStringFunction, cutToPrecision, cutValueToInteger, cutValueToPrecision, cutValueToPrecisionFunction, dateFromDateOrTimeMillisecondsNumber, dateFromDateOrTimeNumber, dateFromDateOrTimeSecondsNumber, dateFromLogicalDate, dateFromMinuteOfDay, dateOrMillisecondsToDate, dateToHoursAndMinutes, dateToMinuteOfDay, dayOfWeek, daysOfWeekArray, daysOfWeekFromEnabledDays, daysOfWeekNameFunction, daysOfWeekNameMap, decisionFunction, decodeHashedValues, decodeHashedValuesWithDecodeMap, decodeModelKeyTypePair, defaultFilterFromPOJOFunctionNoCopy, defaultForwardFunctionFactory, defaultLatLngPoint, defaultLatLngString, dencodeBitwiseSet, depthFirstExploreTreeTraversalFactoryFunction, diffLatLngBoundPoints, diffLatLngPoints, documentFileExtensionForMimeType, dollarAmountString, dollarAmountStringWithUnitFunction, e164PhoneNumberExtensionPair, e164PhoneNumberFromE164PhoneNumberExtensionPair, enabledDaysFromDaysOfWeek, encodeBitwiseSet, encodeModelKeyTypePair, errorMessageContainsString, errorMessageContainsStringFunction, escapeStringCharactersFunction, escapeStringForRegex, excludeValues, excludeValuesFromArray, excludeValuesFromSet, existsInIterable, expandArrayMapTuples, expandArrayValueTuples, expandFlattenTreeFunction, expandIndexSet, expandSlashPathPathMatcherPartToDecisionFunctions, expandTreeFunction, expandTrees, expirationDetails, exploreTreeFunction, exponentialPromiseRateLimiter, extendLatLngBound, fileExtensionForMimeType, filterAndMapFunction, filterEmptyArrayValues, filterEmptyPojoValues, filterEmptyValues, filterFalsyAndEmptyValues, filterFromIterable, filterFromPOJO, filterFromPOJOFunction, filterKeyValueTupleFunction, filterKeyValueTuples, filterKeyValueTuplesFunction, filterKeyValueTuplesInputToFilter, filterKeysOnPOJOFunction, filterMaybeArrayFunction, filterMaybeArrayValues, filterMaybeValues, filterNullAndUndefinedValues, filterOnlyUndefinedValues, filterTuplesOnPOJOFunction, filterUndefinedValues, filterUniqueByIndex, filterUniqueCaseInsensitiveStrings, filterUniqueFunction, filterUniqueTransform, filterUniqueValues, filterValuesByDistance, filterValuesByDistanceNoOrder, filterValuesToSet, filterValuesUsingSet, filteredPage, findAllCharacterOccurences, findAllCharacterOccurencesFunction, findBest, findBestIndexMatch, findBestIndexMatchFunction, findBestIndexSetPair, findBestSplitStringTreeChildMatch, findBestSplitStringTreeChildMatchPath, findBestSplitStringTreeMatch, findBestSplitStringTreeMatchPath, findFirstCharacterOccurence, findInIterable, findIndexOfFirstDuplicateValue, findItemsByIndex, findNext, findPOJOKeys, findPOJOKeysFunction, findStringsRegexString, findToIndexSet, findValuesFrom, firstAndLastCharacterOccurrence, firstAndLastValue, firstValue, firstValueFromIterable, fitToIndexRangeFunction, fixExtraQueryParameters, fixMultiSlashesInSlashPath, flattenArray, flattenArrayOrValueArray, flattenArrayToSet, flattenArrayUnique, flattenArrayUniqueCaseInsensitiveStrings, flattenTree, flattenTreeToArray, flattenTreeToArrayFunction, flattenTrees, flattenWhitespace, forEachInIterable, forEachKeyValue, forEachKeyValueOnPOJOFunction, forEachWithArray, forwardFunction, fractionalHoursToMinutes, generateIfDoesNotExist, getArrayNextIndex, getBaseLog, getDayOffset, getDayTomorrow, getDayYesterday, getDaysOfWeekNames, getFunctionType, getNextDay, getNextPageNumber, getOverlappingRectangle, getPageNumber, getPreviousDay, getValueFromGetter, groupValues, handlerBindAccessor, handlerConfigurerFactory, handlerFactory, handlerMappedSetFunction, handlerMappedSetFunctionFactory, handlerSetFunction, hasDifferentStringsNoCase, hasDifferentValues, hasHttpPrefix, hasNonNullValue, hasPortNumber, hasSameTimezone, hasSameValues, hasValueFunction, hasValueOrNotEmpty, hasValueOrNotEmptyObject, hasWebsiteDomain, hasWebsiteTopLevelDomain, hashSetForIndexed, hourToFractionalHour, hoursAndMinutesToString, idBatchFactory, imageFileExtensionForMimeType, incrementingNumberFactory, indexDeltaGroup, indexDeltaGroupFunction, indexRange, indexRangeCheckFunction, indexRangeCheckReaderFunction, indexRangeForArray, indexRangeOverlapsIndexRange, indexRangeOverlapsIndexRangeFunction, indexRangeReaderPairFactory, indexRefMap, indexedValuesArrayAccessorFactory, insertIntoBooleanKeyArray, invertBooleanReturnFunction, invertDecision, invertFilter, invertMaybeBoolean, invertStringRecord, isAllowed, isClassLikeType, isCompleteUnitedStatesAddress, isConsideredUtcTimezoneString, isDate, isDefaultLatLngPoint, isDefaultLatLngPointValue, isDefaultReadableError, isDefinedAndNotFalse, isDollarAmountString, isE164PhoneNumber, isE164PhoneNumberWithExtension, isEmptyIterable, isEqualContext, isEqualDate, isEqualToValueDecisionFunction, isEvenNumber, isFalseBooleanKeyArray, isFinalPage, isGetter, isISO8601DateString, isISO8601DayString, isISO8601DayStringStart, isInAllowedDaysOfWeekSet, isInNumberBoundFunction, isInSetDecisionFunction, isIndexNumberInIndexRange, isIndexNumberInIndexRangeFunction, isIndexRangeInIndexRange, isIndexRangeInIndexRangeFunction, isIterable, isKnownHttpWebsiteProtocol, isLatLngBound, isLatLngBoundWithinLatLngBound, isLatLngPoint, isLatLngPointWithinLatLngBound, isLatLngString, isLogicalDateStringCode, isMapIdentityFunction, isMaybeNot, isMaybeNotOrTrue, isMaybeSo, isMinuteOfDay, isModelKey, isMonthDaySlashDate, isNonClassFunction, isNotFalse, isNotNullOrEmptyString, isNumberDivisibleBy, isObjectWithConstructor, isOddNumber, isPast, isPromise, isPromiseLike, isSameLatLngBound, isSameLatLngPoint, isSameNonNullValue, isSameVector, isSelectedDecisionFunctionFactory, isSelectedIndexDecisionFunction, isServerError, isSlashPathFile, isSlashPathFolder, isSlashPathTypedFile, isStandardInternetAccessibleWebsiteUrl, isStringOrTrue, isThrottled, isTrueBooleanKeyArray, isUTCDateString, isUnderThreshold, isUniqueKeyedFunction, isUsStateCodeString, isValidLatLngPoint, isValidLatitude, isValidLongitude, isValidNumberBound, isValidPhoneExtensionNumber, isValidSlashPath, isWebsiteUrl, isWebsiteUrlWithPrefix, isWithinLatLngBoundFunction, isolateSlashPath, isolateSlashPathFunction, isolateWebsitePathFunction, itemCountForBatchIndex, iterableToArray, iterableToMap, iterableToSet, iterablesAreSetEquivalent, iterate, iterateFilteredPages, joinHostAndPort, joinStrings, joinStringsWithCommas, joinStringsWithSpaces, keepCharactersAfterFirstCharacterOccurence, keepCharactersAfterFirstCharacterOccurenceFunction, keepFromSetCopy, keepValuesFromArray, keepValuesFromSet, keyValueMapFactory, labeledValueMap, lastValue, latLngBound, latLngBoundCenterPoint, latLngBoundEastBound, latLngBoundFromInput, latLngBoundFullyWrapsMap, latLngBoundFunction, latLngBoundNorthBound, latLngBoundNorthEastPoint, latLngBoundNorthWestPoint, latLngBoundOverlapsLatLngBound, latLngBoundSouthBound, latLngBoundSouthEastPoint, latLngBoundSouthWestPoint, latLngBoundStrictlyWrapsMap, latLngBoundTuple, latLngBoundTupleFunction, latLngBoundWestBound, latLngBoundWrapsMap, latLngDataPointFunction, latLngPoint, latLngPointFromString, latLngPointFunction, latLngPointPrecisionFunction, latLngString, latLngStringFunction, latLngTuple, latLngTupleFunction, limitArray, lonLatTuple, lowercaseFirstLetter, mailToUrlString, makeBestFit, makeCopyModelFieldFunction, makeDateMonthForMonthOfYear, makeDefaultNonConcurrentTaskKeyFactory, makeGetter, makeHandler, makeHashDecodeMap, makeKeyPairs, makeModelConversionFieldValuesFunction, makeModelMap, makeModelMapFunctions, makeMultiModelKeyMap, makeTimer, makeValuesGroupMap, makeWithFactory, makeWithFactoryInput, mapArrayFunction, mapFunctionOutput, mapFunctionOutputPair, mapGetter, mapGetterFactory, mapIdentityFunction, mapIterable, mapKeysIntersectionObjectToArray, mapMaybeFunction, mapObjectKeysFunction, mapObjectKeysToLowercase, mapObjectMap, mapObjectMapFunction, mapObjectToTargetObject, mapPromiseOrValue, mapToObject, mapToTuples, mapValuesToSet, mappedUseAsyncFunction, mappedUseFunction, mapsHaveSameKeys, maybeMergeModelModifiers, maybeMergeModifiers, maybeModifierMapToFunction, maybeSet, mergeArrays, mergeArraysIntoArray, mergeFilterFunctions, mergeModifiers, mergeObjects, mergeObjectsFunction, mergeSlashPaths, messageFromError, millisecondsToMinutesAndSeconds, mimeTypeForApplicationFileExtension, mimeTypeForDocumentFileExtension, mimeTypeForFileExtension, mimeTypeForImageFileExtension, mimetypeForImageType, minAndMaxFunction, minAndMaxIndex, minAndMaxIndexFunction, minAndMaxIndexItemsFunction, minAndMaxNumber, minutesToFractionalHours, minutesToHoursAndMinutes, modelFieldConversions, modelFieldMapFunction, modelFieldMapFunctions, modelTypeDataPairFactory, modifier, modifierMapToFunction, modifyModelMapFunction, modifyModelMapFunctions, monthDaySlashDateToDateString, monthOfYearFromDate, monthOfYearFromDateMonth, monthOfYearFromUTCDate, multiKeyValueMapFactory, multiValueMapBuilder, neMostLatLngPoint, nearestDivisibleValues, numberStringDencoder, numberStringDencoderDecodedNumberValueFunction, numberStringDencoderEncodedStringValueFunction, numberStringDencoderFunction, objectCopyFactory, objectDeltaArrayCompressor, objectFieldEqualityChecker, objectFlatMergeMatrix, objectHasKey, objectHasKeys, objectHasNoKeys, objectIsEmpty, objectKeyEqualityComparatorFunction, objectKeysEqualityComparatorFunction, objectMergeMatrix, objectToMap, objectToTuples, overlapsLatLngBoundFunction, overrideInObject, overrideInObjectFunctionFactory, padStartFunction, pairGroupValues, parseISO8601DayStringToUTCDate, partialServerError, passThrough, percentNumberFromDecimal, percentNumberToDecimal, performAsyncTask, performAsyncTasks, performBatchLoop, performMakeLoop, performTaskCountLoop, performTaskLoop, performTasksFromFactoryInParallelFunction, performTasksInParallel, performTasksInParallelFunction, pickOneRandomly, poll, primativeKeyDencoder, primativeKeyDencoderMap, primativeKeyStringDencoder, primativeValuesDelta, promiseReference, protectedFactory, pushArrayItemsIntoArray, pushElementOntoArray, pushItemOrArrayItemsIntoArray, randomArrayFactory, randomArrayIndex, randomBoolean, randomEmailFactory, randomFromArrayFactory, randomLatLngFactory, randomLatLngFromCenterFactory, randomNumber, randomNumberFactory, randomPhoneNumberFactory, randomPickFactory, range, rangedIndexedValuesArrayAccessorFactory, rangedIndexedValuesArrayAccessorInfoFactory, readBooleanKeySafetyWrap, readDomainFromEmailAddress, readDomainsFromEmailAddresses, readEmailDomainFromUrlOrEmailAddress, readIndexNumber, readKeysFrom, readKeysFromFilterUniqueFunctionAdditionalKeys, readKeysFromFilterUniqueFunctionAdditionalKeysInput, readKeysFunction, readKeysSetFrom, readKeysSetFunction, readKeysToMap, readModelKey, readModelKeyFromObject, readModelKeys, readModelKeysFromObjects, readMultipleKeysToMap, readPortNumber, readUniqueModelKey, readWebsiteProtocol, readableError, readableStreamToBase64, readableStreamToBuffer, readableStreamToStringFunction, rectangleOverlapsRectangle, reduceBooleansFn, reduceBooleansWithAnd, reduceBooleansWithAndFn, reduceBooleansWithOr, reduceBooleansWithOrFn, reduceNumbers, reduceNumbersFn, reduceNumbersWithAdd, reduceNumbersWithAddFn, reduceNumbersWithMax, reduceNumbersWithMaxFn, reduceNumbersWithMin, reduceNumbersWithMinFn, removeByKeyFromBooleanKeyArray, removeCharactersAfterFirstCharacterOccurence, removeCharactersAfterFirstCharacterOccurenceFunction, removeExtensionFromPhoneNumber, removeFromBooleanKeyArray, removeFromSet, removeFromSetCopy, removeHttpFromUrl, removeModelsWithKey, removeModelsWithSameKey, removeModifiers, removeTrailingFileTypeSeparators, removeTrailingSlashes, removeValuesAtIndexesFromArrayCopy, removeWebProtocolPrefix, repeatString, replaceCharacterAtIndexIf, replaceCharacterAtIndexWith, replaceInvalidFilePathTypeSeparatorsInSlashPath, replaceInvalidFilePathTypeSeparatorsInSlashPathFunction, replaceLastCharacterIf, replaceLastCharacterIfIsFunction, replaceMultipleFilePathsInSlashPath, replaceStringsFunction, requireModelKey, resetPeriodPromiseRateLimiter, restoreOrder, restoreOrderWithValues, reverseCompareFn, roundNumberToStepFunction, roundNumberUpToStep, roundToPrecision, roundToPrecisionFunction, roundingFunction, runAsyncTaskForValue, runAsyncTasksForValues, runNamedAsyncTasks, runNamedAsyncTasksFunction, safeCompareEquality, safeEqualityComparatorFunction, safeFindBestIndexMatch, searchStringFilterFunction, secondsToMinutesAndSeconds, separateValues, separateValuesToSets, sequentialIncrementingNumberStringModelIdFactory, serverError, setContainsAllValues, setContainsAnyValue, setContainsNoneOfValue, setDeltaChangeKeys, setDeltaFunction, setHasValueFunction, setIncludes, setIncludesFunction, setKeysOnMap, setWebProtocolPrefix, setsAreEquivalent, simpleSortValuesFunctionWithSortRef, simplifyWhitespace, slashPathDetails, slashPathDirectoryTree, slashPathFactory, slashPathFolder, slashPathFolderFactory, slashPathInvalidError, slashPathName, slashPathParts, slashPathPathMatcher, slashPathPathMatcherConfig, slashPathStartTypeFactory, slashPathSubPathMatcher, slashPathType, slashPathValidationFactory, sliceIndexRangeFunction, sliceStringFunction, sortAscendingIndexNumberRefFunction, sortByIndexAscendingCompareFunction, sortByIndexRangeAscendingCompareFunction, sortByLabelFunction, sortByNumberFunction, sortByStringFunction, sortCompareNumberFunction, sortNumbersAscendingFunction, sortValues, sortValuesFunctionOrMapIdentityWithSortRef, sortValuesFunctionWithSortRef, spaceSeparatedCssClasses, splitCommaSeparatedString, splitCommaSeparatedStringToSet, splitFront, splitJoinNameString, splitJoinRemainder, splitStringAtFirstCharacterOccurence, splitStringAtFirstCharacterOccurenceFunction, splitStringAtIndex, splitStringTreeFactory, startOfDayForSystemDateInUTC, startOfDayForUTCDateInUTC, stepsFromIndex, stepsFromIndexFunction, stringCharactersToIndexRecord, stringContains, stringFactoryFromFactory, stringFromDateFactory, stringFromTimeFactory, stringToBoolean, stringToLowercaseFunction, stringToUppercaseFunction, stringTrimFunction, sumOfIntegersBetween, swMostLatLngPoint, symmetricDifferenceArray, symmetricDifferenceArrayBetweenSets, symmetricDifferenceWithModels, takeFront, takeLast, takeValuesFromIterable, telUrlString, telUrlStringForE164PhoneNumberPair, terminatingFactoryFromArray, throwKeyIsRequired, timePeriodCounter, timer, toAbsoluteSlashPathStartType, toCaseInsensitiveStringArray, toMinuteOfDay, toModelFieldConversions, toModelMapFunctions, toReadableError, toRelativeSlashPathStartType, toggleInSet, toggleInSetCopy, toggleTimerRunning, transformNumberFunction, transformNumberFunctionConfig, transformStringFunction, transformStringFunctionConfig, transformStrings, trimArray, tryWithPromiseFactoriesFunction, typedServiceRegistry, unique, uniqueCaseInsensitiveStrings, uniqueCaseInsensitiveStringsSet, uniqueKeys, uniqueModels, unitedStatesAddressString, unixDateTimeSecondsNumberForNow, unixDateTimeSecondsNumberFromDate, unixDateTimeSecondsNumberFromDateOrTimeNumber, unixDateTimeSecondsNumberToDate, unixMillisecondsNumberToDate, unixTimeNumberForNow, unixTimeNumberFromDate, unixTimeNumberFromDateOrTimeNumber, unixTimeNumberToDate, updateMaybeValue, urlWithoutParameters, useAsync, useCallback, useContextFunction, useIterableOrValue, useModelOrKey, usePromise, useValue, validLatLngPoint, validLatLngPointFunction, valueAtIndex, valuesAreBothNullishOrEquivalent, valuesFromPOJO, valuesFromPOJOFunction, vectorMinimumSizeResizeFunction, vectorsAreEqual, waitForMs, websiteDomainAndPathPair, websiteDomainAndPathPairFromWebsiteUrl, websitePathAndQueryPair, websitePathFromWebsiteDomainAndPath, websitePathFromWebsiteUrl, websiteUrlDetails, websiteUrlFromPaths, wrapIndexRangeFunction, wrapLatLngPoint, wrapLngValue, wrapMapFunctionOutput, wrapNumberFunction, wrapTuples, wrapUseAsyncFunction, wrapUseFunction };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util",
-  "version": "12.5.9",
+  "version": "12.6.0",
   "exports": {
     ".": {
       "types": "./src/index.d.ts",

package/src/lib/date/date.d.ts

@@ -204,11 +204,27 @@ export declare function monthDaySlashDateToDateString(slashDate: MonthDaySlashDa
  *
  * Returned by Date.getTime().
  */
-export type UnixDateTimeNumber = number;
+export type UnixDateTimeMillisecondsNumber = number;
 /**
- * A date or a unix timestamp
+ * A date or a unix timestamp (in milliseconds)
  */
-export type DateOrUnixDateTimeNumber = Date | UnixDateTimeNumber;
+export type DateOrUnixDateTimeMillisecondsNumber = Date | UnixDateTimeMillisecondsNumber;
+/**
+ * Converts a Date object or unix timestamp (in milliseconds) to a Date object.
+ *
+ * @param input - Date object or unix timestamp (in milliseconds) to convert
+ * @returns Date object if input is valid. Returns null/undefined if input is null/undefined
+ */
+export declare function dateFromDateOrTimeMillisecondsNumber(input: DateOrUnixDateTimeMillisecondsNumber): Date;
+export declare function dateFromDateOrTimeMillisecondsNumber(input: MaybeNot): MaybeNot;
+export declare function dateFromDateOrTimeMillisecondsNumber(input: Maybe<DateOrUnixDateTimeMillisecondsNumber>): Maybe<Date>;
+/**
+ * Converts a unix timestamp number to a Date object.
+ *
+ * @param dateTimeNumber - Unix timestamp number to convert
+ * @returns Date object if timestamp is valid, null/undefined if timestamp is null/undefined
+ */
+export declare function unixMillisecondsNumberToDate(dateTimeNumber: Maybe<UnixDateTimeMillisecondsNumber>): Maybe<Date>;
 /**
  * Number of milliseconds.
  */
@@ -366,3 +382,11 @@ export declare function isPast(input: Date): boolean;
 export declare function addMilliseconds(input: Date, ms: Maybe<Milliseconds>): Date;
 export declare function addMilliseconds(input: MaybeNot, ms: Maybe<Milliseconds>): MaybeNot;
 export declare function addMilliseconds(input: Maybe<Date>, ms: Maybe<Milliseconds>): Maybe<Date>;
+/**
+ * @deprecated use UnixDateTimeMillisecondsNumber instead.
+ */
+export type UnixDateTimeNumber = UnixDateTimeMillisecondsNumber;
+/**
+ * @deprecated use DateOrUnixDateTimeMillisecondsNumber instead.
+ */
+export type DateOrUnixDateTimeNumber = DateOrUnixDateTimeMillisecondsNumber;

package/src/lib/date/date.unix.d.ts

@@ -1,39 +1,74 @@
 import { type Maybe, type MaybeNot } from '../value/maybe.type';
-import { type DateOrUnixDateTimeNumber, type UnixDateTimeNumber } from './date';
+/**
+ * Not to be confused with UnixDateTimeNumber, this value is in seconds instead of milliseconds.
+ */
+export type UnixDateTimeSecondsNumber = number;
+/**
+ * Not to be confused with DateOrUnixDateTimeNumber, this value is in seconds instead of milliseconds.
+ */
+export type DateOrUnixDateTimeSecondsNumber = Date | UnixDateTimeSecondsNumber;
 /**
  * Converts a Date object or unix timestamp number to a unix timestamp number.
  *
  * @param input - Date object or unix timestamp number to convert
  * @returns Unix timestamp number if input is valid, null/undefined if input is null/undefined
  */
-export declare function unixTimeNumberFromDateOrTimeNumber(input: Maybe<DateOrUnixDateTimeNumber>): Maybe<UnixDateTimeNumber>;
+export declare function unixDateTimeSecondsNumberFromDateOrTimeNumber(input: Maybe<DateOrUnixDateTimeSecondsNumber>): Maybe<UnixDateTimeSecondsNumber>;
 /**
  * Gets the current time as a unix timestamp number.
  *
  * @returns Current time as unix timestamp number
  */
-export declare function unixTimeNumberForNow(): UnixDateTimeNumber;
+export declare function unixDateTimeSecondsNumberForNow(): UnixDateTimeSecondsNumber;
 /**
  * Converts a Date object to a unix timestamp number.
  *
  * @param date - Date object to convert
  * @returns Unix timestamp number if date is valid, null/undefined if date is null/undefined
  */
-export declare function unixTimeNumberFromDate(date: Date): UnixDateTimeNumber;
-export declare function unixTimeNumberFromDate(date: MaybeNot): MaybeNot;
+export declare function unixDateTimeSecondsNumberFromDate(date: Date): UnixDateTimeSecondsNumber;
+export declare function unixDateTimeSecondsNumberFromDate(date: MaybeNot): MaybeNot;
 /**
  * Converts a Date object or unix timestamp number to a Date object.
  *
  * @param input - Date object or unix timestamp number to convert
  * @returns Date object if input is valid. Returns null/undefined if input is null/undefined
  */
-export declare function dateFromDateOrTimeNumber(input: DateOrUnixDateTimeNumber): Date;
-export declare function dateFromDateOrTimeNumber(input: MaybeNot): MaybeNot;
-export declare function dateFromDateOrTimeNumber(input: Maybe<DateOrUnixDateTimeNumber>): Maybe<Date>;
+export declare function dateFromDateOrTimeSecondsNumber(input: DateOrUnixDateTimeSecondsNumber): Date;
+export declare function dateFromDateOrTimeSecondsNumber(input: MaybeNot): MaybeNot;
+export declare function dateFromDateOrTimeSecondsNumber(input: Maybe<DateOrUnixDateTimeSecondsNumber>): Maybe<Date>;
 /**
  * Converts a unix timestamp number to a Date object.
  *
  * @param dateTimeNumber - Unix timestamp number to convert
  * @returns Date object if timestamp is valid, null/undefined if timestamp is null/undefined
  */
-export declare function unixTimeNumberToDate(dateTimeNumber: Maybe<UnixDateTimeNumber>): Maybe<Date>;
+export declare function unixDateTimeSecondsNumberToDate(dateTimeNumber: Maybe<UnixDateTimeSecondsNumber>): Maybe<Date>;
+/**
+ * @deprecated use UnixDateTimeSecondsNumber instead
+ */
+export type UnixTimeNumber = UnixDateTimeSecondsNumber;
+/**
+ * @deprecated use DateOrUnixDateTimeSecondsNumber instead
+ */
+export type DateOrUnixTimeNumber = Date | UnixTimeNumber;
+/**
+ * @deprecated use unixDateTimeSecondsNumberFromDateOrTimeNumber instead
+ */
+export declare const unixTimeNumberFromDateOrTimeNumber: typeof unixDateTimeSecondsNumberFromDateOrTimeNumber;
+/**
+ * @deprecated use unixDateTimeSecondsNumberForNow instead
+ */
+export declare const unixTimeNumberForNow: typeof unixDateTimeSecondsNumberForNow;
+/**
+ * @deprecated use unixDateTimeSecondsNumberFromDate instead
+ */
+export declare const unixTimeNumberFromDate: typeof unixDateTimeSecondsNumberFromDate;
+/**
+ * @deprecated use dateFromDateOrTimeSecondsNumber instead
+ */
+export declare const dateFromDateOrTimeNumber: typeof dateFromDateOrTimeSecondsNumber;
+/**
+ * @deprecated use unixDateTimeSecondsNumberToDate instead
+ */
+export declare const unixTimeNumberToDate: typeof unixDateTimeSecondsNumberToDate;

package/src/lib/object/object.d.ts

@@ -1,10 +1,10 @@
-import { type FieldOfType } from '../key';
+import { type PrimativeKey, type FieldOfType } from '../key';
 import { type SetIncludesMode } from '../set/set.mode';
 import { type KeyAsString } from '../type';
 /**
  * Any valid Plain-old Javascript Object key.
  */
-export type POJOKey = string | number | symbol;
+export type POJOKey = PrimativeKey | symbol;
 /**
  * String key of an object.
  */

package/src/lib/path/index.d.ts

@@ -1 +1,2 @@
 export * from './path';
+export * from './path.tree';

package/src/lib/path/path.d.ts

@@ -312,10 +312,14 @@ export interface SlashPathDetails {
     readonly file?: Maybe<SlashPathFile | SlashPathTypedFile>;
     /**
      * The file name, if file is defined.
+     *
+     * This is only the filename without the extension, even if the file is a typed file.
      */
     readonly fileName?: Maybe<string>;
     /**
      * The typed file part, if the file is a typed file.
+     *
+     * This is the full file name including the extension if the file is a typed file.
      */
     readonly typedFile: Maybe<SlashPathTypedFile>;
     /**

package/src/lib/path/path.tree.d.ts

@@ -0,0 +1,23 @@
+import { type TreeNode } from '../tree/tree';
+import { type Maybe } from '../value/maybe.type';
+import { type SlashPathDetails } from './path';
+/**
+ * A value that has a corresponding SlashPathDetails value.
+ */
+export type SlashPathDirectoryTreeNodeValue<T> = {
+    readonly value: T;
+    readonly slashPathDetails: SlashPathDetails;
+};
+export type SlashPathDirectoryTreeNode<T, V extends SlashPathDirectoryTreeNodeValue<T> = SlashPathDirectoryTreeNodeValue<T>> = TreeNode<V>;
+export type SlashPathDirectoryTreeRoot<T, V extends SlashPathDirectoryTreeNodeValue<T> = SlashPathDirectoryTreeNodeValue<T>> = Omit<SlashPathDirectoryTreeNode<T, V>, 'value'>;
+export interface SlashPathDirectoryTreeOptions {
+    /**
+     * Whether or not to include node values in the tree if their parent folders do not appear in the tree.
+     *
+     * If true, these nodes will be added to the root of the tree.
+     *
+     * Defaults to false
+     */
+    readonly includeChildrenWithMissingParentFolder?: Maybe<boolean>;
+}
+export declare function slashPathDirectoryTree<T, V extends SlashPathDirectoryTreeNodeValue<T> = SlashPathDirectoryTreeNodeValue<T>>(nodeValues: V[], options?: SlashPathDirectoryTreeOptions): SlashPathDirectoryTreeRoot<T, V>;

package/src/lib/string/index.d.ts

@@ -6,6 +6,7 @@ export * from './json';
 export * from './mimetype';
 export * from './password';
 export * from './prefix';
+export * from './record';
 export * from './string';
 export * from './sort';
 export * from './replace';

package/src/lib/string/mimetype.d.ts

@@ -1,3 +1,4 @@
+import { type SlashPathTypedFileExtension } from '../path/path';
 import { type Maybe } from '../value/maybe.type';
 /**
  * A simple mime type string with just the type/subtype and no parameters.
@@ -26,7 +27,7 @@ export type ContentTypeMimeType = string;
  *
  * This is a non-exhaustive list of common image types.
  */
-export type MimeTypeForImageTypeInputType = 'jpeg' | 'jpg' | 'png' | 'webp' | 'gif' | 'svg' | 'raw' | 'heif' | 'tiff';
+export type ImageFileExtension = 'jpeg' | 'jpg' | 'png' | 'webp' | 'gif' | 'svg' | 'raw' | 'heif' | 'tiff';
 export declare const JPEG_MIME_TYPE: MimeTypeWithoutParameters;
 export declare const PNG_MIME_TYPE: MimeTypeWithoutParameters;
 export declare const WEBP_MIME_TYPE: MimeTypeWithoutParameters;
@@ -35,8 +36,85 @@ export declare const HEIF_MIME_TYPE: MimeTypeWithoutParameters;
 export declare const TIFF_MIME_TYPE: MimeTypeWithoutParameters;
 export declare const SVG_MIME_TYPE: MimeTypeWithoutParameters;
 export declare const RAW_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const IMAGE_FILE_EXTENSION_TO_MIME_TYPES_RECORD: Record<ImageFileExtension, MimeTypeWithoutParameters>;
+export declare const IMAGE_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD: Record<MimeTypeWithoutParameters, ImageFileExtension>;
 /**
  * Returns the mimetype for the given image type, or undefined if the type is not known.
  */
-export declare function mimetypeForImageType(imageType: MimeTypeForImageTypeInputType): MimeTypeWithoutParameters;
-export declare function mimetypeForImageType(imageType: MimeTypeForImageTypeInputType | string): Maybe<MimeTypeWithoutParameters>;
+export declare function mimeTypeForImageFileExtension(extension: ImageFileExtension): MimeTypeWithoutParameters;
+export declare function mimeTypeForImageFileExtension(extension: SlashPathTypedFileExtension): Maybe<MimeTypeWithoutParameters>;
+export declare function mimeTypeForImageFileExtension(extension: Maybe<ImageFileExtension | SlashPathTypedFileExtension>): Maybe<MimeTypeWithoutParameters>;
+export declare function imageFileExtensionForMimeType(mimeType: Maybe<MimeTypeWithoutParameters>): Maybe<ImageFileExtension>;
+export type DocumentFileExtension = 'pdf' | 'docx' | 'xlsx' | 'txt' | 'csv' | 'html' | 'xml' | 'json' | 'yaml' | 'md';
+export declare const PDF_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const DOCX_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const XLSX_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const TXT_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const CSV_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const HTML_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const XML_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const JSON_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const YAML_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const MARKDOWN_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const DOCUMENT_FILE_EXTENSION_TO_MIME_TYPES_RECORD: Record<DocumentFileExtension, MimeTypeWithoutParameters>;
+export declare const DOCUMENT_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD: Record<MimeTypeWithoutParameters, DocumentFileExtension>;
+/**
+ * Returns the mimetype for the given document file extension, or undefined if the extension is not known/recognized.
+ *
+ * @param extension The document file extension to get the mimetype for.
+ * @returns The mimetype for the given document file extension, or undefined if the extension is not known.
+ */
+export declare function mimeTypeForDocumentFileExtension(extension: DocumentFileExtension): MimeTypeWithoutParameters;
+export declare function mimeTypeForDocumentFileExtension(extension: SlashPathTypedFileExtension): Maybe<MimeTypeWithoutParameters>;
+export declare function mimeTypeForDocumentFileExtension(extension: Maybe<DocumentFileExtension | SlashPathTypedFileExtension>): Maybe<MimeTypeWithoutParameters>;
+/**
+ * Returns the document file extension for the given mimetype, or undefined if the mimetype is not known/recognized.
+ *
+ * @param mimeType The mimetype to get the document file extension for.
+ * @returns The document file extension for the given mimetype, or undefined if the mimetype is not known.
+ */
+export declare function documentFileExtensionForMimeType(mimeType: Maybe<MimeTypeWithoutParameters>): Maybe<DocumentFileExtension>;
+export type ApplicationFileExtension = 'zip';
+export declare const ZIP_FILE_MIME_TYPE: MimeTypeWithoutParameters;
+export declare const APPLICATION_FILE_EXTENSION_TO_MIME_TYPES_RECORD: Record<ApplicationFileExtension, MimeTypeWithoutParameters>;
+export declare const APPLICATION_MIME_TYPES_TO_FILE_EXTENSIONS_RECORD: Record<MimeTypeWithoutParameters, ApplicationFileExtension>;
+/**
+ * Returns the mimetype for the given application file extension, or undefined if the extension is not known/recognized.
+ *
+ * @param extension The application file extension to get the mimetype for.
+ * @returns The mimetype for the given application file extension, or undefined if the extension is not known.
+ */
+export declare function mimeTypeForApplicationFileExtension(extension: ApplicationFileExtension): MimeTypeWithoutParameters;
+export declare function mimeTypeForApplicationFileExtension(extension: SlashPathTypedFileExtension): Maybe<MimeTypeWithoutParameters>;
+export declare function mimeTypeForApplicationFileExtension(extension: Maybe<ApplicationFileExtension | SlashPathTypedFileExtension>): Maybe<MimeTypeWithoutParameters>;
+export declare function applicationFileExtensionForMimeType(mimeType: Maybe<MimeTypeWithoutParameters>): Maybe<ApplicationFileExtension>;
+/**
+ * List of known file extensions supported by dbx-components.
+ *
+ * These types are known to work with most dbx-components features related to files.
+ */
+export type DbxComponentsKnownFileExtension = ImageFileExtension | DocumentFileExtension | ApplicationFileExtension;
+/**
+ * Returns the mimetype for the given file extension, or undefined if the extension is not known/recognized.
+ *
+ * @param extension The file extension to get the mimetype for.
+ * @returns The mimetype for the given file extension, or undefined if the extension is not known.
+ */
+export declare function mimeTypeForFileExtension(extension: DbxComponentsKnownFileExtension): MimeTypeWithoutParameters;
+export declare function mimeTypeForFileExtension(extension: SlashPathTypedFileExtension): Maybe<MimeTypeWithoutParameters>;
+export declare function mimeTypeForFileExtension(extension: Maybe<DbxComponentsKnownFileExtension | SlashPathTypedFileExtension>): Maybe<MimeTypeWithoutParameters>;
+export declare function fileExtensionForMimeType(mimeType: Maybe<MimeTypeWithoutParameters>): Maybe<DbxComponentsKnownFileExtension>;
+/**
+ * A content disposition string, which is used to determine how the browser should show the target content.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Content-Disposition
+ */
+export type ContentDispositionString = 'inline' | 'attachment' | string;
+/**
+ * @deprecated Use ImageFileExtension instead.
+ */
+export type MimeTypeForImageTypeInputType = ImageFileExtension;
+/**
+ * @deprecated Use mimeTypeForImageFileExtension instead.
+ */
+export declare const mimetypeForImageType: typeof mimeTypeForImageFileExtension;

package/src/lib/string/record.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A record where the keys and values are strings.
+ */
+export type StringRecord<K extends string, V extends string> = Record<K, V>;
+/**
+ * Inverts a string record, inverting the key and value of each entry in the record.
+ *
+ * @param record
+ * @returns
+ */
+export declare function invertStringRecord<K extends string, V extends string>(record: StringRecord<K, V>): StringRecord<V, K>;

package/test/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+# [12.6.0](https://github.com/dereekb/dbx-components/compare/v12.5.10-dev...v12.6.0) (2025-12-02)
+
+
+
+## [12.5.10](https://github.com/dereekb/dbx-components/compare/v12.5.9-dev...v12.5.10) (2025-11-21)
+
+
+
 ## [12.5.9](https://github.com/dereekb/dbx-components/compare/v12.5.8-dev...v12.5.9) (2025-11-16)
 
 

package/test/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/util/test",
-  "version": "12.5.9",
+  "version": "12.6.0",
   "type": "commonjs",
   "peerDependencies": {
     "@dereekb/util": "*"