@trackunit/shared-utils 0.0.78 → 0.0.79

package/index.cjs.js

@@ -1,205 +1,6 @@
 'use strict';
 
-exports.HoursAndMinutesFormat = void 0;
-(function (HoursAndMinutesFormat) {
-    HoursAndMinutesFormat["HOURS_MIN_SEC_LONG"] = "HOURS_MIN_SEC_LONG";
-    HoursAndMinutesFormat["HOURS_MIN_SEC"] = "HOURS_MIN_SEC";
-    HoursAndMinutesFormat["HOURS_MIN_LONG"] = "HOURS_MIN_LONG";
-    HoursAndMinutesFormat["HOURS_MIN"] = "HOURS_MIN";
-    HoursAndMinutesFormat["HOURS_LONG"] = "HOURS_LONG";
-})(exports.HoursAndMinutesFormat || (exports.HoursAndMinutesFormat = {}));
-const DateTimeFormat = {
-    DATE: {
-        selectFormat: "dateOnly",
-        dateFormat: "short",
-    },
-    DATE_LONG: {
-        selectFormat: "dateOnly",
-        dateFormat: "long",
-    },
-    DATE_LONG_TIME: {
-        dateFormat: "long",
-        timeFormat: "short",
-    },
-    DATE_SHORT: {
-        selectFormat: "dateOnly",
-        dateFormat: "medium",
-    },
-    DATE_SHORT_TIME: {
-        dateFormat: "medium",
-        timeFormat: "short",
-    },
-    TIME_SHORT: {
-        selectFormat: "timeOnly",
-        timeFormat: "short",
-    },
-    TIME_LONG: {
-        selectFormat: "timeOnly",
-        timeFormat: "medium",
-    },
-};
-
-/**
- * @description Converts a date to a string in ISO format.
- * @param date  A date object or a date string.
- * @returns {string | null} A string in ISO format or null if the input is invalid.
- * @example getISOStringFromDate(new Date("2021-05-19T12:34:56")) // "2021-05-19T12:34:56.000Z"
- */
-const getISOStringFromDate = (date) => {
-    try {
-        if (!date) {
-            return null;
-        }
-        return new Date(date).toISOString();
-    }
-    catch (err) {
-        return null;
-    }
-};
-/**
- * @description Returns the difference between two dates in the specified unit.
- * @param date1 The first date.
- * @param date2 The second date.
- * @param unit The unit to return the difference in.
- * @returns {number} The difference between the two dates in the specified unit.
- */
-const getDifferenceBetweenDates = (date1, date2, unit) => {
-    const diffInMs = Math.abs(date2.getTime() - date1.getTime());
-    switch (unit) {
-        case "days":
-            return Math.floor(diffInMs / (1000 * 60 * 60 * 24));
-        case "hours":
-            return Math.floor(diffInMs / (1000 * 60 * 60));
-        case "minutes":
-            return Math.floor(diffInMs / (1000 * 60));
-        case "seconds":
-            return Math.floor(diffInMs / 1000);
-        default:
-            throw new Error("Invalid unit parameter");
-    }
-};
-/**
- * @description Returns the start of the day for a given date.
- * @param date A date object or a date string.
- * @returns {Date} The start of the day for the given date.
- * @example getStartOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T00:00:00"
- */
-const getStartOfDay = (date) => {
-    const selectedDate = new Date(date);
-    selectedDate.setHours(0, 0, 0, 0);
-    return selectedDate;
-};
-/**
- * @description Returns the end of the day for a given date.
- * @param date A date object or a date string.
- * @returns {Date} The end of the day for the given date.
- * @example getEndOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T23:59:59"
- */
-const getEndOfDay = (date) => {
-    const selectedDate = new Date(date);
-    selectedDate.setHours(23, 59, 59, 999);
-    return selectedDate;
-};
-
-/**
- * @description Extracts a point coordinate from a GeoJSON object.
- * @param geoObject A GeoJSON object.
- * @returns {PointCoordinate} A point coordinate.
- */
-const getPointCoordinateFromGeoJsonObject = (geoObject) => {
-    if (!geoObject) {
-        return undefined;
-    }
-    else if ("geometry" in geoObject) {
-        return getPointCoordinateFromGeoJsonObject(geoObject.geometry);
-    }
-    else if ("coordinates" in geoObject &&
-        Array.isArray(geoObject.coordinates) &&
-        typeof geoObject.coordinates[0] === "number" &&
-        typeof geoObject.coordinates[1] === "number") {
-        return { longitude: geoObject.coordinates[0], latitude: geoObject.coordinates[1] };
-    }
-    else {
-        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
-    }
-};
-/**
- * @description Extracts multiple point coordinates from a GeoJSON object.
- * @param geoObject A GeoJSON object.
- * @returns {PointCoordinate[]} An array of point coordinates.
- * @example getMultipleCoordinatesFromGeoJsonObject({ type: "Point", coordinates: [1, 2] }) // [{ longitude: 1, latitude: 2 }]
- */
-const getMultipleCoordinatesFromGeoJsonObject = (geoObject) => {
-    if (!geoObject) {
-        return undefined;
-    }
-    else if ("geometry" in geoObject) {
-        return getMultipleCoordinatesFromGeoJsonObject(geoObject.geometry);
-    }
-    else if ("coordinates" in geoObject &&
-        Array.isArray(geoObject.coordinates) &&
-        Array.isArray(geoObject.coordinates[0])) {
-        // @ts-ignore - suppressImplicitAnyIndexErrors
-        // We would not be here if element was not an array.
-        return geoObject.coordinates.map(element => ({ longitude: element[0], latitude: element[1] }));
-    }
-    else {
-        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
-    }
-};
-
-/**
- * Group data that has smaller count then 0.5% (smallestCount) of total count if there is more than 3% (limitToStartGrouping) of them to "Others" group.
- * It can help charts to look better.
- *
- * @param data Input data
- * @param smallestCount Breaking point to start considering the item as candidate to "Others" group [in percentage] - default 0,5%
- * @param limitToStartGrouping Lowest limit of candidates for grouping to "Others" [in percentage] - default 3%
- */
-function groupTinyDataToOthers(data, smallestCount = 0.5, limitToStartGrouping = 3) {
-    if (!data || data.length < 2) {
-        return data;
-    }
-    const breakingPoint = (data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count * smallestCount) / 100;
-    if (data.filter(x => x.count <= breakingPoint).length < 2) {
-        return data;
-    }
-    const others = data
-        .filter(x => x.count <= breakingPoint)
-        .reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count }));
-    const canGroupToOthers = others.count / data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count >
-        limitToStartGrouping / 100;
-    if (!canGroupToOthers) {
-        return data;
-    }
-    const temp = data.filter(x => x.count > breakingPoint);
-    return [...temp, others].sort((a, b) => a.count - b.count);
-}
-
-/**
- * Converts meters to yards
- *
- * @param value The value to convert
- * @returns {number | undefined} The converted value
- */
-const convertMetersToYards = (value) => {
-    if (isNaN(value)) {
-        return;
-    }
-    return Math.round(value * 1.09361);
-};
-/**
- * Converts yards to meters
- *
- * @param value The value to convert
- * @returns {number | undefined} The converted value
- */
-const convertYardsToMeters = (value) => {
-    if (isNaN(value)) {
-        return;
-    }
-    return Math.round(value * 0.9144);
-};
+var uuid = require('uuid');
 
 /**
  * @description Formats an address into a single string.
@@ -365,6 +166,107 @@ const size = {
     LARGE: "large",
 };
 
+exports.HoursAndMinutesFormat = void 0;
+(function (HoursAndMinutesFormat) {
+    HoursAndMinutesFormat["HOURS_MIN_SEC_LONG"] = "HOURS_MIN_SEC_LONG";
+    HoursAndMinutesFormat["HOURS_MIN_SEC"] = "HOURS_MIN_SEC";
+    HoursAndMinutesFormat["HOURS_MIN_LONG"] = "HOURS_MIN_LONG";
+    HoursAndMinutesFormat["HOURS_MIN"] = "HOURS_MIN";
+    HoursAndMinutesFormat["HOURS_LONG"] = "HOURS_LONG";
+})(exports.HoursAndMinutesFormat || (exports.HoursAndMinutesFormat = {}));
+const DateTimeFormat = {
+    DATE: {
+        selectFormat: "dateOnly",
+        dateFormat: "short",
+    },
+    DATE_LONG: {
+        selectFormat: "dateOnly",
+        dateFormat: "long",
+    },
+    DATE_LONG_TIME: {
+        dateFormat: "long",
+        timeFormat: "short",
+    },
+    DATE_SHORT: {
+        selectFormat: "dateOnly",
+        dateFormat: "medium",
+    },
+    DATE_SHORT_TIME: {
+        dateFormat: "medium",
+        timeFormat: "short",
+    },
+    TIME_SHORT: {
+        selectFormat: "timeOnly",
+        timeFormat: "short",
+    },
+    TIME_LONG: {
+        selectFormat: "timeOnly",
+        timeFormat: "medium",
+    },
+};
+
+/**
+ * @description Converts a date to a string in ISO format.
+ * @param date  A date object or a date string.
+ * @returns {string | null} A string in ISO format or null if the input is invalid.
+ * @example getISOStringFromDate(new Date("2021-05-19T12:34:56")) // "2021-05-19T12:34:56.000Z"
+ */
+const getISOStringFromDate = (date) => {
+    try {
+        if (!date) {
+            return null;
+        }
+        return new Date(date).toISOString();
+    }
+    catch (err) {
+        return null;
+    }
+};
+/**
+ * @description Returns the difference between two dates in the specified unit.
+ * @param date1 The first date.
+ * @param date2 The second date.
+ * @param unit The unit to return the difference in.
+ * @returns {number} The difference between the two dates in the specified unit.
+ */
+const getDifferenceBetweenDates = (date1, date2, unit) => {
+    const diffInMs = Math.abs(date2.getTime() - date1.getTime());
+    switch (unit) {
+        case "days":
+            return Math.floor(diffInMs / (1000 * 60 * 60 * 24));
+        case "hours":
+            return Math.floor(diffInMs / (1000 * 60 * 60));
+        case "minutes":
+            return Math.floor(diffInMs / (1000 * 60));
+        case "seconds":
+            return Math.floor(diffInMs / 1000);
+        default:
+            throw new Error("Invalid unit parameter");
+    }
+};
+/**
+ * @description Returns the start of the day for a given date.
+ * @param date A date object or a date string.
+ * @returns {Date} The start of the day for the given date.
+ * @example getStartOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T00:00:00"
+ */
+const getStartOfDay = (date) => {
+    const selectedDate = new Date(date);
+    selectedDate.setHours(0, 0, 0, 0);
+    return selectedDate;
+};
+/**
+ * @description Returns the end of the day for a given date.
+ * @param date A date object or a date string.
+ * @returns {Date} The end of the day for the given date.
+ * @example getEndOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T23:59:59"
+ */
+const getEndOfDay = (date) => {
+    const selectedDate = new Date(date);
+    selectedDate.setHours(23, 59, 59, 999);
+    return selectedDate;
+};
+
 /**
  * Do nothing usefull for creating mocks without dependency on jest or anything else.
  */
