@tmlmobilidade/utils 20250725.154.46 → 20250725.246.45

package/dist/index.d.ts

@@ -2,12 +2,11 @@ export * from './src/batching/index.js';
 export * from './src/convert-object.js';
 export * from './src/dates/index.js';
 export * from './src/files/files.js';
-export * from './src/generate-random-string.js';
-export * from './src/generate-random-token.js';
 export * from './src/generic/index.js';
 export * from './src/geo/index.js';
 export * from './src/http.js';
 export * from './src/navigation/index.js';
 export * from './src/permissions.js';
+export * from './src/random/index.js';
 export * from './src/singleton-proxy.js';
 export * from './src/strings/index.js';

package/dist/index.js

@@ -2,12 +2,11 @@ export * from './src/batching/index.js';
 export * from './src/convert-object.js';
 export * from './src/dates/index.js';
 export * from './src/files/files.js';
-export * from './src/generate-random-string.js';
-export * from './src/generate-random-token.js';
 export * from './src/generic/index.js';
 export * from './src/geo/index.js';
 export * from './src/http.js';
 export * from './src/navigation/index.js';
 export * from './src/permissions.js';
+export * from './src/random/index.js';
 export * from './src/singleton-proxy.js';
 export * from './src/strings/index.js';

package/dist/src/random/generate-random-number.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates a secure random number between 0 and 1.
+ * This function uses the Web Crypto API so it is suitable
+ * for cryptographic purposes.
+ * @returns A random number between 0 and 1
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Crypto/getRandomValues
+ */
+export declare function generateRandomNumber(): number;

package/dist/src/random/generate-random-number.js

@@ -0,0 +1,14 @@
+/* * */
+import crypto from 'crypto';
+/**
+ * Generates a secure random number between 0 and 1.
+ * This function uses the Web Crypto API so it is suitable
+ * for cryptographic purposes.
+ * @returns A random number between 0 and 1
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Crypto/getRandomValues
+ */
+export function generateRandomNumber() {
+    const array = new Uint32Array(1);
+    crypto.getRandomValues(array);
+    return array[0] / 2 ** 32;
+}

package/dist/src/random/generate-random-string.d.ts

@@ -0,0 +1,12 @@
+interface GenerateRandomStringProps {
+    length?: number;
+    type?: 'alphanumeric' | 'numeric';
+}
+/**
+ * Creates a random string of a given length and type.
+ * @param length The length of the string to generate. Defaults to `6`.
+ * @param type The type of characters to include in the string. Defaults to `alphanumeric`.
+ * @returns A random string of the specified length.
+ */
+export declare function generateRandomString({ length, type }: GenerateRandomStringProps): string;
+export {};

package/dist/src/{generate-random-string.js → random/generate-random-string.js}

@@ -1,11 +1,12 @@
 /* * */
+import { generateRandomNumber } from './generate-random-number.js';
 /**
  * Creates a random string of a given length and type.
- * @param length - The length of the string to generate.
- * @param type - The type of characters to include in the string.
+ * @param length The length of the string to generate. Defaults to `6`.
+ * @param type The type of characters to include in the string. Defaults to `alphanumeric`.
  * @returns A random string of the specified length.
  */
-export function generateRandomString({ length = 6, type = 'alphanumeric' } = {}) {
+export function generateRandomString({ length = 6, type = 'alphanumeric' }) {
     //
     const numericSet = '0123456789';
     const alphanumericSet = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
@@ -20,7 +21,7 @@ export function generateRandomString({ length = 6, type = 'alphanumeric' } = {})
     }
     let result = '';
     for (let i = 0; i < length; i++) {
-        result += allowedCharacters.charAt(Math.floor(Math.random() * allowedCharacters.length));
+        result += allowedCharacters.charAt(Math.floor(generateRandomNumber() * allowedCharacters.length));
     }
     return result;
     //

package/dist/src/random/generate-random-token.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Generates a secure random token.
+ * This function uses the Node.js crypto module to generate
+ * a random token suitable for cryptographic purposes.
+ * @returns A random token as a hexadecimal string.
+ * @see https://nodejs.org/api/crypto.html#crypto_crypto_randombytes_size_callback
+ */
+export declare function generateRandomToken(): string;

package/dist/src/random/generate-random-token.js

@@ -0,0 +1,12 @@
+/* * */
+import crypto from 'crypto';
+/**
+ * Generates a secure random token.
+ * This function uses the Node.js crypto module to generate
+ * a random token suitable for cryptographic purposes.
+ * @returns A random token as a hexadecimal string.
+ * @see https://nodejs.org/api/crypto.html#crypto_crypto_randombytes_size_callback
+ */
+export function generateRandomToken() {
+    return crypto.randomBytes(32).toString('hex');
+}

package/dist/src/random/index.d.ts

@@ -0,0 +1,3 @@
+export * from './generate-random-number.js';
+export * from './generate-random-string.js';
+export * from './generate-random-token.js';

package/dist/src/random/index.js

@@ -0,0 +1,3 @@
+export * from './generate-random-number.js';
+export * from './generate-random-string.js';
+export * from './generate-random-token.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/utils",
-	"version": "20250725.154.46",
+	"version": "20250725.246.45",
 	"author": "João de Vasconcelos & Jusi Monteiro",
 	"license": "AGPL-3.0-or-later",
 	"homepage": "https://github.com/tmlmobilidade/services#readme",
@@ -47,7 +47,6 @@
 		"luxon": "3.7.1",
 		"mergekit": "3.0.6",
 		"papaparse": "5.5.3",
-		"uuid": "11.1.0",
 		"zod": "3.25.76"
 	},
 	"devDependencies": {
@@ -55,7 +54,7 @@
 		"@tmlmobilidade/tsconfig": "*",
 		"@tmlmobilidade/types": "*",
 		"@types/luxon": "3.6.2",
-		"@types/node": "24.0.15",
+		"@types/node": "24.1.0",
 		"@types/papaparse": "5.3.16",
 		"resolve-tspaths": "0.8.23",
 		"rimraf": "6.0.1",

package/dist/src/generate-random-string.d.ts

@@ -1,12 +0,0 @@
-interface GenerateRandomStringOptions {
-    length?: number;
-    type?: 'alphanumeric' | 'numeric';
-}
-/**
- * Creates a random string of a given length and type.
- * @param length - The length of the string to generate.
- * @param type - The type of characters to include in the string.
- * @returns A random string of the specified length.
- */
-export declare function generateRandomString({ length, type }?: GenerateRandomStringOptions): string;
-export {};

package/dist/src/generate-random-token.d.ts

@@ -1 +0,0 @@
-export declare function generateRandomToken(): string;

package/dist/src/generate-random-token.js

@@ -1,6 +0,0 @@
-/* * */
-import { v4 as uuid } from 'uuid';
-/* * */
-export function generateRandomToken() {
-    return Buffer.from(uuid()).toString('base64');
-}