@tmlmobilidade/utils 20250725.154.46 → 20250725.239.2

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 webcrypto 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);
+    webcrypto.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.
+ * @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 }: 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.
+ * @param type The type of characters to include in the string.
  * @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/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.239.2",
 	"author": "João de Vasconcelos & Jusi Monteiro",
 	"license": "AGPL-3.0-or-later",
 	"homepage": "https://github.com/tmlmobilidade/services#readme",

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 {};