e621 3.0.3 → 3.2.0

package/dist/lib/modules/PostVotes.js

@@ -1,78 +1,117 @@
 import { __decorate, __metadata } from "tslib";
-import { deletePostVotes, lockPostVotes, searchPostVotes } from "../generated/sdk.js";
+import { postVotes_create, postVotes_delete, postVotes_destroy, postVotes_lock, postVotes_index } from "../generated/sdk.js";
 import PostVote from "../models/PostVote.js";
 import { OperationID } from "../util.js";
 import Base from "./Base.js";
 /** @category Modules */
 export default class PostVotes extends Base {
+    static moduleKey = "postVotes";
+    /**
+     *
+     * @requiresApiKeyAuth
+     *
+     * @operationId {@link https://e621.wiki/#operations-Post_Votes-post_votes\#create post_votes#create}
+     *
+     * @see {@link https://e621.wiki/#operations-Post_Votes-post_votes\#create Documentation} for more details.
+     */
+    async create(id, score, no_unvote) {
+        return postVotes_create({
+            client: this.client,
+            path: { id },
+            query: { no_unvote, score },
+        }).then(res => this._handleResponse(res, 200, true));
+    }
     /**
-     * Delete Post Vote
      *
      * You must be Admin+. Errors if ids is not provided.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Post_Votes-deletePostVotes deletePostVotes}
+     * @operationId {@link https://e621.wiki/#operations-Post_Votes-post_votes\#delete post_votes#delete}
      *
-     * @see {@link https://e621.wiki/#operations-Post_Votes-deletePostVotes Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Post_Votes-post_votes\#delete Documentation} for more details.
      */
     async delete(ids) {
-        return deletePostVotes({
+        return postVotes_delete({
             client: this.client,
             query: { ids: ids.join(",") },
         }).then(res => this._handleResponse(res, 204, true));
     }
     /**
-     * Lock Post Votes
      *
      * You must be Moderator+. Errors if ids is not provided.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Post_Votes-lockPostVotes lockPostVotes}
+     * @operationId {@link https://e621.wiki/#operations-Post_Votes-post_votes\#lock post_votes#lock}
      *
-     * @see {@link https://e621.wiki/#operations-Post_Votes-lockPostVotes Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Post_Votes-post_votes\#lock Documentation} for more details.
      */
     async lock(ids) {
-        return lockPostVotes({
+        return postVotes_lock({
             client: this.client,
             query: { ids: ids.join(",") },
         }).then(res => this._handleResponse(res, 204, true));
     }
     /**
-     * Search Post Votes
      *
      * You must be Moderator+.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Post_Votes-searchPostVotes searchPostVotes}
+     * @operationId {@link https://e621.wiki/#operations-Post_Votes-post_votes\#index post_votes#index}
      *
-     * @see {@link https://e621.wiki/#operations-Post_Votes-searchPostVotes Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Post_Votes-post_votes\#index Documentation} for more details.
      */
     async search(options) {
-        return searchPostVotes({
+        return postVotes_index({
             client: this.client,
             query: options,
         }).then(res => this._handleResponse(res, 200, true, PostVote));
     }
+    /**
+     *
+     * @requiresApiKeyAuth
+     *
+     * @operationId {@link https://e621.wiki/#operations-Post_Votes-post_votes\#destroy post_votes#destroy}
+     *
+     * @see {@link https://e621.wiki/#operations-Post_Votes-post_votes\#destroy Documentation} for more details.
+     */
+    async unvote(id) {
+        return postVotes_destroy({
+            client: this.client,
+            path: { id },
+        }).then(res => this._handleResponse(res, 204, true));
+    }
 }
 __decorate([
-    OperationID("deletePostVotes"),
+    OperationID("post_votes#create"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number, Number, Boolean]),
+    __metadata("design:returntype", Promise)
+], PostVotes.prototype, "create", null);
+__decorate([
+    OperationID("post_votes#delete"),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Array]),
     __metadata("design:returntype", Promise)
 ], PostVotes.prototype, "delete", null);
 __decorate([
-    OperationID("lockPostVotes"),
+    OperationID("post_votes#lock"),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Array]),
     __metadata("design:returntype", Promise)
 ], PostVotes.prototype, "lock", null);
 __decorate([
-    OperationID("searchPostVotes"),
+    OperationID("post_votes#index"),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [Object]),
     __metadata("design:returntype", Promise)
 ], PostVotes.prototype, "search", null);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUG9zdFZvdGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL21vZHVsZXMvUG9zdFZvdGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQSxPQUFPLEVBQUUsZUFBZSxFQUFFLGFBQWEsRUFBRSxlQUFlLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUV0RixPQUFPLFFBQVEsTUFBTSx1QkFBdUIsQ0FBQztBQUM3QyxPQUFPLEVBQUUsV0FBVyxFQUErQixNQUFNLFlBQVksQ0FBQztBQUV0RSxPQUFPLElBQUksTUFBTSxXQUFXLENBQUM7QUFLN0Isd0JBQXdCO0FBQ3hCLE1BQU0sQ0FBQyxPQUFPLE9BQU8sU0FBVSxTQUFRLElBQUk7SUFDdkM7Ozs7Ozs7Ozs7T0FVQTtJQUVNLEFBQU4sS0FBSyxDQUFDLE1BQU0sQ0FBQyxHQUFrQjtRQUMzQixPQUFPLGVBQWUsQ0FBQztZQUNuQixNQUFNLEVBQUUsSUFBSSxDQUFDLE1BQU07WUFDbkIsS0FBSyxFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUU7U0FDaEMsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxlQUFlLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxJQUFJLENBQUMsQ0FBQyxDQUFDO0lBQ3pELENBQUM7SUFFRDs7Ozs7Ozs7OztPQVVBO0lBRU0sQUFBTixLQUFLLENBQUMsSUFBSSxDQUFDLEdBQWtCO1FBQ3pCLE9BQU8sYUFBYSxDQUFDO1lBQ2pCLE1BQU0sRUFBRSxJQUFJLENBQUMsTUFBTTtZQUNuQixLQUFLLEVBQUUsRUFBRSxHQUFHLEVBQUUsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRTtTQUNoQyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFDLENBQUM7SUFDekQsQ0FBQztJQUVEOzs7Ozs7Ozs7O09BVUE7SUFFTSxBQUFOLEtBQUssQ0FBQyxNQUFNLENBQUMsT0FBZ0M7UUFDekMsT0FBTyxlQUFlLENBQUM7WUFDbkIsTUFBTSxFQUFFLElBQUksQ0FBQyxNQUFNO1lBQ25CLEtBQUssRUFBRSxPQUFPO1NBQ2pCLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsSUFBSSxFQUFFLFFBQVEsQ0FBQyxDQUFDLENBQUM7SUFDbkUsQ0FBQztDQUNKO0FBNUNTO0lBRFIsV0FBVyxDQUFDLGlCQUFpQixDQUFDOztxQ0FDVixLQUFLOzt1Q0FLdEI7QUFjSztJQURSLFdBQVcsQ0FBQyxlQUFlLENBQUM7O3FDQUNWLEtBQUs7O3FDQUtwQjtBQWNLO0lBRFIsV0FBVyxDQUFDLGlCQUFpQixDQUFDOzs7O3VDQU0zQiJ9
