@kottetall/random 0.0.4 → 0.0.6

package/lib/constants/name.constant.d.ts

@@ -0,0 +1,10 @@
+export declare const gender: {
+    readonly MALE: "male";
+    readonly FEMALE: "female";
+    readonly UNISEX: "unisex";
+};
+export declare const firstNameNeutral: readonly ["Alex", "Ari", "Ash", "Avery", "Bo", "Cai", "Kai", "Casey", "Chris", "Dani", "Eli", "Emi", "Jay", "Jesse", "Jordan", "Lee", "Lian", "Luca", "Luka", "Max", "Mika", "Mica", "Quinn", "Ren", "Rio", "Robin", "Sam", "Sky", "Sora", "Tao", "Taylor", "Toni", "Yuri", "Zion"];
+export declare const firstNameMale: readonly ["Adam", "Adrian", "Ahmed", "Ahmad", "Alan", "Alejandro", "André", "Antonio", "Arjun", "Ben", "Carlos", "Daniel", "David", "Diego", "Ethan", "Felix", "Gabriel", "Hassan", "Hugo", "Ibrahim", "Ivan", "Jack", "James", "Jason", "John", "Joseph", "Julian", "Kevin", "Leo", "Lucas", "Luis", "Marco", "Mark", "Martin", "Mateo", "Michael", "Mohammed", "Muhammad", "Nico", "Noah", "Oliver", "Omar", "Oscar", "Paul", "Rafael", "Samir", "Sebastian", "Simon", "Thomas", "Victor", "William", "Yusuf", "Youssef", "Zayn"];
+export declare const firstNameFemale: readonly ["Aisha", "Ayesha", "Alice", "Amelia", "Ana", "Anna", "Aya", "Bea", "Carla", "Clara", "Diana", "Elena", "Ella", "Emma", "Eva", "Fatima", "Hana", "Hanna", "Isabella", "Jade", "Julia", "Khadija", "Lara", "Leila", "Layla", "Lina", "Lucia", "Maria", "Maya", "Mina", "Nadia", "Naomi", "Nina", "Olivia", "Rania", "Rosa", "Sara", "Sarah", "Sofia", "Sophia", "Tara", "Yara", "Zara"];
+export declare const lastname: readonly ["Ali", "Ahmed", "Anderson", "Brown", "Chen", "Garcia", "Hassan", "Ivanov", "Khan", "Kim", "Lee", "Li", "Lopez", "Martin", "Mohamed", "Nguyen", "Patel", "Rodriguez", "Singh", "Smith", "Wang", "Zhang", "Andersson", "Anderson", "Baker", "Bianchi", "Black", "Blanco", "Clark", "Costa", "Dubois", "Evans", "Fischer", "Fisher", "Fontana", "Gonzalez", "Hansen", "Johansson", "Jones", "Kowalski", "Larsen", "Müller", "Muller", "Novak", "Petrov", "Rossi", "Schmidt", "Schmidt", "Silva", "Taylor", "Walker", "White"];
+//# sourceMappingURL=name.constant.d.ts.map

package/lib/constants/name.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.constant.d.ts","sourceRoot":"","sources":["../../src/constants/name.constant.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;CAIT,CAAC;AAEX,eAAO,MAAM,gBAAgB,qRAmCnB,CAAC;AAEX,eAAO,MAAM,aAAa,qgBAuDhB,CAAC;AAEX,eAAO,MAAM,eAAe,iYA4ClB,CAAC;AAEX,eAAO,MAAM,QAAQ,sgBAqDX,CAAC"}

