e621 2.0.1 → 2.1.1

package/.mocharc.json

@@ -0,0 +1,6 @@
+{
+	"bail": true,
+	"require": "ts-node/register",
+	"timeout": 20000,
+	"spec": "test/**/*.ts"
+}

package/.ncurc.json

@@ -0,0 +1,3 @@
+{
+	"upgrade": true
+}

package/Features/Artists.md

@@ -0,0 +1,32 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- **Artists**
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|       Feature      | Implemented |          Method         |
+|:------------------:|:-----------:|:-----------------------:|
+|      Get By ID     |      ✔️      |      `artists.get`      |
+|     Get By Name    |      ✔️      |   `artists.getByName`   |
+|       Search       |      ✔️      |     `artists.search`    |
+|     Create[^1]     |      ✔️      |     `artists.create`    |
+|     Modify[^1]     |      ✔️      |     `artists.modify`    |
+|   Delete[^1][^3]   |      ✔️      |     `artists.delete`    |
+|     Ban[^1][^5]    |      ✖️      |           N/A           |
+|    Unban[^1][^5]   |      ✖️      |           N/A           |
+|     Revert[^1]     |      ✔️      |     `artists.revert`    |
+| Search History[^1] |      ✔️      | `artists.searchHistory` |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/Features/FuturePlans.md

@@ -0,0 +1,21 @@
+## Table Of Contents
+- [Index](README.md)
+- **Future Plans**
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|           Feature          | Planned |
+|:--------------------------:|:-------:|
+|         Post Flags         |    ✔️    |
+| General Moderative Actions |    ✔️    |
+|         Dmails[^1]         |    ✖️    |
+
+[^1]: E621 does not expose a json api for dmails, and I currently do not plan on scraping the html for them, as this will add tremendous bloat to the library.

package/Features/Pools.md

@@ -0,0 +1,32 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- **Pools**
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|       Feature      | Implemented |         Method        |
+|:------------------:|:-----------:|:---------------------:|
+|      Get By ID     |      ✔️      |      `pools.get`      |
+|     Get By Name    |      ✔️      |   `pools.getByName`   |
+|       Search       |      ✔️      |     `pools.search`    |
+|     Create[^1]     |      ✔️      |     `pools.create`    |
+|     Modify[^1]     |      ✔️      |     `pools.modify`    |
+|   Delete[^1][^3]   |      ✔️      |     `pools.delete`    |
+|     Revert[^1]     |      ✔️      |     `pools.revert`    |
+| Search History[^1] |      ✔️      | `pools.searchHistory` |
+|    Add Post[^1]    |      ✔️      |    `pools.addPost`    |
+|   Remove Post[^1]  |      ✔️      |   `pools.removePost`  |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/Features/PostSets.md

@@ -0,0 +1,31 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- **Post Sets**
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|      Feature      | Implemented |           Method          |
+|:-----------------:|:-----------:|:-------------------------:|
+|     Get By ID     |      ✔️      |       `postSets.get`      |
+|    Get By Name    |      ✔️      |    `postSets.getByName`   |
+| Get By Short Name |      ✔️      | `postSets.getByShortName` |
+|       Search      |      ✔️      |     `postSets.search`     |
+|     Create[^1]    |      ✔️      |     `postSets.create`     |
+|     Modify[^1]    |      ✔️      |     `postSets.modify`     |
+|     Delete[^1]    |      ✔️      |     `postSets.delete`     |
+|    Add Post[^1]   |      ✔️      |     `postSets.addPost`    |
+|  Remove Post[^1]  |      ✔️      |   `postSets.removePost`   |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/Features/Posts.md

@@ -0,0 +1,38 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- **Posts**
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|            Feature            | Implemented |         Method         |
+|:-----------------------------:|:-----------:|:----------------------:|
+|           Get By ID           |      ✔️      |       `posts.get`      |
+|          Get By Name          |      ✔️      |    `posts.getByName`   |
+|             Search            |      ✔️      |     `posts.search`     |
+|           Create[^1]          |      ✔️      |     `posts.create`     |
+|           Modify[^1]          |      ✔️      |     `posts.modify`     |
+|         Delete[^1][^3]        |      ✖️      |           N/A          |
+|        Approve[^1][^3]        |      ✖️      |           N/A          |
+|       Unapprove[^1][^3]       |      ✖️      |           N/A          |
+|        Destroy[^1][^5]        |      ✖️      |           N/A          |
+| Regenerate Thumbnails[^1][^3] |      ✖️      |           N/A          |
+|   Regenerate Videos[^1][^3]   |      ✖️      |           N/A          |
+|           Revert[^1]          |      ✔️      |     `posts.revert`     |
+|       Search History[^1]      |      ✔️      |  `posts.searchHistory` |
+|            Vote[^1]           |      ✔️      |      `posts.vote`      |
+|        Add Favorite[^1]       |      ✔️      |   `users.addFavorite`  |
+|      Remove Favorite[^1]      |      ✔️      | `users.removeFavorite` |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/Features/README.md