+__decorate([
+    OperationID("post_votes#destroy"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Number]),
+    __metadata("design:returntype", Promise)
+], PostVotes.prototype, "unvote", null);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUG9zdFZvdGVzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vbGliL21vZHVsZXMvUG9zdFZvdGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsZ0JBQWdCLEVBQUUsaUJBQWlCLEVBQUUsY0FBYyxFQUFFLGVBQWUsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQzdILE9BQU8sUUFBUSxNQUFNLHVCQUF1QixDQUFDO0FBQzdDLE9BQU8sRUFBZSxXQUFXLEVBQWtELE1BQU0sWUFBWSxDQUFDO0FBRXRHLE9BQU8sSUFBSSxNQUFNLFdBQVcsQ0FBQztBQVc3Qix3QkFBd0I7QUFDeEIsTUFBTSxDQUFDLE9BQU8sT0FBTyxTQUFVLFNBQVEsSUFBSTtJQUN2QyxNQUFNLENBQVUsU0FBUyxHQUFHLFdBQW9CLENBQUM7SUFDakQ7Ozs7Ozs7T0FPQTtJQUVNLEFBQU4sS0FBSyxDQUFDLE1BQU0sQ0FBQyxFQUFVLEVBQUUsS0FBb0IsRUFBRSxTQUFtQjtRQUM5RCxPQUFPLGdCQUFnQixDQUFDO1lBQ3BCLE1BQU0sRUFBRSxJQUFJLENBQUMsTUFBTTtZQUNuQixJQUFJLEVBQUUsRUFBRSxFQUFFLEVBQUU7WUFDWixLQUFLLEVBQUUsRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFO1NBQzlCLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsSUFBSSxDQUFDLENBQUMsQ0FBQztJQUN6RCxDQUFDO0lBRUQ7Ozs7Ozs7OztPQVNBO0lBRU0sQUFBTixLQUFLLENBQUMsTUFBTSxDQUFDLEdBQWtCO1FBQzNCLE9BQU8sZ0JBQWdCLENBQUM7WUFDcEIsTUFBTSxFQUFFLElBQUksQ0FBQyxNQUFNO1lBQ25CLEtBQUssRUFBRSxFQUFFLEdBQUcsRUFBRSxHQUFHLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFO1NBQ2hDLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsSUFBSSxDQUFDLENBQUMsQ0FBQztJQUN6RCxDQUFDO0lBRUQ7Ozs7Ozs7OztPQVNBO0lBRU0sQUFBTixLQUFLLENBQUMsSUFBSSxDQUFDLEdBQWtCO1FBQ3pCLE9BQU8sY0FBYyxDQUFDO1lBQ2xCLE1BQU0sRUFBRSxJQUFJLENBQUMsTUFBTTtZQUNuQixLQUFLLEVBQUUsRUFBRSxHQUFHLEVBQUUsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRTtTQUNoQyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLGVBQWUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFDLENBQUM7SUFDekQsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTQTtJQUVNLEFBQU4sS0FBSyxDQUFDLE1BQU0sQ0FBQyxPQUFnQztRQUN6QyxPQUFPLGVBQWUsQ0FBQztZQUNuQixNQUFNLEVBQUUsSUFBSSxDQUFDLE1BQU07WUFDbkIsS0FBSyxFQUFFLE9BQU87U0FDakIsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxlQUFlLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsUUFBUSxDQUFDLENBQUMsQ0FBQztJQUNuRSxDQUFDO0lBRUQ7Ozs7Ozs7T0FPQTtJQUVNLEFBQU4sS0FBSyxDQUFDLE1BQU0sQ0FBQyxFQUFVO1FBQ25CLE9BQU8saUJBQWlCLENBQUM7WUFDckIsTUFBTSxFQUFFLElBQUksQ0FBQyxNQUFNO1lBQ25CLElBQUksRUFBRSxFQUFFLEVBQUUsRUFBRTtTQUNmLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxHQUFHLEVBQUUsSUFBSSxDQUFDLENBQUMsQ0FBQztJQUN6RCxDQUFDOztBQTVFSztJQURSLFdBQVcsQ0FBQyxtQkFBbUIsQ0FBQzs7Ozt1Q0FPN0I7QUFhSztJQURSLFdBQVcsQ0FBQyxtQkFBbUIsQ0FBQzs7cUNBQ1osS0FBSzs7dUNBS3RCO0FBYUs7SUFEUixXQUFXLENBQUMsaUJBQWlCLENBQUM7O3FDQUNaLEtBQUs7O3FDQUtwQjtBQWFLO0lBRFIsV0FBVyxDQUFDLGtCQUFrQixDQUFDOzs7O3VDQU01QjtBQVdLO0lBRFIsV0FBVyxDQUFDLG9CQUFvQixDQUFDOzs7O3VDQU05QiJ9

