@tmlmobilidade/utils 20250822.1829.15 → 20250822.1847.54

package/dist/src/geo/coordinates.d.ts

@@ -17,14 +17,21 @@ export declare function isValidLongitude(value: number): boolean;
  * @returns True if the coordinate pair is valid, false otherwise.
  */
 export declare function isValidCoordinatePair(lat: number, lng: number): boolean;
+/**
+ * Clamps a coordinate value to 6 decimal places.
+ * @param value The coordinate value to clamp.
+ * @returns The clamped coordinate value.
+ */
+export declare function clampCoordinate(value: number): number;
 /**
  * Parses a coordinate string in the following formats:
  * - `lat, lng`
  * - `lat lng` (with a space or a tab)
  * @param input The coordinate string to parse.
+ * @param clamp Whether to clamp the latitude and longitude values to 6 decimal places.
  * @returns The parsed coordinates as an object, or null if the input is invalid.
  */
-export declare const parseCoordinateString: (input: string) => null | {
+export declare const parseCoordinateString: (input: string, clamp?: boolean) => null | {
     lat: number;
     lng: number;
 };

package/dist/src/geo/coordinates.js

@@ -24,19 +24,31 @@ export function isValidLongitude(value) {
 export function isValidCoordinatePair(lat, lng) {
     return isValidLatitude(lat) && isValidLongitude(lng);
 }
+/**
+ * Clamps a coordinate value to 6 decimal places.
+ * @param value The coordinate value to clamp.
+ * @returns The clamped coordinate value.
+ */
+export function clampCoordinate(value) {
+    return parseFloat(value.toFixed(6));
+}
 /**
  * Parses a coordinate string in the following formats:
  * - `lat, lng`
  * - `lat lng` (with a space or a tab)
  * @param input The coordinate string to parse.
+ * @param clamp Whether to clamp the latitude and longitude values to 6 decimal places.
  * @returns The parsed coordinates as an object, or null if the input is invalid.
  */
-export const parseCoordinateString = (input) => {
+export const parseCoordinateString = (input, clamp = true) => {
     const regex = /^\s*([+-]?\d+(?:\.\d+)?)\s*(?:,|\s)\s*([+-]?\d+(?:\.\d+)?)\s*$/;
     const match = input.match(regex);
     if (!match)
         return null;
     const lat = parseFloat(match[1]);
     const lng = parseFloat(match[2]);
-    return isValidCoordinatePair(lat, lng) ? { lat, lng } : null;
+    if (clamp)
+        return isValidCoordinatePair(lat, lng) ? { lat: clampCoordinate(lat), lng: clampCoordinate(lng) } : null;
+    else
+        return isValidCoordinatePair(lat, lng) ? { lat, lng } : null;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/utils",
-	"version": "20250822.1829.15",
+	"version": "20250822.1847.54",
 	"author": "João de Vasconcelos & Jusi Monteiro",
 	"license": "AGPL-3.0-or-later",
 	"homepage": "https://github.com/tmlmobilidade/services#readme",