@@ -511,6 +413,53 @@ searchTerm) => {
         .every(term => filterableProps(asset).some(value => value.toLowerCase().includes(term.toLowerCase()))));
 };
 
+/**
+ * @description Extracts a point coordinate from a GeoJSON object.
+ * @param geoObject A GeoJSON object.
+ * @returns {PointCoordinate} A point coordinate.
+ */
+const getPointCoordinateFromGeoJsonObject = (geoObject) => {
+    if (!geoObject) {
+        return undefined;
+    }
+    else if ("geometry" in geoObject) {
+        return getPointCoordinateFromGeoJsonObject(geoObject.geometry);
+    }
+    else if ("coordinates" in geoObject &&
+        Array.isArray(geoObject.coordinates) &&
+        typeof geoObject.coordinates[0] === "number" &&
+        typeof geoObject.coordinates[1] === "number") {
+        return { longitude: geoObject.coordinates[0], latitude: geoObject.coordinates[1] };
+    }
+    else {
+        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
+    }
+};
+/**
+ * @description Extracts multiple point coordinates from a GeoJSON object.
+ * @param geoObject A GeoJSON object.
+ * @returns {PointCoordinate[]} An array of point coordinates.
+ * @example getMultipleCoordinatesFromGeoJsonObject({ type: "Point", coordinates: [1, 2] }) // [{ longitude: 1, latitude: 2 }]
+ */
+const getMultipleCoordinatesFromGeoJsonObject = (geoObject) => {
+    if (!geoObject) {
+        return undefined;
+    }
+    else if ("geometry" in geoObject) {
+        return getMultipleCoordinatesFromGeoJsonObject(geoObject.geometry);
+    }
+    else if ("coordinates" in geoObject &&
+        Array.isArray(geoObject.coordinates) &&
+        Array.isArray(geoObject.coordinates[0])) {
+        // @ts-ignore - suppressImplicitAnyIndexErrors
+        // We would not be here if element was not an array.
+        return geoObject.coordinates.map(element => ({ longitude: element[0], latitude: element[1] }));
+    }
+    else {
+        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
+    }
+};
+
 /**
  * Group an array of items by a key.
  *
@@ -538,6 +487,34 @@ function groupBy(list, getKey) {
     return groupedMap;
 }
 
+/**
+ * Group data that has smaller count then 0.5% (smallestCount) of total count if there is more than 3% (limitToStartGrouping) of them to "Others" group.
+ * It can help charts to look better.
+ *
+ * @param data Input data
+ * @param smallestCount Breaking point to start considering the item as candidate to "Others" group [in percentage] - default 0,5%
+ * @param limitToStartGrouping Lowest limit of candidates for grouping to "Others" [in percentage] - default 3%
+ */
+function groupTinyDataToOthers(data, smallestCount = 0.5, limitToStartGrouping = 3) {
+    if (!data || data.length < 2) {
+        return data;
+    }
+    const breakingPoint = (data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count * smallestCount) / 100;
+    if (data.filter(x => x.count <= breakingPoint).length < 2) {
+        return data;
+    }
+    const others = data
+        .filter(x => x.count <= breakingPoint)
+        .reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count }));
+    const canGroupToOthers = others.count / data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count >
+        limitToStartGrouping / 100;
+    if (!canGroupToOthers) {
+        return data;
+    }
+    const temp = data.filter(x => x.count > breakingPoint);
+    return [...temp, others].sort((a, b) => a.count - b.count);
+}
+
 const UUID_HYPHEN_POSITIONS = [8, 12, 16, 20];
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 /**
@@ -1074,6 +1051,61 @@ const isSorted = (sortInput) => {
     return originalKeys.every((key, index) => key === sortedKeys[index]);
 };
 
+/**
+ * Converts meters to yards
+ *
+ * @param value The value to convert
+ * @returns {number | undefined} The converted value
+ */
+const convertMetersToYards = (value) => {
+    if (isNaN(value)) {
+        return;
+    }
+    return Math.round(value * 1.09361);
+};
+/**
+ * Converts yards to meters
+ *
+ * @param value The value to convert
+ * @returns {number | undefined} The converted value
+ */
+const convertYardsToMeters = (value) => {
+    if (isNaN(value)) {
+        return;
+    }
+    return Math.round(value * 0.9144);
+};
+
+/**
+ * Generates a version 3 UUID (namespace with MD5).
+ *
+ * @param {string} name - The name for which to generate the UUID.
+ * @param {string | Buffer} namespace - The namespace for the UUID.
+ * @returns {string} A version 3 UUID.
+ */
+const uuidv3 = (name, namespace) => uuid.v3(name, namespace);
+/**
+ * Generates a random version 4 UUID.
+ *
+ * @returns {string} A version 4 UUID.
+ */
+const uuidv4 = () => {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID().toString();
+    }
+    else {
+        return uuid.v4();
+    }
+};
+/**
+ * Generates a version 5 UUID (namespace with SHA-1).
+ *
+ * @param {string} name - The name for which to generate the UUID.
+ * @param {string | Buffer} namespace - The namespace for the UUID.
+ * @returns {string} A version 5 UUID.
+ */
+const uuidv5 = (name, namespace) => uuid.v5(name, namespace);
+
 exports.DateTimeFormat = DateTimeFormat;
 exports.align = align;
 exports.alphabeticallySort = alphabeticallySort;