package/dist/lib/modules/Posts.d.ts

@@ -1,204 +1,264 @@
+import MinimalUser from "../models/MinimalUser.js";
 import Post from "../models/Post.js";
-import { type ExtractValue, type TransformDataBodyToOptions, type TransformDataQueryToOptions } from "../util.js";
+import ThumbnailPost from "../models/ThumbnailPost.js";
+import { type TransformDataBodyToOptions, type TransformDataQueryToOptions } from "../util.js";
 import Base from "./Base.js";
-import PostFlag from "./posts/Flag.js";
-import PostVotes from "./posts/Votes.js";
-import type { DeletePostData, GetPostInSequenceData, GetRecommendedPostsData, ListPostFavoritesData, MovePostFavoritesData, RecommendedPosts, SearchPostsData } from "../generated/types.js";
+import { type NoV2Options, type PostFormat } from "./posts/Format.js";
+import type { StaffPostPostsDeleteData, PostsShowData, PostsShowSeqData, PostsRandomData, PostRecommendationsArtistData, PostFavoritesIndexData, PostsMarkAsTranslatedData, StaffPostPostsMoveFavoritesData, PostRecommendation, StaffPostPostsReownerData, PostsIndexData, PostsUpdateData, PostsUpdateIqdbData } from "../generated/types.js";
 /** @category Modules/Types */
