2022-12-03 05:27:06 +03:00
|
|
|
/**
|
|
|
|
* 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]
|
|
|
|
*/
|
2022-09-05 23:57:11 +03:00
|
|
|
import { randomBytes as crypto_random } from "./crypto.js";
|
|
|
|
let locked = false;
|
|
|
|
const _randomBytes = function (length) {
|
|
|
|
return new Uint8Array(crypto_random(length));
|
|
|
|
};
|
|
|
|
let __randomBytes = _randomBytes;
|
2022-12-03 05:27:06 +03:00
|
|
|
/**
|
|
|
|
* Return %%length%% bytes of cryptographically secure random data.
|
2022-12-10 02:24:58 +03:00
|
|
|
*
|
|
|
|
* @example:
|
|
|
|
* randomBytes(8)
|
|
|
|
* //_result:
|
2022-12-03 05:27:06 +03:00
|
|
|
*/
|
2022-09-05 23:57:11 +03:00
|
|
|
export function randomBytes(length) {
|
|
|
|
return __randomBytes(length);
|
|
|
|
}
|
|
|
|
randomBytes._ = _randomBytes;
|
|
|
|
randomBytes.lock = function () { locked = true; };
|
|
|
|
randomBytes.register = function (func) {
|
|
|
|
if (locked) {
|
2022-10-01 08:34:06 +03:00
|
|
|
throw new Error("randomBytes is locked");
|
2022-09-05 23:57:11 +03:00
|
|
|
}
|
|
|
|
__randomBytes = func;
|
|
|
|
};
|
|
|
|
Object.freeze(randomBytes);
|
|
|
|
//# sourceMappingURL=random.js.map
|