@@ -1137,3 +1169,6 @@ exports.trimIds = trimIds;
 exports.trimPath = trimPath;
 exports.truthy = truthy;
 exports.unionArraysByKey = unionArraysByKey;
+exports.uuidv3 = uuidv3;
+exports.uuidv4 = uuidv4;
+exports.uuidv5 = uuidv5;

package/index.esm.js

@@ -1,203 +1,4 @@
-var HoursAndMinutesFormat;
-(function (HoursAndMinutesFormat) {
-    HoursAndMinutesFormat["HOURS_MIN_SEC_LONG"] = "HOURS_MIN_SEC_LONG";
-    HoursAndMinutesFormat["HOURS_MIN_SEC"] = "HOURS_MIN_SEC";
-    HoursAndMinutesFormat["HOURS_MIN_LONG"] = "HOURS_MIN_LONG";
-    HoursAndMinutesFormat["HOURS_MIN"] = "HOURS_MIN";
-    HoursAndMinutesFormat["HOURS_LONG"] = "HOURS_LONG";
-})(HoursAndMinutesFormat || (HoursAndMinutesFormat = {}));
-const DateTimeFormat = {
-    DATE: {
-        selectFormat: "dateOnly",
-        dateFormat: "short",
-    },
-    DATE_LONG: {
-        selectFormat: "dateOnly",
-        dateFormat: "long",
-    },
-    DATE_LONG_TIME: {
-        dateFormat: "long",
-        timeFormat: "short",
-    },
-    DATE_SHORT: {
-        selectFormat: "dateOnly",
-        dateFormat: "medium",
-    },
-    DATE_SHORT_TIME: {
-        dateFormat: "medium",
-        timeFormat: "short",
-    },
-    TIME_SHORT: {
-        selectFormat: "timeOnly",
-        timeFormat: "short",
-    },
-    TIME_LONG: {
-        selectFormat: "timeOnly",
-        timeFormat: "medium",
-    },
-};
-
-/**
- * @description Converts a date to a string in ISO format.
- * @param date  A date object or a date string.
- * @returns {string | null} A string in ISO format or null if the input is invalid.
- * @example getISOStringFromDate(new Date("2021-05-19T12:34:56")) // "2021-05-19T12:34:56.000Z"
- */
-const getISOStringFromDate = (date) => {
-    try {
-        if (!date) {
-            return null;
-        }
-        return new Date(date).toISOString();
-    }
-    catch (err) {
-        return null;
-    }
-};
-/**
- * @description Returns the difference between two dates in the specified unit.
- * @param date1 The first date.
- * @param date2 The second date.
- * @param unit The unit to return the difference in.
- * @returns {number} The difference between the two dates in the specified unit.
- */
-const getDifferenceBetweenDates = (date1, date2, unit) => {
-    const diffInMs = Math.abs(date2.getTime() - date1.getTime());
-    switch (unit) {
-        case "days":
-            return Math.floor(diffInMs / (1000 * 60 * 60 * 24));
-        case "hours":
-            return Math.floor(diffInMs / (1000 * 60 * 60));
-        case "minutes":
-            return Math.floor(diffInMs / (1000 * 60));
-        case "seconds":
-            return Math.floor(diffInMs / 1000);
-        default:
-            throw new Error("Invalid unit parameter");
-    }
-};
-/**
- * @description Returns the start of the day for a given date.
- * @param date A date object or a date string.
- * @returns {Date} The start of the day for the given date.
- * @example getStartOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T00:00:00"
- */
-const getStartOfDay = (date) => {
-    const selectedDate = new Date(date);
-    selectedDate.setHours(0, 0, 0, 0);
-    return selectedDate;
-};
-/**
- * @description Returns the end of the day for a given date.
- * @param date A date object or a date string.
- * @returns {Date} The end of the day for the given date.
- * @example getEndOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T23:59:59"
- */
-const getEndOfDay = (date) => {
-    const selectedDate = new Date(date);
-    selectedDate.setHours(23, 59, 59, 999);
-    return selectedDate;
-};
-
-/**
- * @description Extracts a point coordinate from a GeoJSON object.
- * @param geoObject A GeoJSON object.
- * @returns {PointCoordinate} A point coordinate.
- */
-const getPointCoordinateFromGeoJsonObject = (geoObject) => {
-    if (!geoObject) {
-        return undefined;
-    }
-    else if ("geometry" in geoObject) {
-        return getPointCoordinateFromGeoJsonObject(geoObject.geometry);
-    }
-    else if ("coordinates" in geoObject &&
-        Array.isArray(geoObject.coordinates) &&
-        typeof geoObject.coordinates[0] === "number" &&
-        typeof geoObject.coordinates[1] === "number") {
-        return { longitude: geoObject.coordinates[0], latitude: geoObject.coordinates[1] };
-    }
-    else {
-        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
-    }
-};
-/**
- * @description Extracts multiple point coordinates from a GeoJSON object.
- * @param geoObject A GeoJSON object.
- * @returns {PointCoordinate[]} An array of point coordinates.
- * @example getMultipleCoordinatesFromGeoJsonObject({ type: "Point", coordinates: [1, 2] }) // [{ longitude: 1, latitude: 2 }]
- */
-const getMultipleCoordinatesFromGeoJsonObject = (geoObject) => {
-    if (!geoObject) {
-        return undefined;
-    }
-    else if ("geometry" in geoObject) {
-        return getMultipleCoordinatesFromGeoJsonObject(geoObject.geometry);
-    }
-    else if ("coordinates" in geoObject &&
-        Array.isArray(geoObject.coordinates) &&
-        Array.isArray(geoObject.coordinates[0])) {
-        // @ts-ignore - suppressImplicitAnyIndexErrors
-        // We would not be here if element was not an array.
-        return geoObject.coordinates.map(element => ({ longitude: element[0], latitude: element[1] }));
-    }
-    else {
-        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
-    }
-};
-
-/**
- * Group data that has smaller count then 0.5% (smallestCount) of total count if there is more than 3% (limitToStartGrouping) of them to "Others" group.
- * It can help charts to look better.
- *
- * @param data Input data
- * @param smallestCount Breaking point to start considering the item as candidate to "Others" group [in percentage] - default 0,5%
- * @param limitToStartGrouping Lowest limit of candidates for grouping to "Others" [in percentage] - default 3%
- */
-function groupTinyDataToOthers(data, smallestCount = 0.5, limitToStartGrouping = 3) {
-    if (!data || data.length < 2) {
-        return data;
-    }
-    const breakingPoint = (data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count * smallestCount) / 100;
-    if (data.filter(x => x.count <= breakingPoint).length < 2) {
-        return data;
-    }
-    const others = data
-        .filter(x => x.count <= breakingPoint)
-        .reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count }));
-    const canGroupToOthers = others.count / data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count >
-        limitToStartGrouping / 100;
-    if (!canGroupToOthers) {
-        return data;
-    }
-    const temp = data.filter(x => x.count > breakingPoint);
-    return [...temp, others].sort((a, b) => a.count - b.count);
-}
-
-/**
- * Converts meters to yards
- *
- * @param value The value to convert
- * @returns {number | undefined} The converted value
- */
-const convertMetersToYards = (value) => {
-    if (isNaN(value)) {
-        return;
-    }
-    return Math.round(value * 1.09361);
-};
-/**
- * Converts yards to meters
- *
- * @param value The value to convert
- * @returns {number | undefined} The converted value
- */
-const convertYardsToMeters = (value) => {
-    if (isNaN(value)) {
-        return;
-    }
-    return Math.round(value * 0.9144);
-};
+import { v3, v4, v5 } from 'uuid';
 
 /**
  * @description Formats an address into a single string.
@@ -363,6 +164,107 @@ const size = {
     LARGE: "large",
 };
 
+var HoursAndMinutesFormat;
+(function (HoursAndMinutesFormat) {
+    HoursAndMinutesFormat["HOURS_MIN_SEC_LONG"] = "HOURS_MIN_SEC_LONG";
+    HoursAndMinutesFormat["HOURS_MIN_SEC"] = "HOURS_MIN_SEC";
+    HoursAndMinutesFormat["HOURS_MIN_LONG"] = "HOURS_MIN_LONG";
+    HoursAndMinutesFormat["HOURS_MIN"] = "HOURS_MIN";
+    HoursAndMinutesFormat["HOURS_LONG"] = "HOURS_LONG";
+})(HoursAndMinutesFormat || (HoursAndMinutesFormat = {}));
+const DateTimeFormat = {
+    DATE: {
+        selectFormat: "dateOnly",
+        dateFormat: "short",
+    },
+    DATE_LONG: {
+        selectFormat: "dateOnly",
+        dateFormat: "long",
+    },
+    DATE_LONG_TIME: {
+        dateFormat: "long",
+        timeFormat: "short",
+    },
+    DATE_SHORT: {
+        selectFormat: "dateOnly",
+        dateFormat: "medium",
+    },
+    DATE_SHORT_TIME: {
+        dateFormat: "medium",
+        timeFormat: "short",
+    },
+    TIME_SHORT: {
+        selectFormat: "timeOnly",
+        timeFormat: "short",
+    },
+    TIME_LONG: {
+        selectFormat: "timeOnly",
+        timeFormat: "medium",
+    },
+};
+
+/**
+ * @description Converts a date to a string in ISO format.
+ * @param date  A date object or a date string.
+ * @returns {string | null} A string in ISO format or null if the input is invalid.
+ * @example getISOStringFromDate(new Date("2021-05-19T12:34:56")) // "2021-05-19T12:34:56.000Z"
+ */
+const getISOStringFromDate = (date) => {
+    try {
+        if (!date) {
+            return null;
+        }
+        return new Date(date).toISOString();
+    }
+    catch (err) {
+        return null;
+    }
+};
+/**
+ * @description Returns the difference between two dates in the specified unit.
+ * @param date1 The first date.
+ * @param date2 The second date.
+ * @param unit The unit to return the difference in.
+ * @returns {number} The difference between the two dates in the specified unit.
+ */
+const getDifferenceBetweenDates = (date1, date2, unit) => {
+    const diffInMs = Math.abs(date2.getTime() - date1.getTime());
+    switch (unit) {
+        case "days":
+            return Math.floor(diffInMs / (1000 * 60 * 60 * 24));
+        case "hours":
+            return Math.floor(diffInMs / (1000 * 60 * 60));
+        case "minutes":
+            return Math.floor(diffInMs / (1000 * 60));
+        case "seconds":
+            return Math.floor(diffInMs / 1000);
+        default:
+            throw new Error("Invalid unit parameter");
+    }
+};
+/**
+ * @description Returns the start of the day for a given date.
+ * @param date A date object or a date string.
+ * @returns {Date} The start of the day for the given date.
+ * @example getStartOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T00:00:00"
+ */
+const getStartOfDay = (date) => {
+    const selectedDate = new Date(date);
+    selectedDate.setHours(0, 0, 0, 0);
+    return selectedDate;
+};
+/**
+ * @description Returns the end of the day for a given date.
+ * @param date A date object or a date string.
+ * @returns {Date} The end of the day for the given date.
+ * @example getEndOfDay(new Date("2021-05-19T12:34:56")) // "2021-05-19T23:59:59"
+ */
+const getEndOfDay = (date) => {
+    const selectedDate = new Date(date);
+    selectedDate.setHours(23, 59, 59, 999);
+    return selectedDate;
+};
+
 /**
  * Do nothing usefull for creating mocks without dependency on jest or anything else.
  */
