@grey-ts/types 1.5.0 → 2.0.1

package/dist/index.d.ts

@@ -187,7 +187,7 @@ declare namespace GreyHack {
     interface BaseComputer<FileType extends GreyHack.File | GreyHack.FtpFile> {
         classID: "ftpComputer" | "computer";
         /** Returns the hostname of the machine. */
-        getName: () => string;
+        getName(): string;
         /**
          * Creates a folder at the path provided in the arguments.
          *
@@ -197,7 +197,7 @@ declare namespace GreyHack {
          *
          * Using this method in an SSH encryption process will cause an error to be thrown, aborting further script execution.
          */
-        createFolder: (path: string, folderName?: string) => string | true;
+        createFolder(path: string, folderName?: string): string | true;
         /**
          * Returns a file located at the path provided in the argument.
          *
@@ -213,7 +213,7 @@ declare namespace GreyHack {
          * 	print(`Content of passwd file\n${passwd.getContent()}`)
          * }
          */
-        file: (path: string) => FileType | null;
+        file(path: string): FileType | null;
     }
     interface FtpComputer extends BaseComputer<FtpFile> {
         classID: "ftpComputer";
@@ -225,7 +225,7 @@ declare namespace GreyHack {
         /** The public IP address of the computer */
         publicIp: string;
         /** Returns `WIFI` or `ETHERNET` depending on the connection type the computer is currently using */
-        activeNetCard: () => "WIFI" | "ETHERNET";
+        activeNetCard(): "WIFI" | "ETHERNET";
         /**
          * Changes the password of an existing user on the computer.
          *
@@ -233,13 +233,13 @@ declare namespace GreyHack {
          *
          * If the provided username is empty, an error will be thrown, preventing any further script execution.
          */
-        changePassword: (username: string, password: string) => boolean | string;
+        changePassword(username: string, password: string): boolean | string;
         /**
          * Closes a program associated with the provided PID.
          *
          * You can see the list of active programs by either using {@link showProcs} or typing ps into your terminal. To close a program, you need to either be the owner of the running process or root. If closing the program fails, this method will return a string containing details. On success, it will return true. If there is no process with the provided PID, this method will return false.
          */
-        closeProgram: (pid: number) => boolean | string;
+        closeProgram(pid: number): boolean | string;
         /**
          * Sets up a new IP address on the computer through the Ethernet connection.
          *
@@ -247,7 +247,7 @@ declare namespace GreyHack {
          *
          * If the computer is not connected to the internet, an error will be thrown, preventing any further script execution.
          */
-        connectEthernet: (netDevice: netDevice, address: string, gateway: string) => string | null;
+        connectEthernet(netDevice: netDevice, address: string, gateway: string): string | null;
         /**
          * Connects to the indicated Wi-Fi network.
          *
@@ -255,25 +255,25 @@ declare namespace GreyHack {
          *
          * Wi-Fi networks can be found via {@link wifiNetworks} or by typing iwlist as a command in the terminal.
          */
-        connectWifi: (netDevice: netDevice, bssid: string, essid: string, password: string) => true | string;
+        connectWifi(netDevice: netDevice, bssid: string, essid: string, password: string): true | string;
         /**
          * Creates a new group associated with an existing user on the computer.
          *
          * Root access is necessary to successfully create a group. There are limitations when creating a group, such as a character limit of 15 and that the group name may only contain alphanumeric characters. If the group creation fails, this method will return a string containing the cause of failure. On success, it will return true. If the provided arguments are empty or the username exceeds 15 characters, an error will be thrown, interrupting further script execution.
          */
-        createGroup: (username: string, group: string) => true | string;
+        createGroup(username: string, group: string): true | string;
         /**
          * Creates a user on the computer with the specified name and password.
          *
          * Root access is necessary to successfully create a user. Both the username and password cannot exceed more than 15 characters and must be alphanumeric. There cannot be more than 15 users created on the same computer. If the creation fails, this method will return a string containing the reason for the failure. On success, it will return true. If the provided username is empty or either of the values exceeds 15 characters, an error will be thrown, interrupting further script execution.
          */
-        createUser: (username: string, password: string) => true | string;
+        createUser(username: string, password: string): true | string;
         /**
          * Deletes an existing group associated with an existing user on the computer.
          *
          * Root access is necessary to successfully delete a group. If the group deletion fails, this method will return a string containing the cause of failure. On success, it will return true. If either of the provided values is empty, an error will be thrown, preventing further script execution.
          */
-        deleteGroup: (username: string, group: string) => true | string;
+        deleteGroup(username: string, group: string): true | string;
         /**
          * Deletes the indicated user from the computer.
          *
@@ -284,25 +284,25 @@ declare namespace GreyHack {
          * @param username the user to remove
          * @param removeHome remove the user's home folder as well
          */
-        deleteUser: (username: string, removeHome?: boolean) => true | string;
+        deleteUser(username: string, removeHome?: boolean): true | string;
         /** Returns an array of ports on the computer that are active. */
-        getPorts: () => Port[];
+        getPorts(): Port[];
         /**
          * Returns a string containing groups associated with an existing user on the computer.
          *
          * If the user does not exist, a string with an error message will be returned. If the provided username is empty, an error will be thrown, preventing further script execution.
          */
-        groups: (username: string) => string;
+        groups(username: string): string;
         /** Returns a boolean indicating if the computer has internet access */
-        isNetworkActive: () => boolean;
+        isNetworkActive(): boolean;
         /**
          * Returns a string containing information about all network devices available on the computer.
          *
          * Each item includes details about the interface name, chipset, and whether monitoring support is enabled.
          */
-        networkDevices: () => string;
+        networkDevices(): string;
         /** Returns a string with the gateway IP address configured on the computer. */
-        networkGateway: () => string;
+        networkGateway(): string;
         /**
          * Reboots the computer. By default, it reboots in standard mode.
          *
@@ -312,13 +312,13 @@ declare namespace GreyHack {
          *
          * @param safeMode reboot the system in safe mode instead
          */
-        reboot: (safeMode?: boolean) => true | string;
+        reboot(safeMode?: boolean): true | string;
         /**
          * Returns a string with an overview of all active processes on the computer, including information about the user, PID, CPU, memory, and command.
          *
          * Using this method in an SSH encryption process will cause an error to be thrown, preventing any further script execution.
          */
-        showProcs: () => string;
+        showProcs(): string;
         /**
          * Creates an empty text file at the provided path.
          *
@@ -326,7 +326,7 @@ declare namespace GreyHack {
          *
          * Using this method in an SSH encryption process will cause an error to be thrown, preventing any further script execution.
          */
-        touch: (destFolder: string, fileName: string) => true | string;
+        touch(destFolder: string, fileName: string): true | string;
         /**
          * Returns an array of the Wi-Fi networks that are available for the provided interface.
          *
@@ -336,7 +336,7 @@ declare namespace GreyHack {
          *
          * @returns null if no matching netDevice can be found, otherwise the available networks
          */
-        wifiNetworks: (netDevice: netDevice) => string[] | null;
+        wifiNetworks(netDevice: netDevice): string[] | null;
     }
 }
 declare namespace GreyHack {
@@ -349,13 +349,13 @@ declare namespace GreyHack {
          *
          * In case the current entity is a file instead of a folder this method will return null, so it is advisable to first use the isFolder function before calling this method. In case the current folder gets deleted this method will return null as well.
          */
-        getFiles: () => FtpFile[] | null;
+        getFiles(): FtpFile[] | null;
         /**
          * Returns an array of folders inside this folder.
          *
          * In case the current entity is a file instead of a folder this method will return null, so it is advisable to first use the isFolder function before calling this method. In case the current folder gets deleted this method will return null as well.
          */
-        getFolders: () => FtpFile[] | null;
+        getFolders(): FtpFile[] | null;
     }
     interface File extends BaseFile {
         classID: "file";
@@ -368,13 +368,13 @@ declare namespace GreyHack {
          *
          * In case the current entity is a file instead of a folder this method will return null, so it is advisable to first use the isFolder function before calling this method. In case the current folder gets deleted this method will return null as well.
          */
-        getFiles: () => File[] | null;
+        getFiles(): File[] | null;
         /**
          * Returns an array of folders inside this folder.
          *
          * In case the current entity is a file instead of a folder this method will return null, so it is advisable to first use the isFolder function before calling this method. In case the current folder gets deleted this method will return null as well.
          */
-        getFolders: () => File[] | null;
+        getFolders(): File[] | null;
         /**
          * Modifies the file permissions.
          *
@@ -384,7 +384,7 @@ declare namespace GreyHack {
          *
          * @param recursive set the permissions recursively to every file inside this folder
          */
-        chmod: (perms: string, recursive?: boolean) => string;
+        chmod(perms: string, recursive?: boolean): string;
         /**
          * Returns a string representing the content of the file. To read a file, the user requires read access or being root.
          *
@@ -392,7 +392,7 @@ declare namespace GreyHack {
          *
          * If this method is used within an SSH encryption process, an error will be thrown, preventing any further script execution.
          */
-        getContent: () => string | null;
+        getContent(): string | null;
         /**
          * Saves text into a file. The content will not get appended to the file; therefore, existing content will be overridden.
          *
@@ -400,7 +400,7 @@ declare namespace GreyHack {
          *
          * If this method is used within an SSH encryption process, an error will be thrown, preventing any further script execution. If the permissions are lacking, this method will return false. In case the file gets deleted this method will return null.
          */
-        setContent: (content: string) => string | boolean | null;
+        setContent(content: string): string | boolean | null;
         /**
          * Change the group related to this file.
          *
@@ -410,7 +410,7 @@ declare namespace GreyHack {
          *
          * @param recursive set the group recursively to every file inside this folder
          */
-        setGroup: (group: string, recursive?: boolean) => string | null;
+        setGroup(group: string, recursive?: boolean): string | null;
         /**
          * Change the owner of this file.
          *
@@ -420,7 +420,7 @@ declare namespace GreyHack {
          *
          * @param recursive set the owner recursively to every file inside this folder
          */
-        setOwner: (owner: string, recursive?: boolean) => string | null;
+        setOwner(owner: string, recursive?: boolean): string | null;
         /**
          * Creates a symlink to the specified path.
          *
@@ -428,7 +428,7 @@ declare namespace GreyHack {
          *
          * If used within an SSH encryption process, if the new name exceeds 128 characters, or if the path is too long, an error will be thrown, interrupting script execution. If the current file is deleted, this method will return null.
          */
-        symlink: (path: string, newName?: string) => true | string | null;
+        symlink(path: string, newName?: string): true | string | null;
     }
     interface BaseFile {
         classID: "ftpFile" | "file";
@@ -457,7 +457,7 @@ declare namespace GreyHack {
          *
          * If this method is used within an SSH encryption process, the new name exceeds 128 characters, or the path is too long, an error will be thrown, causing an interruption of script execution. In case the current file gets deleted, this method will return null.
          */
-        copy: (destFolder?: string, newName?: string) => string | boolean | null;
+        copy(destFolder?: string, newName?: string): string | boolean | null;
         /**
          * Delete the current file.
          *
@@ -465,18 +465,18 @@ declare namespace GreyHack {
          *
          * Note that deleting a file will leave a log entry.
          */
-        delete: () => string;
+        delete(): string;
         /** Returns a boolean indicating if the user who launched the script has the requested permissions.
          *
          * In case the file gets deleted, this method will return null instead.
          */
-        hasPermission: (perms: "r" | "w" | "x") => boolean | null;
+        hasPermission(perms: "r" | "w" | "x"): boolean | null;
         /** Returns a boolean indicating if the file is a binary. Returns null if the file gets deleted */
-        isBinary: () => boolean | null;
+        isBinary(): boolean | null;
         /** Returns a boolean indicating if the file is a folder. Returns null if the file gets deleted */
-        isFolder: () => boolean | null;
+        isFolder(): boolean | null;
         /** Returns a boolean indicating if the file is a symlink. Returns null if the file gets deleted */
-        isSymlink: () => boolean | null;
+        isSymlink(): boolean | null;
         /**
          * Moves the file to the provided path.
          *
@@ -484,12 +484,12 @@ declare namespace GreyHack {
          *
          * If this method is used within an SSH encryption process, the new name exceeds 128 characters, or the path is too long, an error will be thrown, causing an interruption of script execution. In case the current file gets deleted, this method will return null.
          */
-        move: (destFolder: string, newName?: string) => string | boolean | null;
+        move(destFolder: string, newName?: string): string | boolean | null;
         /**
          * Returns a string containing the file path. If the file has been deleted, this method will still return the path it had prior to deletion.
          * @param symLinkOriginalPath return the original path of the linked file instead
          */
-        path: (symLinkOriginalPath?: boolean) => string;
+        path(symLinkOriginalPath?: boolean): string;
         /**
          * Rename the file with the name provided.
          *
@@ -497,7 +497,7 @@ declare namespace GreyHack {
          *
          * If this method is used within an SSH encryption process, an error will be thrown, causing the script execution to be interrupted.
          */
-        rename: (name: string) => string;
+        rename(name: string): string;
     }
 }
 /** Provides access to global variables of this script */
@@ -752,7 +752,7 @@ declare namespace GreyHack {
     /** Waits for the next tick. */
     function yield(): null;
     /** Returns the type of the object */
-    function getType(value: any): keyof GameTypeMap;
+    function getType(value: any): string;
     /** Checks if the given object is of a specific type
      * @example
      * const metax = includeLib("/lib/metaxploit.so");
@@ -776,7 +776,7 @@ declare namespace GreyHack {
      * include("./commands");
      */
     function include(file: string): void;
-    type LibTypes = {
+    interface LibTypes {
         "aptclient.so": GreyHack.AptClient;
         "metaxploit.so": GreyHack.Metaxploit;
         "crypto.so": GreyHack.Crypto;
@@ -786,7 +786,7 @@ declare namespace GreyHack {
         "blockchain.so": GreyHack.BlockChain;
         "libsmartappliance.so": GreyHack.SmartAppliance;
         "libtrafficnet.so": GreyHack.TrafficNet;
-    };
+    }
 }
 declare var activeUser: typeof GreyHack.activeUser;
 declare var bitAnd: typeof GreyHack.bitAnd;
@@ -835,18 +835,18 @@ declare var yield: typeof GreyHack.yield;
 declare const getType: typeof GreyHack.getType;
 declare const isType: typeof GreyHack.isType;
 declare const include: typeof GreyHack.include;
-type OtherTypeMap = {
+interface PrimitiveTypeMap {
     "null": null;
-    "pcomputer": unknown;
-    "pfile": unknown;
-    "prouter": unknown;
     "number": number;
     "list": Array<any>;
     "map": Record<string, any>;
     "function": Function;
     "string": string;
-};
-type ClassIDMap = {
+}
+interface ClassIDMap {
+    "pcomputer": unknown;
+    "pfile": unknown;
+    "prouter": unknown;
     "aptClientLib": GreyHack.AptClient;
     "blockChainLib": GreyHack.BlockChain;
     "ctfEvent": GreyHack.CtfEvent;
@@ -870,8 +870,8 @@ type ClassIDMap = {
     "subwallet": GreyHack.SubWallet;
     "TrafficNet": GreyHack.TrafficNet;
     "wallet": GreyHack.Wallet;
-};
-type GameTypeMap = ClassIDMap & OtherTypeMap;
+}
+type GameTypeMap = ClassIDMap & PrimitiveTypeMap;
 declare namespace GreyHack {
     interface Service {
         classID: "service";
@@ -1234,41 +1234,41 @@ interface Math {
     /** Returns the value of pi to the precision of 6 */
     readonly PI: number;
     /** Returns the absolute value of number. */
-    readonly abs: (value: number) => number;
+    abs(value: number): number;
     /** Returns the inverse cosine (in radians) of a number. */
-    readonly acos: (value: number) => number;
+    acos(value: number): number;
     /** Returns the inverse sine (in radians) of a number. */
-    readonly asin: (value: number) => number;
+    asin(value: number): number;
     /** Returns the inverse tangent (in radians) of a number. */
-    readonly atan: (y: number, x?: number | undefined) => number;
+    atan(y: number, x?: number | undefined): number;
     /** Returns number rounded up to the integer value of the provided number. */
-    readonly ceil: (value: number) => number;
+    ceil(value: number): number;
     /** Returns number rounded down to the integer value of the provided number. */
-    readonly floor: (value: number) => number;
+    floor(value: number): number;
     /** Returns the cosine of a number in radians. */
-    readonly cos: (value: number) => number;
+    cos(value: number): number;
     /** Returns the sine of a number in radians. */
-    readonly sin: (value: number) => number;
+    sin(value: number): number;
     /** Returns the tangent of a number in radians. */
-    readonly tan: (value: number) => number;
+    tan(value: number): number;
     /** Returns the square root of a number. */
-    readonly sqrt: (value: number) => number;
+    sqrt(value: number): number;
     /** Returns 1 or -1 indicating the sign of the value passed or 0 if the value is 0 */
-    readonly sign: (value: number) => -1 | 0 | 1;
+    sign(value: number): -1 | 0 | 1;
     /** Returns number rounded to the integer value of the provided number. */
-    readonly round: (value: number, fixed?: number | undefined) => number;
+    round(value: number, fixed?: number | undefined): number;
     /** Returns a random number between 0 and 1. Optionally a seed number can be provided. */
-    readonly random: (seed?: number | undefined) => number;
+    random(seed?: number | undefined): number;
     /**
      * Returns the natural logarithm of a number.
      *
      * By default, the base is 10. Optionally the base can be changed.
      */
-    readonly log: (value: number, base?: number | undefined) => number;
+    log(value: number, base?: number | undefined): number;
     /** Returns the smallest number of the given values */
-    readonly min: (...values: number[]) => number;
+    min(...values: number[]): number;
     /** Returns the largest number of the given values */
-    readonly max: (...values: number[]) => number;
+    max(...values: number[]): number;
 }
 declare var Math: Math;
 declare namespace GreyHack {
@@ -1346,9 +1346,9 @@ declare namespace GreyHack {
         /** Port number used by this port */
         portNumber: number;
         /** Returns a boolean, where true indicates that the specified port is closed and false indicates that the port is open. */
-        isClosed: () => boolean;
+        isClosed(): boolean;
         /** Returns a string containing the local IP address of the computer to which the port is pointing. */
-        getLanIp: () => string;
+        getLanIp(): string;
     }
     interface Router {
         classID: "router";
@@ -1412,7 +1412,7 @@ declare namespace GreyHack {
          *
          * In case any provided values deviate from the defined signature a runtime exception will be thrown.
          */
-        build: (sourcePath: string, binaryPath: string, allowImport?: boolean) => string;
+        build(sourcePath: string, binaryPath: string, allowImport?: boolean): string;
         /**
          * Returns a shell if the connection attempt to the provided IP was successful.
          *
@@ -1420,7 +1420,7 @@ declare namespace GreyHack {
          *
          * In case of failure, a string is returned containing details. If this method is run in an SSH encryption process, or if the computer is not connected to the internet, a runtime exception will be thrown.
          */
-        connectService: (ip: string, port: number, user: string, password: string, service?: "ssh" | "ftp") => Shell | FtpShell | string | null;
+        connectService(ip: string, port: number, user: string, password: string, service?: "ssh" | "ftp"): Shell | FtpShell | string | null;
         /**
          * Launches the binary located at the provided path.
          *
@@ -1432,13 +1432,13 @@ declare namespace GreyHack {
          *
          * There is a cooldown of 2 seconds between launches to prevent abuse. If you attempt to launch a script during this cooldown period, the method will return false.
          */
-        launch: (program: string, params?: string) => string | boolean;
+        launch(program: string, params?: string): string | boolean;
         /**
          * Pings an IP address.
          *
          * Return a boolean indicating if the remote address could be reached. Firewalls do not block ping requests. Passing an invalid ip will cause the method to return a string with an error message.
          */
-        ping: (ip: string) => string | boolean;
+        ping(ip: string): string | boolean;
         /**
          * Send a file to the computer related to the provided shell.
          *
@@ -1448,7 +1448,7 @@ declare namespace GreyHack {
          *
          * In case of failure, this method will return a string with the cause. Otherwise, true will be returned. In case the string for sourceFile or destinationFolder is empty, an error will be thrown, preventing further script execution. Utilizing this method in an SSH encryption process will trigger an error, halting further script execution.
          */
-        scp: (file: string, folder: string, remoteShell: Shell, isUpload?: boolean) => boolean | string;
+        scp(file: string, folder: string, remoteShell: Shell, isUpload?: boolean): boolean | string;
         /**
          * Launches an active terminal.
          *
@@ -1456,9 +1456,13 @@ declare namespace GreyHack {
          *
          * Using this method within an SSH encryption process will cause an error to be thrown, preventing further script execution.
          */
-        startTerminal: () => never;
+        startTerminal(): never;
     }
 }
+declare const console: {
+    readonly log: typeof GreyHack.print;
+    readonly clear: typeof GreyHack.clearScreen;
+};
 interface RegExp {
 }
 interface CallableFunction {
@@ -1470,6 +1474,7 @@ interface IArguments {
 interface Boolean {
 }
 interface String {
+    /** Returns the length of the string */
     readonly length: number;
     /** Returns the Unicode code of the first character of the string */
     code(): number;
@@ -1567,19 +1572,6 @@ interface Number {
 }
 type PropertyKey = number | string | symbol;
 interface Object {
-    /** Returns the number of items inside the object */
-    readonly size: number;
-    hasIndex(key: PropertyKey): boolean;
-    indexOf(value: any): any;
-    indexes<T extends PropertyKey>(): T[];
-    pop(): any;
-    pull(): any;
-    push(key: PropertyKey): any;
-    remove(key: PropertyKey): boolean;
-    replace(oldValue: any, newValue: any, maxCount?: number): any;
-    shuffle(): null;
-    sum(): number;
-    values(): any[];
     /** Returns a string representation of an object. */
     toString(): string;
 }
@@ -1590,15 +1582,51 @@ interface ObjectConstructor {
     hasOwn<T extends PropertyKey, U = object>(o: U, key: T): o is (T extends keyof U ? U : U & {
         [K in T]: unknown;
     });
+    /**
+     * Returns a key of the object that has a value equal to the given value
+     * @example
+     * const myObject = { test: 123, other: 222 };
+     * const key = Object.indexOf(myObject, 222);
+     * print(key); // Prints "other"
+     */
+    indexOf<T extends Record<any, any>>(o: T, value: T[keyof T]): keyof T | null;
     /** Copy the properties of the source to the target */
     assign<T extends {}, U>(target: T, source: U): T & U;
     assign<T extends {}, U, V>(target: T, source: U, source2: V): T & U & V;
     assign<T extends {}, U, V, W>(target: T, source: U, source2: V, source3: W): T & U & V & W;
     assign(target: object, ...sources: any[]): any;
+    /** Returns the number of items inside the object */
+    size<T extends Record<any, any>>(o: T): number;
     /** Returns an array of keys of the object */
     keys<T extends Record<any, any>>(o: T): (Exclude<keyof T, symbol>)[];
     /** Returns an array of values of the object */
     values<T extends Record<any, any>>(o: T): (T[keyof T])[];
+    /** Returns sum of all values inside the given object. Any non-numeric values will be considered a zero. */
+    sum(o: Record<any, any>): number;
+    /** Shuffles all **values** in the object. This operation will mutate the map. */
+    shuffle(o: Record<any, any>): null;
+    /**
+     * Replaces each value of the object matching `oldValue` with `newValue`.
+     *
+     * This method will mutate the object
+     * @example
+     * const myObject = { status: "online" };
+     * Object.replace(myObject, "online", "offline");
+     * print(myObject); // Prints { "status": "offline" };
+     */
+    replace<T extends Record<any, any>>(o: T, oldValue: T[keyof T], newValue: T[keyof T], maxCount?: number): T;
+    /**
+     * Removes a key-value pair from the object. This method mutates the object.
+     *
+     * @returns a boolean indicating success
+     */
+    remove<T extends Record<any, any>>(o: T, key: keyof T): boolean;
+    /**
+     * Removes the first item of the object and returns it's key
+     *
+     * This method mutates the object.
+     */
+    shift<T extends Record<any, any>>(o: T): keyof T | null;
 }
 interface Array<T> {
     readonly length: number;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@grey-ts/types",
-	"version": "1.5.0",
+	"version": "2.0.1",
 	"description": "TypeScript definitions for GreyHack's functions and objects",
 	"license": "MIT",
 	"types": "dist/index.d.ts",