-export interface DeletePostOptions extends TransformDataBodyToOptions<DeletePostData> {
+export interface DeletePostOptions extends TransformDataBodyToOptions<StaffPostPostsDeleteData> {
 }
 /** @category Modules/Types */
-export interface MovePostFavoritesOptions extends TransformDataBodyToOptions<MovePostFavoritesData> {
+export interface MovePostFavoritesOptions extends TransformDataBodyToOptions<StaffPostPostsMoveFavoritesData> {
 }
 /** @category Modules/Types */
-export interface SearchPostsOptions extends TransformDataQueryToOptions<SearchPostsData> {
+export interface SearchPostsOptions extends TransformDataQueryToOptions<PostsIndexData> {
 }
 /** @category Modules/Types */
-export interface ListPostFavoritesOptions extends TransformDataQueryToOptions<ListPostFavoritesData> {
+export interface ListPostFavoritesOptions extends TransformDataQueryToOptions<PostFavoritesIndexData> {
 }
 /** @category Modules/Types */
-export interface GetRecommendedPostsOptions extends TransformDataQueryToOptions<GetRecommendedPostsData> {
+export interface GetRandomPostOptions extends TransformDataQueryToOptions<PostsRandomData> {
 }
+/** @category Modules/Types */
+export interface GetPostOptions extends TransformDataQueryToOptions<PostsShowData> {
+}
+/** @category Modules/Types */
+export interface GetPostInSequenceOptions extends TransformDataQueryToOptions<PostsShowSeqData> {
+}
+/** @category Modules/Types */
+export interface MarkPostAsTranslatedOptions extends TransformDataQueryToOptions<PostsMarkAsTranslatedData> {
+}
+/** @category Modules/Types */
+export interface UpdatePostOptions extends TransformDataBodyToOptions<PostsUpdateData>, TransformDataQueryToOptions<PostsUpdateData> {
+}
+/** @category Modules/Types */
+export interface UpdatePostIqdbOptions extends TransformDataQueryToOptions<PostsUpdateIqdbData> {
+}
+/** @category Modules/Types */
+export interface RecommendedPostsOptions extends TransformDataQueryToOptions<PostRecommendationsArtistData> {
+}
+/** @category Modules/Types */
+export interface ReownPostOptions extends TransformDataBodyToOptions<StaffPostPostsReownerData> {
+}
+/** @category Modules/Types */
+export interface PostPreviousOwner {
+    id: number;
+    name: string;
+}
+/** @category Modules/Types */
+export interface RecommendedPostsResult {
+    model_version: string;
+    post_data: Array<ThumbnailPost>;
+    post_id: number;
+    results: Array<PostRecommendation>;
+}
+/** @category Modules/Types */
+export type PostSearchResult<O extends SearchPostsOptions> = O extends {
+    md5: string;
+} ? PostFormat<O["v2"], O["mode"]> : Array<PostFormat<O["v2"], O["mode"]>>;
 /** @category Modules */
 export default class Posts extends Base {
-    flag: PostFlag;
-    votes: PostVotes;
+    static readonly moduleKey: "posts";
     /**
-     * AI Check Post
      *
      * You must be Janitor+.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-aiCheckPost aiCheckPost}
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#ai_check staff/post/posts#ai_check}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-aiCheckPost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#ai_check Documentation} for more details.
      */
     aiCheck(id: number): Promise<string>;
     /**
-     * Copy Notes To Post
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-copyNotesToPost copyNotesToPost}
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#copy_notes posts#copy_notes}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-copyNotesToPost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#copy_notes Documentation} for more details.
      */
     copyNotes(id: number, other_post_id: number): Promise<null>;
     /**
-     * Delete Post
      *
      * You must have the "Approve Posts" permission. `commit=Delete` must be set.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-deletePost deletePost}
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#delete staff/post/posts#delete}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-deletePost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#delete Documentation} for more details.
      */
     delete(id: number, options: DeletePostOptions): Promise<unknown>;
     /**
-     * Expunge Post
      *
      * You must have the "Approve Posts" permission and be Admin+.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-expungePost expungePost}
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#expunge staff/post/posts#expunge}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-expungePost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#expunge Documentation} for more details.
      */
     expunge(id: number, reason: string): Promise<Post>;
     /**
-     * List Post Favorites
      *
      * You must be the user or Moderator+ to see users that have their favorites hidden.
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-listPostFavorites listPostFavorites}
+     * @operationId {@link https://e621.wiki/#operations-Post_Favorites-post_favorites\#index post_favorites#index}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-listPostFavorites Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Post_Favorites-post_favorites\#index Documentation} for more details.
      */
-    favorites(id: number, options: ListPostFavoritesOptions): Promise<Array<Post>>;
+    favorites(id: number, options: ListPostFavoritesOptions): Promise<Array<MinimalUser>>;
     /**
-     * Get Post
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-getPost getPost}
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#show posts#show}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-getPost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#show Documentation} for more details.
      */
-    get(id: number): Promise<Post | null>;
+    get<const O extends GetPostOptions = NoV2Options>(id: number, options?: O): Promise<PostFormat<O["v2"], O["mode"]> | null>;
     /**
-     * Mark Post As Translated
      *
      * Will error if no body is provided.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-markPostAsTranslated markPostAsTranslated}
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#mark_as_translated posts#mark_as_translated}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-markPostAsTranslated Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#mark_as_translated Documentation} for more details.
      */
-    markTranslated(id: number): Promise<Post>;
+    markTranslated<const O extends MarkPostAsTranslatedOptions = NoV2Options>(id: number, options?: O): Promise<PostFormat<O["v2"], O["mode"]>>;
     /**
-     * Move Post Favorites
      *
      * You must have the "Approve Posts" permission. `commit=Submit`` must be set.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-movePostFavorites movePostFavorites}
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#move_favorites staff/post/posts#move_favorites}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-movePostFavorites Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#move_favorites Documentation} for more details.
      */
     moveFavorites(id: number, options: MovePostFavoritesOptions): Promise<unknown>;
     /**
-     * Get Random Post
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-getRandomPost getRandomPost}
+     * You must be an Approver
+     *
+     * @requiresApiKeyAuth
+     *
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#previous_owners staff/post/posts#previous_owners}
+     *
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#previous_owners Documentation} for more details.
+     */
+    previousOwners(id: number): Promise<Array<PostPreviousOwner>>;
+    /**
+     *
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#random posts#random}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-getRandomPost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#random Documentation} for more details.
      */
-    random(tags?: string): Promise<Post>;
+    random<const O extends GetRandomPostOptions = NoV2Options>(options?: O): Promise<PostFormat<O["v2"], O["mode"]>>;
     /**
-     * Get Recommended Posts
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-getRecommendedPosts getRecommendedPosts}
+     * @operationId {@link https://e621.wiki/#operations-Posts-post_recommendations\#artist post_recommendations#artist}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-getRecommendedPosts Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-post_recommendations\#artist Documentation} for more details.
      */
-    recommended(id: number, options: GetRecommendedPostsOptions): Promise<RecommendedPosts>;
+    recommendedByArtist(id: number, options?: RecommendedPostsOptions): Promise<RecommendedPostsResult>;
+    /**
+     *
+     * @operationId {@link https://e621.wiki/#operations-Posts-post_recommendations\#tags post_recommendations#tags}
+     *
+     * @see {@link https://e621.wiki/#operations-Posts-post_recommendations\#tags Documentation} for more details.
+     */
+    recommendedByTags(id: number, options?: RecommendedPostsOptions): Promise<RecommendedPostsResult>;
     /**
-     * Regenerate Post Thumbnails
      *
      * You must be Janitor+.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-regeneratePostThumbnails regeneratePostThumbnails}
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#regenerate_thumbnails staff/post/posts#regenerate_thumbnails}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-regeneratePostThumbnails Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#regenerate_thumbnails Documentation} for more details.
      */
     regenerateThumbnails(id: number): Promise<Post>;
     /**
-     * Regenerate Post Videos
      *
      * You must be Janitor+.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-regeneratePostVideos regeneratePostVideos}
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#regenerate_videos staff/post/posts#regenerate_videos}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-regeneratePostVideos Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#regenerate_videos Documentation} for more details.
      */
     regenerateVideos(id: number): Promise<null>;
     /**
-     * Revert Post
+     *
+     * You must have be Janitor+ and an Approver
+     *
+     * @requiresApiKeyAuth
+     *
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#reowner staff/post/posts#reowner}
+     *
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#reowner Documentation} for more details.
+     */
+    reown(id: number, options: ReownPostOptions): Promise<string>;
+    /**
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-revertPost revertPost}
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#revert posts#revert}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-revertPost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#revert Documentation} for more details.
      */
     revert(id: number, version_id: number): Promise<null>;
     /**
-     * Search Posts
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-searchPosts searchPosts}
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#index posts#index}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-searchPosts Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#index Documentation} for more details.
      */
-    search(options?: SearchPostsOptions): Promise<Array<Post>>;
+    search<const O extends SearchPostsOptions = NoV2Options>(options?: O): Promise<PostSearchResult<O>>;
     /**
-     * Get Post In Sequence
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-getPostInSequence getPostInSequence}
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#show_seq posts#show_seq}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-getPostInSequence Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#show_seq Documentation} for more details.
      */
-    sequence(id: number, seq?: ExtractValue<"seq", GetPostInSequenceData>): Promise<Post>;
+    sequence<const O extends GetPostInSequenceOptions = NoV2Options>(id: number, options?: O): Promise<PostFormat<O["v2"], O["mode"]>>;
     /**
-     * Undelete Post
      *
      * You must have the "Approve Posts" permission.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-undeletePost undeletePost}
+     * @operationId {@link https://e621.wiki/#operations-Posts-staff/post/posts\#undelete staff/post/posts#undelete}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-undeletePost Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-staff/post/posts\#undelete Documentation} for more details.
      */
     undelete(id: number): Promise<Post>;
     /**
-     * Update Post IQDB
+     *
+     * Most errors are silently swallowed.
+     *
+     * @requiresApiKeyAuth
+     *
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#update posts#update}
+     *
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#update Documentation} for more details.
+     */
+    update<const O extends UpdatePostOptions = NoV2Options>(id: number, options?: O): Promise<PostFormat<O["v2"], O["mode"]>>;
+    /**
      *
      * You must be Admin+.
      *
      * @requiresApiKeyAuth
      *
-     * @operationId {@link https://e621.wiki/#operations-Posts-updatePostIqdb updatePostIqdb}
+     * @operationId {@link https://e621.wiki/#operations-Posts-posts\#update_iqdb posts#update_iqdb}
      *
-     * @see {@link https://e621.wiki/#operations-Posts-updatePostIqdb Documentation} for more details.
+     * @see {@link https://e621.wiki/#operations-Posts-posts\#update_iqdb Documentation} for more details.
      */
-    updateIqdb(id: number): Promise<Post>;
+    updateIqdb<const O extends UpdatePostIqdbOptions = NoV2Options>(id: number, options?: O): Promise<PostFormat<O["v2"], O["mode"]>>;
 }