@tmlmobilidade/utils 20260326.2139.30 → 20260327.0.15

package/dist/index.d.ts

@@ -3,6 +3,7 @@ export * from './caching/index.js';
 export * from './generic/index.js';
 export * from './get-public-trip-id.js';
 export * from './http.js';
+export * from './numbers/index.js';
 export * from './objects/index.js';
 export * from './permissions.js';
 export * from './run-on-interval.js';

package/dist/index.js

@@ -3,6 +3,7 @@ export * from './caching/index.js';
 export * from './generic/index.js';
 export * from './get-public-trip-id.js';
 export * from './http.js';
+export * from './numbers/index.js';
 export * from './objects/index.js';
 export * from './permissions.js';
 export * from './run-on-interval.js';

package/dist/numbers/index.d.ts

@@ -0,0 +1 @@
+export * from './to-int.js';

package/dist/numbers/index.js

@@ -0,0 +1 @@
+export * from './to-int.js';

package/dist/numbers/to-int.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Utility function to convert a number to an integer,
+ * handling null and undefined values gracefully.
+ * @param value The value to convert to an integer. Can be a number, null, or undefined.
+ * @returns The rounded integer value if the input is a number, or null if the input is null or undefined.
+ * @example
+ * roundToInt(3.7); // returns 4
+ * roundToInt(-2.3); // returns -2
+ * roundToInt(null); // returns null
+ * roundToInt(undefined); // returns null
+ */
+export declare function roundToInt(value: null | number | string | undefined): null | number;
+/**
+ * Utility function to convert a number to an integer,
+ * handling null and undefined values gracefully.
+ * @param value The value to convert to an integer. Can be a number, null, or undefined.
+ * @returns The truncated integer value if the input is a number, or null if the input is null or undefined.
+ * @example
+ * truncToInt(3.7); // returns 3
+ * truncToInt(-2.3); // returns -2
+ * truncToInt(null); // returns null
+ * truncToInt(undefined); // returns null
+ */
+export declare function truncToInt(value: null | number | string | undefined): null | number;

package/dist/numbers/to-int.js

@@ -0,0 +1,39 @@
+/* * */
+/**
+ * Utility function to convert a number to an integer,
+ * handling null and undefined values gracefully.
+ * @param value The value to convert to an integer. Can be a number, null, or undefined.
+ * @returns The rounded integer value if the input is a number, or null if the input is null or undefined.
+ * @example
+ * roundToInt(3.7); // returns 4
+ * roundToInt(-2.3); // returns -2
+ * roundToInt(null); // returns null
+ * roundToInt(undefined); // returns null
+ */
+export function roundToInt(value) {
+    if (value === null || value === undefined)
+        return null;
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num))
+        return null;
+    return Math.round(num);
+}
+/**
+ * Utility function to convert a number to an integer,
+ * handling null and undefined values gracefully.
+ * @param value The value to convert to an integer. Can be a number, null, or undefined.
+ * @returns The truncated integer value if the input is a number, or null if the input is null or undefined.
+ * @example
+ * truncToInt(3.7); // returns 3
+ * truncToInt(-2.3); // returns -2
+ * truncToInt(null); // returns null
+ * truncToInt(undefined); // returns null
+ */
+export function truncToInt(value) {
+    if (value === null || value === undefined)
+        return null;
+    const num = typeof value === 'string' ? parseFloat(value) : value;
+    if (isNaN(num))
+        return null;
+    return Math.trunc(num);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/utils",
-	"version": "20260326.2139.30",
+	"version": "20260327.0.15",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"