@@ -0,0 +1,11 @@
+## Table Of Contents
+- **Index**
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)

package/Features/Tags.md

@@ -0,0 +1,27 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- **Tags**
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|     Feature    | Implemented |        Method        |
+|:--------------:|:-----------:|:--------------------:|
+|    Get By ID   |      ✔️      |      `tags.get`      |
+|   Get By Name  |      ✔️      |   `tags.getByName`   |
+|     Search     |      ✔️      |     `tags.search`    |
+|   Modify[^1]   |      ✔️      |     `tags.modify`    |
+| Search History |      ✔️      | `tags.searchHistory` |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/Features/UserFeedback.md

@@ -0,0 +1,27 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- **User Feedback**
+- [Users](Users.md)
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|     Feature    | Implemented |         Method        |
+|:--------------:|:-----------:|:---------------------:|
+|    Get By ID   |      ✔️      |   `userFeedback.get`  |
+|     Search     |      ✔️      | `userFeedback.search` |
+| Create[^1][^4] |      ✔️      | `userFeedback.create` |
+| Modify[^1][^4] |      ✔️      | `userFeedback.modify` |
+| Delete[^1][^4] |      ✔️      | `userFeedback.delete` |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/Features/Users.md

@@ -0,0 +1,31 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- **Users**
+- [Wiki Pages](WikiPages.md)
+
+<hr>
+
+|           Feature           | Implemented |         Method         |
+|:---------------------------:|:-----------:|:----------------------:|
+|          Get By ID          |      ✔️      |       `users.get`      |
+|         Get By Name         |      ✔️      |    `users.getByName`   |
+|            Search           |      ✔️      |     `users.search`     |
+|  Get Authenticated User[^1] |      ✔️      |     `users.getSelf`    |
+| Edit Authenticated User[^1] |      ✔️      |    `users.editSelf`    |
+|     Get Upload Limit[^1]    |      ✔️      | `users.getUploadLimit` |
+|      Get Favorites[^1]      |      ✔️      |  `users.getFavorites`  |
+|       Add Favorite[^1]      |      ✔️      |   `users.addFavorite`  |
+|     Remove Favorite[^1]     |      ✔️      | `users.removeFavorite` |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/Features/WikiPages.md

@@ -0,0 +1,30 @@
+## Table Of Contents
+- [Index](README.md)
+- [Future Plans](FuturePlans.md)
+- [Artists](Artists.md)
+- [Pools](Pools.md)
+- [Posts](Posts.md)
+- [Post Sets](PostSets.md)
+- [Tags](Tags.md)
+- [User Feedback](UserFeedback.md)
+- [Users](Users.md)
+- **Wiki Pages**
+
+<hr>
+
+|     Feature    | Implemented |           Method          |
+|:--------------:|:-----------:|:-------------------------:|
+|    Get By ID   |      ✔️      |      `wikiPages.get`      |
+|  Get By Title  |      ✔️      |   `wikiPages.getByTitle`  |
+|     Search     |      ✔️      |     `wikiPages.search`    |
+|   Create[^1]   |      ✔️      |     `wikiPages.create`    |
+|   Modify[^1]   |      ✔️      |     `wikiPages.modify`    |
+| Delete[^1][^3] |      ✔️      |     `wikiPages.delete`    |
+|   Revert[^1]   |      ✔️      |     `wikiPages.revert`    |
+| Search History |      ✔️      | `wikiPages.searchHistory` |
+
+[^1]: Requires Authentication
+[^2]: Requires Privileged
+[^3]: Requires Janitor
+[^4]: Requires Moderator
+[^5]: Requires Admin

package/README.md

@@ -4,25 +4,7 @@ The most comprehensive wrapper for e621 you'll ever find.
 
 We support almost anything normal users can do, with plans to bring everything else in, and more later in development.
 