package/lib/constants/name.constant.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lastname = exports.firstNameFemale = exports.firstNameMale = exports.firstNameNeutral = exports.gender = void 0;
+exports.gender = {
+    MALE: "male",
+    FEMALE: "female",
+    UNISEX: "unisex",
+};
+exports.firstNameNeutral = [
+    "Alex",
+    "Ari",
+    "Ash",
+    "Avery",
+    "Bo",
+    "Cai",
+    "Kai",
+    "Casey",
+    "Chris",
+    "Dani",
+    "Eli",
+    "Emi",
+    "Jay",
+    "Jesse",
+    "Jordan",
+    "Lee",
+    "Lian",
+    "Luca",
+    "Luka",
+    "Max",
+    "Mika",
+    "Mica",
+    "Quinn",
+    "Ren",
+    "Rio",
+    "Robin",
+    "Sam",
+    "Sky",
+    "Sora",
+    "Tao",
+    "Taylor",
+    "Toni",
+    "Yuri",
+    "Zion",
+];
+exports.firstNameMale = [
+    "Adam",
+    "Adrian",
+    "Ahmed",
+    "Ahmad",
+    "Alan",
+    "Alejandro",
+    "André",
+    "Antonio",
+    "Arjun",
+    "Ben",
+    "Carlos",
+    "Daniel",
+    "David",
+    "Diego",
+    "Ethan",
+    "Felix",
+    "Gabriel",
+    "Hassan",
+    "Hugo",
+    "Ibrahim",
+    "Ivan",
+    "Jack",
+    "James",
+    "Jason",
+    "John",
+    "Joseph",
+    "Julian",
+    "Kevin",
+    "Leo",
+    "Lucas",
+    "Luis",
+    "Marco",
+    "Mark",
+    "Martin",
+    "Mateo",
+    "Michael",
+    "Mohammed",
+    "Muhammad",
+    "Nico",
+    "Noah",
+    "Oliver",
+    "Omar",
+    "Oscar",
+    "Paul",
+    "Rafael",
+    "Samir",
+    "Sebastian",
+    "Simon",
+    "Thomas",
+    "Victor",
+    "William",
+    "Yusuf",
+    "Youssef",
+    "Zayn",
+];
+exports.firstNameFemale = [
+    "Aisha",
+    "Ayesha",
+    "Alice",
+    "Amelia",
+    "Ana",
+    "Anna",
+    "Aya",
+    "Bea",
+    "Carla",
+    "Clara",
+    "Diana",
+    "Elena",
+    "Ella",
+    "Emma",
+    "Eva",
+    "Fatima",
+    "Hana",
+    "Hanna",
+    "Isabella",
+    "Jade",
+    "Julia",
+    "Khadija",
+    "Lara",
+    "Leila",
+    "Layla",
+    "Lina",
+    "Lucia",
+    "Maria",
+    "Maya",
+    "Mina",
+    "Nadia",
+    "Naomi",
+    "Nina",
+    "Olivia",
+    "Rania",
+    "Rosa",
+    "Sara",
+    "Sarah",
+    "Sofia",
+    "Sophia",
+    "Tara",
+    "Yara",
+    "Zara",
+];
+exports.lastname = [
+    "Ali",
+    "Ahmed",
+    "Anderson",
+    "Brown",
+    "Chen",
+    "Garcia",
+    "Hassan",
+    "Ivanov",
+    "Khan",
+    "Kim",
+    "Lee",
+    "Li",
+    "Lopez",
+    "Martin",
+    "Mohamed",
+    "Nguyen",
+    "Patel",
+    "Rodriguez",
+    "Singh",
+    "Smith",
+    "Wang",
+    "Zhang",
+    "Andersson",
+    "Anderson",
+    "Baker",
+    "Bianchi",
+    "Black",
+    "Blanco",
+    "Clark",
+    "Costa",
+    "Dubois",
+    "Evans",
+    "Fischer",
+    "Fisher",
+    "Fontana",
+    "Gonzalez",
+    "Hansen",
+    "Johansson",
+    "Jones",
+    "Kowalski",
+    "Larsen",
+    "Müller",
+    "Muller",
+    "Novak",
+    "Petrov",
+    "Rossi",
+    "Schmidt",
+    "Schmidt",
+    "Silva",
+    "Taylor",
+    "Walker",
+    "White",
+];

package/lib/constants/random.constant.d.ts

@@ -1,13 +1,20 @@
+import { HttpCodes } from "../types/random.type";
 export declare const casing: {
     readonly LOWER: "lower";
     readonly UPPER: "upper";
 };
 export declare const booleanString: {
-    readonly TRUE_LOWERCASE: "true";
-    readonly FALSE_LOWERCASE: "false";
-    readonly TRUE_UPPERCASE: "TRUE";
-    readonly FALSE_UPPERCASE: "FALSE";
+    readonly TRUE: "true";
+    readonly FALSE: "false";
 };
 export declare const falsyValues: readonly [null, undefined, false, number, 0, 0, 0n, ""];
 export declare const truthyValues: readonly [true, {}, readonly [], 42, "0", "false", Date, -42, 12n, 3.14, -3.14, number, number];
