adding proper types to index.d.ts, adding first itteration of PRNG. Neither CSPRNG nor PRNG are yet ready to use

Author: Drazail

JSHash/lib/core/Random/PRNG.js

@@ -0,0 +1,30 @@
+/* eslint linebreak-style: ["error", "windows"] */
+
+// Generate a random integer r with equal chance in  min <= r < max.
+const randrange = (min, max) => {
+  const range = max - min;
+  if (range <= 0) {
+    throw new Error('max must be larger than min');
+  }
+  const requestBytes = Math.ceil(Math.log2(range) / 8);
+  if (!requestBytes) { // No randomness required
+    return min;
+  }
+  const maxNum = (256) ** (requestBytes);
+  const ar = new Uint8Array(requestBytes);
+
+  while (true) {
+    window.crypto.getRandomValues(ar);
+
+    let val = 0;
+    for (let i = 0; i < requestBytes; i += 1) {
+      val = (val << 8) + ar[i];
+    }
+
+    if (val < (maxNum - maxNum) % range) {
+      return min + (val % range);
+    }
+  }
+};
+
+export default randrange;

JSHash/random.js

@@ -0,0 +1,3 @@
+/* eslint linebreak-style: ["error", "windows"] */
+
+export { default as PRNG } from './lib/core/Random/PRNG.js';

index.d.ts

@@ -1,65 +1,65 @@
-import RNHash from ".";
+declare namespace RNHash {
 
-export as namespace RNHash;
+    function hashFile(uri: string, algorithm: string): Promise<string>;
+    /**
+     * 
+     * @param uri uri pointing to File or directory
+     * @param algorithm algorithm to be used for hashing
+     * @param minFileSize minimum file size to be hashed in bytes
+     * @param maxFileSize maximum file size to be hashed in bytes
+     * @param extensionFilter extension of files to be hashed, pass "" to ignore this option
+     * @param batchSize event batch size, pass -1 to retrieve all results on .then instead of events
+     * @returns Promise -- if batchSize is set to -1, the promise.resolve contains all the hashes, otherwise, it resolves to null.
+     */
+    function hashFilesForFolder(
+        uri: string, algorithm: string, minFileSize: number, maxFileSize: number, extensionFilter: string, batchSize: number, delay: number
+    ): Promise<{ FilesCount: number, isFinalBatch: boolean, batchNumber: number, results: Record<string, string> }>;
 
-export function hashFile(uri: string, algorithm: string): Promise<string>;
-/**
- * 
- * @param uri uri pointing to File or directory
- * @param algorithm algorithm to be used for hashing
- * @param minFileSize minimum file size to be hashed in bytes
- * @param maxFileSize maximum file size to be hashed in bytes
- * @param extensionFilter extension of files to be hashed, pass "" to ignore this option
- * @param batchSize event batch size, pass -1 to retrieve all results on .then instead of events
- * @returns Promise -- if batchSize is set to -1, the promise.resolve contains all the hashes, otherwise, it resolves to null.
- */
-export function hashFilesForFolder(
-    uri: string, algorithm: string, minFileSize: number, maxFileSize: number, extensionFilter: string, batchSize: number, delay: number
-): Promise<{ FilesCount: number, isFinalBatch: bool, batchNumber: number, results: Record<string, string> }>;
+    function hashFilesForFolders(
+        uri: Array<string>, algorithm: string, minFileSize: number, maxFileSize: number, extensionFilter: string, batchSize: number, delay: number
+    ): Promise<{ FilesCount: number, isFinalBatch: boolean, batchNumber: number, results: Record<string, string> }>;
 
-export function hashFilesForFolders(
-    uri: Array<string>, algorithm: string, minFileSize: number, maxFileSize: number, extensionFilter: string, batchSize: number, delay: number
-): Promise<{ FilesCount: number, isFinalBatch: bool, batchNumber: number, results: Record<string, string> }>;
+
+    function hashUrl(url: string, HTTPMethod: string, headers: Record<string, string>, algorithm: string): Promise<string>;
+    function hashString(message: string, algorithm: string): Promise<string>;
+    function generateHmac(message: string, key: string, algorithm: string): Promise<string>;
+}
 
 
-export function hashUrl(url: string, HTTPMethod: string, headers: Record<string, string>, algorithm: string): Promise<string>;
-export function hashString(message: string, algorithm: string): Promise<string>;
-export function generateHmac(message: string, key: string, algorithm: string): Promise<string>;
 
 export namespace CONSTANTS {
     export namespace HashAlgorithms {
         export const md2: string;
-        export const md5: String;
-        export const sha1: String;
-        export const sha224: String;
-        export const sha256: String;
-        export const sha384: String;
-        export const sha512: String;
-        export const keccak: String;
+        export const md5: string;
+        export const sha1: string;
+        export const sha224: string;
+        export const sha256: string;
+        export const sha384: string;
+        export const sha512: string;
+        export const keccak: string;
     }
     export namespace HmacAlgorithms {
-        export const HmacMD5: String;
-        export const HmacSHA1: String;
-        export const HmacSHA224: String;
-        export const HmacSHA256: String;
-        export const HmacSHA384: String;
-        export const HmacSHA512: String;
-        export const PBEwithHmacSHA: String;
-        export const PBEwithHmacSHA1: String;
-        export const PBEwithHmacSHA224: String;
-        export const PBEwithHmacSHA256: String;
-        export const PBEwithHmacSHA384: String;
-        export const PBEwithHmacSHA512: String;
+        export const HmacMD5: string;
+        export const HmacSHA1: string;
+        export const HmacSHA224: string;
+        export const HmacSHA256: string;
+        export const HmacSHA384: string;
+        export const HmacSHA512: string;
+        export const PBEwithHmacSHA: string;
+        export const PBEwithHmacSHA1: string;
+        export const PBEwithHmacSHA224: string;
+        export const PBEwithHmacSHA256: string;
+        export const PBEwithHmacSHA384: string;
+        export const PBEwithHmacSHA512: string;
     }
     export namespace Events {
-        export const onBatchReccieved: String;
+        export const onBatchReccieved: string;
     }
 }
 
-export namespace JSHash {
-    export function hashString(message: string, algorithm: string): Promise<string>;
-}
 
-export namespace JSHmac {
-    export function hashString(message: string, secret: string, algorithm: string): Promise<string>;
-}
+export default RNHash;
+
+export function JSHash(message: string, algorithm: string): Promise<string>;
+
+export function JSHmac(message: string, secret: string, algorithm: string): Promise<string>;