-### Features:
-- [x] Creating Posts (Buffer & URL)
-- [x] Listing/Creating/Editing/Voting On/Favoriting Posts
-- [x] Listing/Creating/Editing/Deleting/Modifying/Adding To/Removing From Post Sets
-- [x] Listing/Creating/Editing/Deleting/Modifying/Adding To/Removing From Pools
-- [x] Listing/Creating/Deleting/Editing User Feedback
-- [x] Reverting Pool Changes
-- [x] Listing Post History
-- [x] Editing The Authenticated User (all properties minus password and email)
-- [ ] Deleting/Approving/Unapproving/Destroying Posts
-- [ ] Creating/Solving/Deleting Post Flags
-- [ ] Listing/Creating/Editing/Deleting/Modifying Wiki Pages
-- [ ] Listing/Creating/Editing/Deleting/Modifying Artists
-- [ ] Listing/Editing/Deleting/Modifying Tags
-- [ ] General Janitorial/Moderative/Admninistrative Actions
-- [ ] More Planned!
-
-### Not Planned:
-- Dmails (routes do not support json, and I'm not scraping html)
+See the [Features List](Features/README.md) for all of the things this module supports, and what is planned.
 
 <hr>
 
@@ -55,70 +37,3 @@ Most of these options shouldn't be used unless you know what you're doing (you p
 | `instanceSSL` | Boolean | true | [See Code](https://github.com/DonovanDMC/E621/blob/89d662f19dc76c77e28f40b18a96f9043c4e2a3a/src/types/index.d.ts#L03) |
 | `instancePort` | Number | 443 | [See Code](https://github.com/DonovanDMC/E621/blob/89d662f19dc76c77e28f40b18a96f9043c4e2a3a/src/types/index.d.ts#L9) |
 | `instanceHost` | String | e621.net | [See Code](https://github.com/DonovanDMC/E621/blob/89d662f19dc76c77e28f40b18a96f9043c4e2a3a/src/types/index.d.ts#L15) |
-
-A map of features we support to their methods is listed below.
-
-## Methods
-The legend for the symbols can be found after the table.
-| Section | Description | Location |
-|:---:|:---:|:---:|
-| Pools | Get Pool | `pools.get` |
-| Pools | Get Pool By Name | `pools.getByName` |
-| Pools | Search Pools | `pools.search` |
-| Pools | Create Pool* | `pools.create` |
-| Pools | Modify Pool* | `pools.modify` |
-| Pools | Delete Pool^ | `pools.delete` |
-| Pools | Revert Pool* | `pools.revert` |
-| Pools | Search Pool History | `pools.searchHistory` |
-| Pools | Add Post To Pool | `pools.addPost` |
-| Pools | Remove Post From Pool | `pools.removePost` |
-| Type | Description | Location |
-| Posts | Get Post By ID | `posts.get` |
-| Posts | Get Post By MD5 | `posts.getByMD5` |
-| Posts | Search Posts | `posts.search` |
-| Posts | Create Post* | `posts.create` |
-| Posts | Modify Post* | `posts.modify` |
-| Posts | Vote On Post* | `posts.vote` |
-| Posts | Revert Post* | `posts.revert` |
-| Posts | Search Post History | `posts.searchHistory` |
-| Type | Description | Location |
-| Post Sets | Get Post Set | `postSets.get` |
-| Post Sets | Search Sets | `postSets.search` |
-| Post Sets | Create Post Set* | `postSets.create` |
-| Post Sets | Modify Post Set* | `postSets.modify` |
-| Post Sets | Delete Post Set* | `postSets.delete` |
-| Post Sets | Add Post To Set* | `postSets.addPost` |
-| Post Sets | Remove Post From Set* | `postSets.removePost` |
-| Type | Description | Location |
-| User Feedback | Get Feedback | `userFeedback.get` |
-| User Feedback | Search Feedback | `userFeedback.search` |
-| User Feedback | Create Feedback# | `userFeedback.create` |
-| User Feedback | Modify Feedback# | `userFeedback.modify` |
-| User Feedback | Delete Feedback# | `userFeedback.delete` |
-| Type | Description | Location |
-| Users | Get User (ID/Name) | `users.get` |
-| Users | Search Users | `users.search` |
-| Users | Get Authenticated User* | `users.getSelf` |
-| Users | Edit Authenticated User* | `users.editSelf` |
-| Users | Get Upload Limit* | `users.getUploadLimit` |
-| Users | Get Favorites | `users.getFavorites` |
-| Users | Add Favorite* | `users.addFavorite` |
-| Users | Remove Favorite* | `users.removeFavorite` |
-| Type | Description | Location |
-| Wiki Page | Get Wiki Page | `wikiPages.get` |
-| Wiki Page | Get Wiki Page (By Name) | `wikiPages.getByName` |
-| Wiki Page | Search Wiki Pages | `wikiPages.search` |
-| Wiki Page | Create Wiki Page* | `wikiPages.create` |
-| Wiki Page | Modify Wiki Page* | `wikiPages.modify` |
-| Wiki Page | Delete Wiki Page^ | `wikiPages.delete` |
-| Wiki Page | Revert Wiki Page* | `wikiPages.revert` |
-| Wiki Page | Search Wiki Page History | `wikiPages.searchHistory` |
-
-#### Method Symbol Legend
-| Symbol | Meaning                 |
-|:------:|:-----------------------:|
-| *      | Requires Authentication |
-| $      | Requires Privileged     |
-| ^      | Requires Janitor        |
-| #      | Requires Moderator      |
-| &      | Requires Admin          |

package/build/package.json

@@ -1,6 +1,6 @@
 {
     "name": "e621",
-    "version": "2.0.1",
+    "version": "2.1.1",
     "description": "A module for interfacing with e621.",
     "main": "build/src/index.js",
     "scripts": {
@@ -28,9 +28,13 @@
     },
     "homepage": "https://github.com/DonovanDMC/E621#readme",
     "devDependencies": {
-        "@uwu-codes/eslint-config": "^1.0.25",
+        "@types/chai": "^4.3.0",
+        "@types/mocha": "^9.0.0",
+        "@uwu-codes/eslint-config": "^1.0.31",
         "@uwu-codes/tsconfig": "^1.0.1",
-        "ts-node": "^10.3.0",
-        "typescript": "^4.4.4"
+        "chai": "^4.3.4",
+        "mocha": "^9.1.3",
+        "ts-node": "^10.4.0",
+        "typescript": "^4.5.4"
     }
 }

package/build/src/index.d.ts

@@ -1,25 +1,34 @@
 import type { Options, InstanceOptions } from "./types";
 import RequestHandler from "./util/RequestHandler";
+import Artists from "./modules/Artists";
+import Pools from "./modules/Pools";
 import Posts from "./modules/Posts";
+import PostSets from "./modules/PostSets";
+import Tags from "./modules/Tags";
 import UserFeedback from "./modules/UserFeedback";
 import Users from "./modules/Users";
-import PostSets from "./modules/PostSets";
-import Pools from "./modules/Pools";
 import WikiPages from "./modules/WikiPages";
+import Artist from "./structures/Artist";
+import ArtistHistory from "./structures/ArtistHistory";
 import AuthenticatedUser from "./structures/AuthenticatedUser";
 import Pool from "./structures/Pool";
 import PoolHistory from "./structures/PoolHistory";
 import Post from "./structures/Post";
 import PostHistory from "./structures/PostHistory";
 import PostSet from "./structures/PostSet";
+import Tag from "./structures/Tag";
+import TagHistory from "./structures/TagHistory";
 import User from "./structures/User";
 import WikiPage from "./structures/WikiPage";
 import WikiPageHistory from "./structures/WikiPageHistory";
 export default class E621 {
+    POST_LIMIT_PER_REQUEST: number;
     request: RequestHandler;
-    postSets: PostSets;
+    artists: Artists;
     pools: Pools;
     posts: Posts;
+    postSets: PostSets;
+    tags: Tags;
     userFeedback: UserFeedback;
     users: Users;
     wikiPages: WikiPages;
@@ -29,4 +38,4 @@ export default class E621 {
 }
 export * from "./types";
 export { APIError } from "./util/RequestHandler";
-export { AuthenticatedUser, Pool, PoolHistory, Post, PostHistory, PostSet, User, WikiPage, WikiPageHistory };
+export { Artist, ArtistHistory, AuthenticatedUser, Pool, PoolHistory, Post, PostHistory, PostSet, Tag, TagHistory, User, WikiPage, WikiPageHistory };

package/build/src/index.js

@@ -13,16 +13,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WikiPageHistory = exports.WikiPage = exports.User = exports.PostSet = exports.PostHistory = exports.Post = exports.PoolHistory = exports.Pool = exports.AuthenticatedUser = exports.APIError = void 0;
+exports.WikiPageHistory = exports.WikiPage = exports.User = exports.TagHistory = exports.Tag = exports.PostSet = exports.PostHistory = exports.Post = exports.PoolHistory = exports.Pool = exports.AuthenticatedUser = exports.ArtistHistory = exports.Artist = exports.APIError = void 0;
 const RequestHandler_1 = __importDefault(require("./util/RequestHandler"));
 // Modules
+const Artists_1 = __importDefault(require("./modules/Artists"));
+const Pools_1 = __importDefault(require("./modules/Pools"));
 const Posts_1 = __importDefault(require("./modules/Posts"));
+const PostSets_1 = __importDefault(require("./modules/PostSets"));
+const Tags_1 = __importDefault(require("./modules/Tags"));
 const UserFeedback_1 = __importDefault(require("./modules/UserFeedback"));
 const Users_1 = __importDefault(require("./modules/Users"));
-const PostSets_1 = __importDefault(require("./modules/PostSets"));
-const Pools_1 = __importDefault(require("./modules/Pools"));
 const WikiPages_1 = __importDefault(require("./modules/WikiPages"));
 // Structures
+const Artist_1 = __importDefault(require("./structures/Artist"));
+exports.Artist = Artist_1.default;
+const ArtistHistory_1 = __importDefault(require("./structures/ArtistHistory"));
+exports.ArtistHistory = ArtistHistory_1.default;
 const AuthenticatedUser_1 = __importDefault(require("./structures/AuthenticatedUser"));
 exports.AuthenticatedUser = AuthenticatedUser_1.default;
 const Pool_1 = __importDefault(require("./structures/Pool"));
@@ -35,6 +41,10 @@ const PostHistory_1 = __importDefault(require("./structures/PostHistory"));
 exports.PostHistory = PostHistory_1.default;
 const PostSet_1 = __importDefault(require("./structures/PostSet"));
 exports.PostSet = PostSet_1.default;
+const Tag_1 = __importDefault(require("./structures/Tag"));
+exports.Tag = Tag_1.default;
+const TagHistory_1 = __importDefault(require("./structures/TagHistory"));
+exports.TagHistory = TagHistory_1.default;
 const User_1 = __importDefault(require("./structures/User"));
 exports.User = User_1.default;
 const WikiPage_1 = __importDefault(require("./structures/WikiPage"));
@@ -45,10 +55,13 @@ const package_json_1 = __importDefault(require("../package.json"));
 // note for future reference (browser compatibility?)
 // POST with "_method=*" can be used in place of PUT/PATCH/DELETE
 class E621 {
+    POST_LIMIT_PER_REQUEST = 320;
     request = new RequestHandler_1.default(this);
-    postSets = new PostSets_1.default(this);
+    artists = new Artists_1.default(this);
     pools = new Pools_1.default(this);
     posts = new Posts_1.default(this);
+    postSets = new PostSets_1.default(this);
+    tags = new Tags_1.default(this);
     userFeedback = new UserFeedback_1.default(this);
     users = new Users_1.default(this);
     wikiPages = new WikiPages_1.default(this);
@@ -71,6 +84,7 @@ class E621 {
                     options.imageReconstructionType = "yiffy";
                     break;
                 case "e621.local":
+                case "localhost":
                     options.imageReconstructionType = "dev";
                     break;
                 default: {
@@ -110,4 +124,4 @@ class E621 {
 exports.default = E621;
 var RequestHandler_2 = require("./util/RequestHandler");
 Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return RequestHandler_2.APIError; } });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUNBLDJFQUFtRDtBQUNuRCxVQUFVO0FBQ1YsNERBQW9DO0FBQ3BDLDBFQUFrRDtBQUNsRCw0REFBb0M7QUFDcEMsa0VBQTBDO0FBQzFDLDREQUFvQztBQUNwQyxvRUFBNEM7QUFDNUMsYUFBYTtBQUNiLHVGQUErRDtBQXVFdEQsNEJBdkVGLDJCQUFpQixDQXVFRTtBQXRFMUIsNkRBQXFDO0FBc0VULGVBdEVyQixjQUFJLENBc0VxQjtBQXJFaEMsMkVBQW1EO0FBcUVqQixzQkFyRTNCLHFCQUFXLENBcUUyQjtBQXBFN0MsNkRBQXFDO0FBb0VVLGVBcEV4QyxjQUFJLENBb0V3QztBQW5FbkQsMkVBQW1EO0FBbUVFLHNCQW5FOUMscUJBQVcsQ0FtRThDO0FBbEVoRSxtRUFBMkM7QUFrRXVCLGtCQWxFM0QsaUJBQU8sQ0FrRTJEO0FBakV6RSw2REFBcUM7QUFpRXNDLGVBakVwRSxjQUFJLENBaUVvRTtBQWhFL0UscUVBQTZDO0FBZ0VvQyxtQkFoRTFFLGtCQUFRLENBZ0UwRTtBQS9EekYsbUZBQTJEO0FBK0RnQywwQkEvRHBGLHlCQUFlLENBK0RvRjtBQTdEMUcsbUVBQWtDO0FBRWxDLHFEQUFxRDtBQUNyRCxpRUFBaUU7QUFDakUsTUFBcUIsSUFBSTtJQUN4QixPQUFPLEdBQUcsSUFBSSx3QkFBYyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ25DLFFBQVEsR0FBRyxJQUFJLGtCQUFRLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDOUIsS0FBSyxHQUFHLElBQUksZUFBSyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3hCLEtBQUssR0FBRyxJQUFJLGVBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN4QixZQUFZLEdBQUcsSUFBSSxzQkFBWSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3RDLEtBQUssR0FB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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQUNBLDJFQUFtRDtBQUNuRCxVQUFVO0FBQ1YsZ0VBQXdDO0FBQ3hDLDREQUFvQztBQUNwQyw0REFBb0M7QUFDcEMsa0VBQTBDO0FBQzFDLDBEQUFrQztBQUNsQywwRUFBa0Q7QUFDbEQsNERBQW9DO0FBQ3BDLG9FQUE0QztBQUM1QyxhQUFhO0FBQ2IsaUVBQXlDO0FBK0V4QyxpQkEvRU0sZ0JBQU0sQ0ErRU47QUE5RVAsK0VBQXVEO0FBK0V0RCx3QkEvRU0sdUJBQWEsQ0ErRU47QUE5RWQsdUZBQStEO0FBK0U5RCw0QkEvRU0sMkJBQWlCLENBK0VOO0FBOUVsQiw2REFBcUM7QUErRXBDLGVBL0VNLGNBQUksQ0ErRU47QUE5RUwsMkVBQW1EO0FBK0VsRCxzQkEvRU0scUJBQVcsQ0ErRU47QUE5RVosNkRBQXFDO0FBK0VwQyxlQS9FTSxjQUFJLENBK0VOO0FBOUVMLDJFQUFtRDtBQStFbEQsc0JBL0VNLHFCQUFXLENBK0VOO0FBOUVaLG1FQUEyQztBQStFMUMsa0JBL0VNLGlCQUFPLENBK0VOO0FBOUVSLDJEQUFtQztBQStFbEMsY0EvRU0sYUFBRyxDQStFTjtBQTlFSix5RUFBaUQ7QUErRWhELHFCQS9FTSxvQkFBVSxDQStFTjtBQTlFWCw2REFBcUM7QUErRXBDLGVBL0VNLGNBQUksQ0ErRU47QUE5RUwscUVBQTZDO0FBK0U1QyxtQkEvRU0sa0JBQVEsQ0ErRU47QUE5RVQsbUZBQTJEO0FBK0UxRCwwQkEvRU0seUJBQWUsQ0ErRU47QUE3RWhCLG1FQUFrQztBQUVsQyxxREFBcUQ7QUFDckQsaUVBQWlFO0FBQ2pFLE1BQXFCLElBQUk7SUFDeEIsc0JBQXNCLEdBQUcsR0FBRyxDQUFDO0lBQzdCLE9BQU8sR0FBRyxJQUFJLHdCQUFjLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDbkMsT0FBTyxH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

package/build/src/modules/Artists.d.ts

@@ -0,0 +1,108 @@
+import type E621 from "..";
+import Artist from "../structures/Artist";
+import type { SearchArtistsOptions, CreateArtistOptions, ModifyArtistOptions, SearchArtistHistoryOptions } from "../types";
+import ArtistHistory from "../structures/ArtistHistory";
+export default class Artists {
+    private readonly auth;
+    private readonly main;
+    constructor(main: E621);
+    /**
+     * Get an artist by their id
+     *
+     * @param {number} id - The id of the artist to get
+     * @returns {Promise<(Artist | null)>}
+     */
+    get(id: number): Promise<Artist | null>;
+    /**
+     * Get an artist by their name
+     *
+     * @param {string} name - The name of the artist to get
+     * @returns {Promise<(Artist | null)>}
+     */
+    getByName(name: string): Promise<Artist | null>;
+    /**
+     * Search for artists
+     *
+     * @param {object} [options]
+     * @param {string} [options.name] - narrow the results by the name of the artist
+     * @param {string} [options.url] - narrow the results by urls of the artist
+     * @param {string} [options.creator] - narrow the results by the (name of the) creator of the artist page
+     * @param {boolean} [options.active] - narrow the results by the artist being active
+     * @param {boolean} [options.banned] - narrow the results by the artist being banned
+     * @param {boolean} [options.has_tag] - narrow the results by the artist having a matching tag
+     * @param {SearchArtistsOrder} [options.order] - the order of the results
+     * @param {(number |`${"" | "a" | "b"}${number}`)} [options.page] - page of results to get
+     * @param {number} [options.limit] - limit the maximum amount of results returned
+     * @returns {Promise<Array<ArtistProperties>>}
+     */
+    search(options?: SearchArtistsOptions): Promise<Artist[]>;
+    /**
+     * Create an artist
+     *
+     * * Requires Authentication
+     *
+     * @param {object} options
+     * @param {string} options.name - the name of artist
+     * @param {number} [options.linkedUserID] - the id of the user associated with this artist (requires janitor)
+     * @param {boolean} [options.locked] - if the artist should be locked (requires janitor)
+     * @param {(Array<string> | string)} [options.otherNames] - the other names for this artist
+     * @param {string} [options.groupName] - the group name of this artist
+     * @param {(Array<string> | string)} [options.urls] - the urls associated with this artist
+     * @param {string} [options.notes] - notes for this artist
+     * @returns {Promise<Artist>}
+     */
+    create(options: CreateArtistOptions): Promise<Artist>;
+    /**
+     * modify an artist
+     *
+     * * Requires Authentication
+     *
+     * @param {number} id - the id  of the artists to edit
+     * @param {object} options
+     * @param {string} [options.name] - the name of artist (requires janitor)
+     * @param {number} [options.linkedUserID] - the id of the user associated with this artist (requires janitor)
+     * @param {boolean} [options.locked] - if the artist should be locked (requires janitor)
+     * @param {(Array<string> | string)} [options.otherNames] - the other names for this artist
+     * @param {string} [options.groupName] - the group name of this artist
+     * @param {(Array<string> | string)} [options.urls] - the urls associated with this artist
+     * @param {string} [options.notes] - notes for this artist
+     * @returns {Promise<Artist>}
+     */
+    modify(id: number, options: ModifyArtistOptions): Promise<Artist>;
+    /**
+     * Delete an artist
+     *
+     * * Requires Authentication
+     *
+     * * Requires Janitor
+     *
+     * @param {number} id - the id of the artist to delete
+     * @returns {Promise<null>}
+     */
+    delete(id: number): Promise<null>;
+    /**
+     * Revert an artist to a previous version
+     *
+     * * Requires Authentication
+     *
+     * @param {number} id - the id of the artist to revert
+     * @param {number} versionID - the version id to revert to (see history)
+     */
+    revert(id: number, versionID: number): Promise<null>;
+    /**
+     * Search the artist history
+     *
+     * * Requires Authentication
+     *
+     * @param {object} [options]
+     * @param {number} [options.artistID] - narrow the results by artist id
+     * @param {string} [options.artistName] - narrow the results by artist name
+     * @param {number} [options.updaterID] - narrow the results by updater id
+     * @param {string} [options.updaterName] - narrow the results by updater name
+     * @param {(number |`${"" | "a" | "b"}${number}`)} [options.page] - page of results to get
+     * @param {number} [options.limit] - limit the maximum amount of results returned
+     * @param
+     * @returns {Promise<Array<ArtistHistory>>}
+     */
+    searchHistory(options?: SearchArtistHistoryOptions): Promise<ArtistHistory[]>;
+}