37 lines
1.0 KiB
TypeScript
37 lines
1.0 KiB
TypeScript
/**
|
|
* A **Cryptographically Secure Random Value** is one that has been
|
|
* generated with additional care take to prevent side-channels
|
|
* from allowing others to detect it and prevent others from through
|
|
* coincidence generate the same values.
|
|
*
|
|
* @_subsection: api/crypto:Random Values [about-crypto-random]
|
|
*/
|
|
import { randomBytes as crypto_random } from "./crypto.js";
|
|
|
|
let locked = false;
|
|
|
|
const _randomBytes = function(length: number): Uint8Array {
|
|
return new Uint8Array(crypto_random(length));
|
|
}
|
|
|
|
let __randomBytes = _randomBytes;
|
|
|
|
/**
|
|
* Return %%length%% bytes of cryptographically secure random data.
|
|
*
|
|
* @example:
|
|
* randomBytes(8)
|
|
* //_result:
|
|
*/
|
|
export function randomBytes(length: number): Uint8Array {
|
|
return __randomBytes(length);
|
|
}
|
|
|
|
randomBytes._ = _randomBytes;
|
|
randomBytes.lock = function(): void { locked = true; }
|
|
randomBytes.register = function(func: (length: number) => Uint8Array) {
|
|
if (locked) { throw new Error("randomBytes is locked"); }
|
|
__randomBytes = func;
|
|
}
|
|
Object.freeze(randomBytes);
|