+/**
+ * Based of https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+ */
+export declare const httpCodes: readonly [100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308, 400, 401, 402, 403, 404, 405, 406, 407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 421, 422, 423, 424, 425, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507, 508, 510, 511];
+/**
+ * Based of https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+ */
+export declare const httpCodesDictionary: Record<HttpCodes, string>;
 //# sourceMappingURL=random.constant.d.ts.map

package/lib/constants/random.constant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"random.constant.d.ts","sourceRoot":"","sources":["../../src/constants/random.constant.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;CAGT,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX,eAAO,MAAM,WAAW,yDAUd,CAAC;AAEX,eAAO,MAAM,YAAY,iGAef,CAAC"}
+{"version":3,"file":"random.constant.d.ts","sourceRoot":"","sources":["../../src/constants/random.constant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,eAAO,MAAM,MAAM;;;CAGT,CAAC;AAEX,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AAEX,eAAO,MAAM,WAAW,yDAUd,CAAC;AAEX,eAAO,MAAM,YAAY,iGAef,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,SAAS,sUAMZ,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAgEhD,CAAC"}

package/lib/constants/random.constant.js

@@ -1,15 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.truthyValues = exports.falsyValues = exports.booleanString = exports.casing = void 0;
+exports.httpCodesDictionary = exports.httpCodes = exports.truthyValues = exports.falsyValues = exports.booleanString = exports.casing = void 0;
 exports.casing = {
     LOWER: "lower",
     UPPER: "upper",
 };
 exports.booleanString = {
-    TRUE_LOWERCASE: "true",
-    FALSE_LOWERCASE: "false",
-    TRUE_UPPERCASE: "TRUE",
-    FALSE_UPPERCASE: "FALSE",
+    TRUE: "true",
+    FALSE: "false",
 };
 exports.falsyValues = [
     // Based on https://developer.mozilla.org/en-US/docs/Glossary/Falsy
@@ -38,3 +36,81 @@ exports.truthyValues = [
     Infinity,
     -Infinity,
 ];
+/**
+ * Based of https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+ */
+exports.httpCodes = [
+    100, 101, 102, 103, 200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300,
+    301, 302, 303, 304, 305, 306, 307, 308, 400, 401, 402, 403, 404, 405, 406,
+    407, 408, 409, 410, 411, 412, 413, 414, 415, 416, 417, 418, 421, 422, 423,
+    424, 425, 426, 428, 429, 431, 451, 500, 501, 502, 503, 504, 505, 506, 507,
+    508, 510, 511,
+];
+/**
+ * Based of https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status
+ */
+exports.httpCodesDictionary = {
+    100: "Continue",
+    101: "Switching Protocols",
+    102: "Processing Deprecated",
+    103: "Early Hints",
+    200: "OK",
+    201: "Created",
+    202: "Accepted",
+    203: "Non-Authoritative Information",
+    204: "No Content",
+    205: "Reset Content",
+    206: "Partial Content",
+    207: "Multi-Status",
+    208: "Already Reported",
+    226: "IM Used",
+    300: "Multiple Choices",
+    301: "Moved Permanently",
+    302: "Found",
+    303: "See Other",
+    304: "Not Modified",
+    305: "Use Proxy",
+    306: "unused",
+    307: "Temporary Redirect",
+    308: "Permanent Redirect",
+    400: "Bad Request",
+    401: "Unauthorized",
+    402: "Payment Required",
+    403: "Forbidden",
+    404: "Not Found",
+    405: "Method Not Allowed",
+    406: "Not Acceptable",
+    407: "Proxy Authentication Required",
+    408: "Request Timeout",
+    409: "Conflict",
+    410: "Gone",
+    411: "Length Required",
+    412: "Precondition Failed",
+    413: "Content Too Large",
+    414: "URI Too Long",
+    415: "Unsupported Media Type",
+    416: "Range Not Satisfiable",
+    417: "Expectation Failed",
+    418: "I'm a teapot",
+    421: "Misdirected Request",
+    422: "Unprocessable Content",
+    423: "Locked",
+    424: "Failed Dependency",
+    425: "Too Early Experimental",
+    426: "Upgrade Required",
+    428: "Precondition Required",
+    429: "Too Many Requests",
+    431: "Request Header Fields Too Large",
+    451: "Unavailable For Legal Reasons",
+    500: "Internal Server Error",
+    501: "Not Implemented",
+    502: "Bad Gateway",
+    503: "Service Unavailable",
+    504: "Gateway Timeout",
+    505: "HTTP Version Not Supported",
+    506: "Variant Also Negotiates",
+    507: "Insufficient Storage",
+    508: "Loop Detected",
+    510: "Not Extended",
+    511: "Network Authentication Required",
+};

package/lib/constants/time.constant.d.ts

@@ -0,0 +1,8 @@
+export declare const millis: {
+    readonly MILLI: 1;
+    readonly SECOND: 1000;
+    readonly MINUTE: number;
+    readonly HOUR: number;
+    readonly DAY: number;
+};
+//# sourceMappingURL=time.constant.d.ts.map

package/lib/constants/time.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.constant.d.ts","sourceRoot":"","sources":["../../src/constants/time.constant.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;CAMT,CAAC"}

package/lib/constants/time.constant.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.millis = void 0;
+exports.millis = {
+    MILLI: 1,
+    SECOND: 1000,
+    MINUTE: 1000 * 60,
+    HOUR: 1000 * 60 * 60,
+    DAY: 1000 * 60 * 60 * 24,
+};

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 import { Casing } from "./types/random.type";
 import { ObjectValues } from "./types/utils.type";
+import { Gender } from "./types/name.type";
 export declare class Random {
     static intBetween(min: number, max: number): number;
     static boolean(): boolean;
@@ -47,5 +48,60 @@ export declare class Random {
      * @returns
      */
     static uuid(): `${string}-${string}-${string}-${string}-${string}`;
+    /**
+     * Has a n% chance of throwing a error
+     * @param probabilityOfError - The probability of a error beeing thrown - i.e 0.2 = 20% chance
+     * @param errorMessage - The errormessage to be used instead of the default one
+     * @param callback - The callback that should be run if there's no error
+     * @returns
+     */
+    static throwError(probabilityOfError: number, errorMessage?: string, callback?: Function): void;
+    /**
+     *
+     * @param minMs - Minimum milliseconds to delay
+     * @param maxMs - Maximum milliseconds to delay
+     * @param value - Optional return value
+     * @returns
+     */
+    static delay<T>(minMs: number, maxMs: number, value?: T): Promise<T | undefined>;
+    /**
+     * Returns a name
+     * @param nameGender - Only male, female or unisex. If omitted, the name could be either one
+     * @returns
+     */
+    static firstName(nameGender?: Gender): string;
+    /**
+     * Gives a surname/last name
+     * @returns
+     */
+    static lastName(): "Lee" | "Taylor" | "Ahmed" | "Hassan" | "Martin" | "Ali" | "Anderson" | "Brown" | "Chen" | "Garcia" | "Ivanov" | "Khan" | "Kim" | "Li" | "Lopez" | "Mohamed" | "Nguyen" | "Patel" | "Rodriguez" | "Singh" | "Smith" | "Wang" | "Zhang" | "Andersson" | "Baker" | "Bianchi" | "Black" | "Blanco" | "Clark" | "Costa" | "Dubois" | "Evans" | "Fischer" | "Fisher" | "Fontana" | "Gonzalez" | "Hansen" | "Johansson" | "Jones" | "Kowalski" | "Larsen" | "Müller" | "Muller" | "Novak" | "Petrov" | "Rossi" | "Schmidt" | "Silva" | "Walker" | "White";
+    /**
+     * Gives a full name - first and last name
+     * @param nameGender
+     * @returns
+     */
+    static fullName(nameGender?: Gender): string;
+    /**
+     * Get a http code i.e 200, 400
+     * @returns
+     */
+    static httpStatusCode(): 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+    /**
+     * Get a http status i.e Created, Accepted
+     * @returns
+     */
+    static httpStatus(): string;
+    /**
+     * Returns a specific time as a localeTimeString
+     * @returns
+     */
+    static time(): string;
+    /**
+     * Returns a date (and time) within the given range
+     * @param min - first date in range
+     * @param max - last date in range
+     * @returns
+     */
+    static date(min: Date, max: Date): Date;
 }
 //# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAiB,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AAErE,qBAAa,MAAM;IACjB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAY1C,MAAM,CAAC,OAAO;IAId;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM;IAQ3C;;;OAGG;IACH,MAAM,CAAC,UAAU;IAIjB;;;OAGG;IACH,MAAM,CAAC,KAAK;IAIZ;;;OAGG;IACH,MAAM,CAAC,MAAM;IAIb;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC;IAMnC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAK/D;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM;IAYnC;;;OAGG;IACH,MAAM,CAAC,IAAI;CAGZ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAiB,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAqB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,qBAAa,MAAM;IACjB,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAY1C,MAAM,CAAC,OAAO;IAId;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM;IAM3C;;;OAGG;IACH,MAAM,CAAC,UAAU;IAIjB;;;OAGG;IACH,MAAM,CAAC,KAAK;IAIZ;;;OAGG;IACH,MAAM,CAAC,MAAM;IAIb;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC;IAMnC;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IAK/D;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM;IAYnC;;;OAGG;IACH,MAAM,CAAC,IAAI;IAIX;;;;;;OAMG;IACH,MAAM,CAAC,UAAU,CACf,kBAAkB,EAAE,MAAM,EAC1B,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,QAAQ,GAClB,IAAI;IAkBP;;;;;;OAMG;WACU,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;IAS7D;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM;IAepC;;;OAGG;IACH,MAAM,CAAC,QAAQ;IAIf;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM;IAInC;;;OAGG;IACH,MAAM,CAAC,cAAc;IAIrB;;;OAGG;IACH,MAAM,CAAC,UAAU;IAKjB;;;OAGG;IACH,MAAM,CAAC,IAAI;IAKX;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI;CAUjC"}

package/lib/index.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Random = void 0;
 const chars_constant_1 = require("./constants/chars.constant");
 const random_constant_1 = require("./constants/random.constant");
+const name_constant_1 = require("./constants/name.constant");
+const time_constant_1 = require("./constants/time.constant");
 class Random {
     static intBetween(min, max) {
         // From https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/random
@@ -26,9 +28,7 @@ class Random {
     static booleanString(booleanCasing) {
         if (!booleanCasing)
             booleanCasing = random_constant_1.casing.LOWER;
-        const result = Random.boolean()
-            ? random_constant_1.booleanString.TRUE_LOWERCASE
-            : random_constant_1.booleanString.FALSE_UPPERCASE;
+        const result = Random.boolean() ? random_constant_1.booleanString.TRUE : random_constant_1.booleanString.FALSE;
         return booleanCasing === random_constant_1.casing.LOWER ? result : result.toUpperCase();
     }
     /**
@@ -93,5 +93,113 @@ class Random {
     static uuid() {
         return crypto.randomUUID();
     }
+    /**
+     * Has a n% chance of throwing a error
+     * @param probabilityOfError - The probability of a error beeing thrown - i.e 0.2 = 20% chance
+     * @param errorMessage - The errormessage to be used instead of the default one
+     * @param callback - The callback that should be run if there's no error
+     * @returns
+     */
+    static throwError(probabilityOfError, errorMessage, callback) {
+        if (probabilityOfError < 0 || probabilityOfError > 1) {
+            // Trying a warning instead of throwing a error since it would probably
+            // be masked by the actual intent - throwing a error sometimes
+            console.warn("The probability needs to be between 0 and 1");
+            return;
+        }
+        if (Math.random() < probabilityOfError) {
+            errorMessage ??= "This is a randomly triggered error";
+            throw new Error(errorMessage);
+        }
+        if (callback) {
+            callback();
+        }
+    }
+    /**
+     *
+     * @param minMs - Minimum milliseconds to delay
+     * @param maxMs - Maximum milliseconds to delay
+     * @param value - Optional return value
+     * @returns
+     */
+    static async delay(minMs, maxMs, value) {
+        return new Promise((resolve, reject) => {
+            const delayInMs = Random.intBetween(minMs, maxMs);
+            setTimeout(() => {
+                resolve(value);
+            }, delayInMs);
+        });
+    }
+    /**
+     * Returns a name
+     * @param nameGender - Only male, female or unisex. If omitted, the name could be either one
+     * @returns
+     */
+    static firstName(nameGender) {
+        const namePool = [];
+        if (!nameGender || nameGender === name_constant_1.gender.UNISEX) {
+            namePool.push(...name_constant_1.firstNameNeutral);
+        }
+        if (!nameGender || nameGender === name_constant_1.gender.MALE) {
+            namePool.push(...name_constant_1.firstNameMale);
+        }
+        if (!nameGender || nameGender === name_constant_1.gender.FEMALE) {
+            namePool.push(...name_constant_1.firstNameFemale);
+        }
+        return Random.fromArray(namePool);
+    }
+    /**
+     * Gives a surname/last name
+     * @returns
+     */
+    static lastName() {
+        return Random.fromArray([...name_constant_1.lastname]);
+    }
+    /**
+     * Gives a full name - first and last name
+     * @param nameGender
+     * @returns
+     */
+    static fullName(nameGender) {
+        return `${Random.firstName(nameGender)} ${Random.lastName()}`;
+    }
+    /**
+     * Get a http code i.e 200, 400
+     * @returns
+     */
+    static httpStatusCode() {
+        return Random.fromArray([...random_constant_1.httpCodes]);
+    }
+    /**
+     * Get a http status i.e Created, Accepted
+     * @returns
+     */
+    static httpStatus() {
+        const randomStatusCode = Random.httpStatusCode();
+        return random_constant_1.httpCodesDictionary[randomStatusCode];
+    }
+    /**
+     * Returns a specific time as a localeTimeString
+     * @returns
+     */
+    static time() {
+        const randomMillis = Random.intBetween(0, time_constant_1.millis.DAY);
+        return new Date(randomMillis).toLocaleTimeString();
+    }
+    /**
+     * Returns a date (and time) within the given range
+     * @param min - first date in range
+     * @param max - last date in range
+     * @returns
+     */
+    static date(min, max) {
+        if (max.getTime() < min.getTime()) {
+            const oldMin = min;
+            min = max;
+            max = oldMin;
+        }
+        const randomDate = Random.intBetween(min.getTime(), max.getTime());
+        return new Date(randomDate);
+    }
 }
 exports.Random = Random;

package/lib/types/name.type.d.ts

@@ -0,0 +1,3 @@
+import { gender } from "../constants/name.constant";
+export type Gender = (typeof gender)[keyof typeof gender];
+//# sourceMappingURL=name.type.d.ts.map

package/lib/types/name.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.type.d.ts","sourceRoot":"","sources":["../../src/types/name.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEpD,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}

package/lib/types/name.type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/random.type.d.ts

@@ -1,4 +1,5 @@
-import { booleanString, casing } from "../constants/random.constant";
+import { booleanString, casing, httpCodes } from "../constants/random.constant";
 export type Casing = (typeof casing)[keyof typeof casing];
 export type BooleanString = (typeof booleanString)[keyof typeof booleanString];
+export type HttpCodes = (typeof httpCodes)[number];
 //# sourceMappingURL=random.type.d.ts.map

package/lib/types/random.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"random.type.d.ts","sourceRoot":"","sources":["../../src/types/random.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC"}
+{"version":3,"file":"random.type.d.ts","sourceRoot":"","sources":["../../src/types/random.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEhF,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC;AAE1D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kottetall/random",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -22,11 +22,14 @@
     "helpers",
     "javascript",
     "node",
-    "array",
-    "object",
     "picker",
     "random-picker",
-    "random-value"
+    "random-value",
+    "test data",
+    "mock data",
+    "mock",
+    "random data generation",
+    "random name"
   ],
   "author": "",
   "license": "ISC",

package/readme.md

@@ -6,8 +6,8 @@ This package was originally created for personal use in my own projects, but it
 
 ## Features
 
-- Get a random value from an array
-- Get a random value from an object
+- Get a random value from an array / object
+- Get a random name - first, last, full
 - Get a random letter
 - Get a random truthy/falsy value
 - And more...
@@ -23,6 +23,17 @@ npm install @kottetall/random
 
 ## Usage
 
+### Random names
+
+```js
+import { Random } from "@kottetall/random";
+
+console.log(Random.firstName()); // Jack
+console.log(Random.firstName("female")); // Sofia
+console.log(Random.lastName()); // White
+console.log(Random.fullName()); // Jack Hassan
+```
+
 ### Random value from an array
 
 ```js