@@ -509,6 +411,53 @@ searchTerm) => {
         .every(term => filterableProps(asset).some(value => value.toLowerCase().includes(term.toLowerCase()))));
 };
 
+/**
+ * @description Extracts a point coordinate from a GeoJSON object.
+ * @param geoObject A GeoJSON object.
+ * @returns {PointCoordinate} A point coordinate.
+ */
+const getPointCoordinateFromGeoJsonObject = (geoObject) => {
+    if (!geoObject) {
+        return undefined;
+    }
+    else if ("geometry" in geoObject) {
+        return getPointCoordinateFromGeoJsonObject(geoObject.geometry);
+    }
+    else if ("coordinates" in geoObject &&
+        Array.isArray(geoObject.coordinates) &&
+        typeof geoObject.coordinates[0] === "number" &&
+        typeof geoObject.coordinates[1] === "number") {
+        return { longitude: geoObject.coordinates[0], latitude: geoObject.coordinates[1] };
+    }
+    else {
+        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
+    }
+};
+/**
+ * @description Extracts multiple point coordinates from a GeoJSON object.
+ * @param geoObject A GeoJSON object.
+ * @returns {PointCoordinate[]} An array of point coordinates.
+ * @example getMultipleCoordinatesFromGeoJsonObject({ type: "Point", coordinates: [1, 2] }) // [{ longitude: 1, latitude: 2 }]
+ */
+const getMultipleCoordinatesFromGeoJsonObject = (geoObject) => {
+    if (!geoObject) {
+        return undefined;
+    }
+    else if ("geometry" in geoObject) {
+        return getMultipleCoordinatesFromGeoJsonObject(geoObject.geometry);
+    }
+    else if ("coordinates" in geoObject &&
+        Array.isArray(geoObject.coordinates) &&
+        Array.isArray(geoObject.coordinates[0])) {
+        // @ts-ignore - suppressImplicitAnyIndexErrors
+        // We would not be here if element was not an array.
+        return geoObject.coordinates.map(element => ({ longitude: element[0], latitude: element[1] }));
+    }
+    else {
+        throw new Error(`Unable to extract point coordinate from ${JSON.stringify(geoObject)}`);
+    }
+};
+
 /**
  * Group an array of items by a key.
  *
@@ -536,6 +485,34 @@ function groupBy(list, getKey) {
     return groupedMap;
 }
 
+/**
+ * Group data that has smaller count then 0.5% (smallestCount) of total count if there is more than 3% (limitToStartGrouping) of them to "Others" group.
+ * It can help charts to look better.
+ *
+ * @param data Input data
+ * @param smallestCount Breaking point to start considering the item as candidate to "Others" group [in percentage] - default 0,5%
+ * @param limitToStartGrouping Lowest limit of candidates for grouping to "Others" [in percentage] - default 3%
+ */
+function groupTinyDataToOthers(data, smallestCount = 0.5, limitToStartGrouping = 3) {
+    if (!data || data.length < 2) {
+        return data;
+    }
+    const breakingPoint = (data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count * smallestCount) / 100;
+    if (data.filter(x => x.count <= breakingPoint).length < 2) {
+        return data;
+    }
+    const others = data
+        .filter(x => x.count <= breakingPoint)
+        .reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count }));
+    const canGroupToOthers = others.count / data.reduce((x, y) => ({ key: "GroupedOthers", count: x.count + y.count })).count >
+        limitToStartGrouping / 100;
+    if (!canGroupToOthers) {
+        return data;
+    }
+    const temp = data.filter(x => x.count > breakingPoint);
+    return [...temp, others].sort((a, b) => a.count - b.count);
+}
+
 const UUID_HYPHEN_POSITIONS = [8, 12, 16, 20];
 const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-5][0-9a-f]{3}-[089ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 /**
@@ -1072,4 +1049,59 @@ const isSorted = (sortInput) => {
     return originalKeys.every((key, index) => key === sortedKeys[index]);
 };
 
-export { DateTimeFormat, HoursAndMinutesFormat, align, alphabeticallySort, arrayLengthCompare, arrayNotEmpty, booleanCompare, capitalize, convertBlobToBase64, convertMetersToYards, convertYardsToMeters, dateCompare, deleteUndefinedKeys, difference, doNothing, enumFromValue, enumFromValueTypesafe, enumOrUndefinedFromValue, exhaustiveCheck, filterByMultiple, formatAddress, formatCoordinates, fuzzySearch, getDifferenceBetweenDates, getEndOfDay, getFirstLevelObjectPropertyDifferences, getISOStringFromDate, getMultipleCoordinatesFromGeoJsonObject, getPointCoordinateFromGeoJsonObject, getResizedDimensions, getStartOfDay, groupBy, groupTinyDataToOthers, hourIntervals, intersection, isArrayEqual, isSorted, isUUID, isValidImage, nonNullable, numberCompare, numberCompareUnknownAfterHighest, objNotEmpty, objectEntries, objectFromEntries, objectKeys, objectValues, pick, removeLeftPadding, resizeBlob, resizeImage, size, stringCompare, stringCompareFromKey, stringNaturalCompare, stripHiddenCharacters, titleCase, toID, toIDs, toUUID, trimIds, trimPath, truthy, unionArraysByKey };
+/**
+ * Converts meters to yards
+ *
+ * @param value The value to convert
+ * @returns {number | undefined} The converted value
+ */
+const convertMetersToYards = (value) => {
+    if (isNaN(value)) {
+        return;
+    }
+    return Math.round(value * 1.09361);
+};
+/**
+ * Converts yards to meters
+ *
+ * @param value The value to convert
+ * @returns {number | undefined} The converted value
+ */
+const convertYardsToMeters = (value) => {
+    if (isNaN(value)) {
+        return;
+    }
+    return Math.round(value * 0.9144);
+};
+
+/**
+ * Generates a version 3 UUID (namespace with MD5).
+ *
+ * @param {string} name - The name for which to generate the UUID.
+ * @param {string | Buffer} namespace - The namespace for the UUID.
+ * @returns {string} A version 3 UUID.
+ */
+const uuidv3 = (name, namespace) => v3(name, namespace);
+/**
+ * Generates a random version 4 UUID.
+ *
+ * @returns {string} A version 4 UUID.
+ */
+const uuidv4 = () => {
+    if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") {
+        return crypto.randomUUID().toString();
+    }
+    else {
+        return v4();
+    }
+};
+/**
+ * Generates a version 5 UUID (namespace with SHA-1).
+ *
+ * @param {string} name - The name for which to generate the UUID.
+ * @param {string | Buffer} namespace - The namespace for the UUID.
+ * @returns {string} A version 5 UUID.
+ */
+const uuidv5 = (name, namespace) => v5(name, namespace);
+
+export { DateTimeFormat, HoursAndMinutesFormat, align, alphabeticallySort, arrayLengthCompare, arrayNotEmpty, booleanCompare, capitalize, convertBlobToBase64, convertMetersToYards, convertYardsToMeters, dateCompare, deleteUndefinedKeys, difference, doNothing, enumFromValue, enumFromValueTypesafe, enumOrUndefinedFromValue, exhaustiveCheck, filterByMultiple, formatAddress, formatCoordinates, fuzzySearch, getDifferenceBetweenDates, getEndOfDay, getFirstLevelObjectPropertyDifferences, getISOStringFromDate, getMultipleCoordinatesFromGeoJsonObject, getPointCoordinateFromGeoJsonObject, getResizedDimensions, getStartOfDay, groupBy, groupTinyDataToOthers, hourIntervals, intersection, isArrayEqual, isSorted, isUUID, isValidImage, nonNullable, numberCompare, numberCompareUnknownAfterHighest, objNotEmpty, objectEntries, objectFromEntries, objectKeys, objectValues, pick, removeLeftPadding, resizeBlob, resizeImage, size, stringCompare, stringCompareFromKey, stringNaturalCompare, stripHiddenCharacters, titleCase, toID, toIDs, toUUID, trimIds, trimPath, truthy, unionArraysByKey, uuidv3, uuidv4, uuidv5 };

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@trackunit/shared-utils",
-  "version": "0.0.78",
+  "version": "0.0.79",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=20.x"
   },
   "dependencies": {
-    "uuid": "^9.0.1"
+    "uuid": "^10.0.0"
   },
   "module": "./index.esm.js",
   "main": "./index.cjs.js",

package/src/UUID.d.ts

@@ -7,7 +7,7 @@
  */
 declare const uuidv3: (name: string, namespace: string | Buffer) => string;
 /**
- * Generates a version 4 UUID using the Node.js crypto module.
+ * Generates a random version 4 UUID.
  *
  * @returns {string} A version 4 UUID.
  */

package/src/index.d.ts

@@ -1,18 +1,17 @@
-export * from "./DateTimeFormat";
-export * from "./DateUtils";
-export * from "./GeoJsonUtils";
-export * from "./GroupingUtility";
-export * from "./UnitOfMeasurementConverter";
 export * from "./addressUtils";
 export * from "./arrayUtils";
 export * from "./constants";
+export * from "./DateTimeFormat";
+export * from "./DateUtils";
 export * from "./deepPartial";
 export * from "./doNothing";
 export * from "./enumUtils";
 export * from "./exhaustiveCheck";
 export * from "./fastArrayOperations";
 export * from "./filter";
+export * from "./GeoJsonUtils";
 export * from "./groupBy/groupBy";
+export * from "./GroupingUtility";
 export * from "./idUtils";
 export * from "./maybe";
 export * from "./objectUtils";
@@ -22,3 +21,5 @@ export * from "./sorting/sorting";
 export * from "./stringUtils";
 export * from "./translationUtils";
 export * from "./typeUtils";
+export * from "./UnitOfMeasurementConverter";
+export * from "./UUID";