lemmy-js-client 1.0.0-alpha.1 → 1.0.0-comment-lock.0

package/README.md

@@ -52,6 +52,12 @@ Use `pnpm add` to develop and test changes locally:
 
 `pnpm add path/to/lemmy-js-client`
 
+Alternatively, use `yalc publish` and `yalc add lemmy-js-client`
+
+## Generating typescript types from lemmy structs
+
+Run `./scripts/copy_generated_types_from_lemmy.sh`
+
 ## OpenAPI
 
 To generate OpenAPI docs, run `pnpm tsoa`

package/dist/http.d.ts

@@ -1,5 +1,5 @@
 import { Controller } from "@tsoa/runtime";
-import { DeleteImageParamsI, GetCommentI, GetCommentsI, GetCommunityI, GetCommunityPendingFollowsCountI, GetModlogI, GetPersonDetailsI, GetPostI, GetPostsI, GetRandomCommunityI, GetRegistrationApplicationI, GetReportCountI, GetSiteMetadataI, ListBannedPersonsI, ListCommentLikesI, ListCommunitiesI, ListCommunityPendingFollowsI, ListCustomEmojisI, ListInboxI, ListMediaI, ListPersonContentI, ListPersonSavedI, ListPostLikesI, ListRegistrationApplicationsI, ListReportsI, ListTaglinesI, ResolveObjectI, SearchI, UploadImage } from "./other_types";
+import { AdminListUsersI, CommunityIdQueryI, DeleteImageParamsI, GetCommentI, GetCommentsI, GetCommunityI, GetCommunityPendingFollowsCountI, GetModlogI, GetMultiCommunityI, GetPersonDetailsI, GetPostI, GetPostsI, GetRandomCommunityI, GetRegistrationApplicationI, GetReportCountI, GetSiteMetadataI, ListCommentLikesI, ListCommunitiesI, ListCommunityPendingFollowsI, ListCustomEmojisI, ListNotificationsI, ListMediaI, ListMultiCommunitiesI, ListPersonContentI, ListPersonHiddenI, ListPersonLikedI, ListPersonReadI, ListPersonSavedI, ListPostLikesI, ListRegistrationApplicationsI, ListReportsI, ListTaglinesI, ResolveObjectI, SearchI, UploadImage } from "./other_types";
 import { AddAdmin } from "./types/AddAdmin";
 import { AddAdminResponse } from "./types/AddAdminResponse";
 import { AddModToCommunity } from "./types/AddModToCommunity";
@@ -10,7 +10,6 @@ import { BanFromCommunityResponse } from "./types/BanFromCommunityResponse";
 import { MarkManyPostsAsRead } from "./types/MarkManyPostsAsRead";
 import { BanPerson } from "./types/BanPerson";
 import { BanPersonResponse } from "./types/BanPersonResponse";
-import { BannedPersonsResponse } from "./types/BannedPersonsResponse";
 import { BlockCommunity } from "./types/BlockCommunity";
 import { BlockCommunityResponse } from "./types/BlockCommunityResponse";
 import { BlockPerson } from "./types/BlockPerson";
@@ -18,12 +17,15 @@ import { BlockPersonResponse } from "./types/BlockPersonResponse";
 import { ChangePassword } from "./types/ChangePassword";
 import { CommentReportResponse } from "./types/CommentReportResponse";
 import { CommentResponse } from "./types/CommentResponse";
+import { CommunityReportResponse } from "./types/CommunityReportResponse";
 import { CommunityResponse } from "./types/CommunityResponse";
 import { CreateComment } from "./types/CreateComment";
 import { CreateCommentLike } from "./types/CreateCommentLike";
 import { CreateCommentReport } from "./types/CreateCommentReport";
 import { CreateCommunity } from "./types/CreateCommunity";
+import { CreateCommunityReport } from "./types/CreateCommunityReport";
 import { CreateCommunityTag } from "./types/CreateCommunityTag";
+import { UpdateCommunityTag } from "./types/UpdateCommunityTag";
 import { CreateCustomEmoji } from "./types/CreateCustomEmoji";
 import { CreateOAuthProvider } from "./types/CreateOAuthProvider";
 import { CreatePost } from "./types/CreatePost";
@@ -68,9 +70,9 @@ import { GetUnreadRegistrationApplicationCountResponse } from "./types/GetUnread
 import { ListCommunitiesResponse } from "./types/ListCommunitiesResponse";
 import { ListRegistrationApplicationsResponse } from "./types/ListRegistrationApplicationsResponse";
 import { LockPost } from "./types/LockPost";
+import { LockComment } from "./types/LockComment";
 import { Login } from "./types/Login";
 import { LoginResponse } from "./types/LoginResponse";
-import { MarkCommentReplyAsRead } from "./types/MarkCommentReplyAsRead";
 import { MarkPostAsRead } from "./types/MarkPostAsRead";
 import { MarkPrivateMessageAsRead } from "./types/MarkPrivateMessageAsRead";
 import { PasswordChangeAfterReset } from "./types/PasswordChangeAfterReset";
@@ -89,7 +91,7 @@ import { RemoveComment } from "./types/RemoveComment";
 import { RemoveCommunity } from "./types/RemoveCommunity";
 import { RemovePost } from "./types/RemovePost";
 import { ResolveCommentReport } from "./types/ResolveCommentReport";
-import { ResolveObjectResponse } from "./types/ResolveObjectResponse";
+import { ResolveCommunityReport } from "./types/ResolveCommunityReport";
 import { ResolvePostReport } from "./types/ResolvePostReport";
 import { ResolvePrivateMessageReport } from "./types/ResolvePrivateMessageReport";
 import { SaveComment } from "./types/SaveComment";
@@ -98,14 +100,12 @@ import { SaveUserSettings } from "./types/SaveUserSettings";
 import { SearchResponse } from "./types/SearchResponse";
 import { SiteResponse } from "./types/SiteResponse";
 import { TransferCommunity } from "./types/TransferCommunity";
-import { UpdateCommunityTag } from "./types/UpdateCommunityTag";
 import { VerifyEmail } from "./types/VerifyEmail";
 import { HideCommunity } from "./types/HideCommunity";
 import { GenerateTotpSecretResponse } from "./types/GenerateTotpSecretResponse";
 import { UpdateTotp } from "./types/UpdateTotp";
 import { UpdateTotpResponse } from "./types/UpdateTotpResponse";
 import { SuccessResponse } from "./types/SuccessResponse";
-import { LoginToken } from "./types/LoginToken";
 import { ListPostLikesResponse } from "./types/ListPostLikesResponse";
 import { ListCommentLikesResponse } from "./types/ListCommentLikesResponse";
 import { HidePost } from "./types/HidePost";
@@ -122,18 +122,32 @@ import { GetCommunityPendingFollowsCountResponse } from "./types/GetCommunityPen
 import { ListCommunityPendingFollowsResponse } from "./types/ListCommunityPendingFollowsResponse";
 import { ListReportsResponse } from "./types/ListReportsResponse";
 import { MyUserInfo } from "./types/MyUserInfo";
-import { UserBlockInstanceParams } from "./types/UserBlockInstanceParams";
 import { AdminAllowInstanceParams } from "./types/AdminAllowInstanceParams";
 import { AdminBlockInstanceParams } from "./types/AdminBlockInstanceParams";
 import { ListPersonContentResponse } from "./types/ListPersonContentResponse";
 import { ListPersonSavedResponse } from "./types/ListPersonSavedResponse";
 import { UploadImageResponse } from "./types/UploadImageResponse";
-import { ListInboxResponse } from "./types/ListInboxResponse";
-import { MarkPersonCommentMentionAsRead } from "./types/MarkPersonCommentMentionAsRead";
-import { MarkPersonPostMentionAsRead } from "./types/MarkPersonPostMentionAsRead";
 import { GetCommentsSlimResponse } from "./types/GetCommentsSlimResponse";
 import { Tag } from "./types/Tag";
 import { ResendVerificationEmail } from "./types/ResendVerificationEmail";
+import { ListPersonReadResponse } from "./types/ListPersonReadResponse";
+import { ListPersonHiddenResponse } from "./types/ListPersonHiddenResponse";
+import { CommunityIdQuery } from "./types/CommunityIdQuery";
+import { CreateMultiCommunity } from "./types/CreateMultiCommunity";
+import { UpdateMultiCommunity } from "./types/UpdateMultiCommunity";
+import { ListMultiCommunitiesResponse } from "./types/ListMultiCommunitiesResponse";
+import { AdminListUsersResponse } from "./types/AdminListUsersResponse";
+import { CreateOrDeleteMultiCommunityEntry } from "./types/CreateOrDeleteMultiCommunityEntry";
+import { GetMultiCommunityResponse } from "./types/GetMultiCommunityResponse";
+import { FollowMultiCommunity } from "./types/FollowMultiCommunity";
+import { ListLoginsResponse } from "./types/ListLoginsResponse";
+import { ListPersonLikedResponse } from "./types/ListPersonLikedResponse";
+import { NotePerson } from "./types/NotePerson";
+import { UserBlockInstanceCommunitiesParams } from "./types/UserBlockInstanceCommunitiesParams";
+import { UserBlockInstancePersonsParams } from "./types/UserBlockInstancePersonsParams";
+import { MarkNotificationAsRead } from "./types/MarkNotificationAsRead";
+import { ListNotificationsResponse } from "./types/ListNotificationsResponse";
+import { ModEditPost } from "./types/ModEditPost";
 type RequestOptions = Pick<RequestInit, "signal">;
 /**
  * Helps build lemmy HTTP requests.
@@ -192,7 +206,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary List login tokens for your user
      */
-    listLogins(options?: RequestOptions): Promise<LoginToken[]>;
+    listLogins(options?: RequestOptions): Promise<ListLoginsResponse>;
     /**
      * @summary Returns an error message if your auth token is invalid
      */
@@ -226,13 +240,13 @@ export declare class LemmyHttp extends Controller {
      */
     getModlog(form?: GetModlogI, options?: RequestOptions): Promise<GetModlogResponse>;
     /**
-     * @summary Search lemmy.
+     * @summary Search lemmy. If `search_term` is a url it also attempts to fetch it, just like `resolve_object`.
      */
     search(form: SearchI, options?: RequestOptions): Promise<SearchResponse>;
     /**
      * @summary Fetch a non-local / federated object.
      */
-    resolveObject(form: ResolveObjectI, options?: RequestOptions): Promise<ResolveObjectResponse>;
+    resolveObject(form: ResolveObjectI, options?: RequestOptions): Promise<SearchResponse>;
     /**
      * @summary Create a new community.
      */
@@ -297,6 +311,14 @@ export declare class LemmyHttp extends Controller {
      * @summary Get a random community.
      */
     getRandomCommunity(form: GetRandomCommunityI, options?: RequestOptions): Promise<CommunityResponse>;
+    /**
+     * @summary Create a report for a community.
+     */
+    createCommunityReport(form: CreateCommunityReport, options?: RequestOptions): Promise<CommunityReportResponse>;
+    /**
+     * @summary Resolve a report for a private message.
+     */
+    resolveCommunityReport(form: ResolveCommunityReport, options?: RequestOptions): Promise<CommunityReportResponse>;
     /**
      * @summary Create a post.
      */
@@ -309,6 +331,10 @@ export declare class LemmyHttp extends Controller {
      * @summary Edit a post.
      */
     editPost(form: EditPost, options?: RequestOptions): Promise<PostResponse>;
+    /**
+     * @summary Mods can change nsfw flag and tags for a post
+     */
+    modEditPost(form: ModEditPost, options?: RequestOptions): Promise<PostResponse>;
     /**
      * @summary Delete a post.
      */
@@ -320,7 +346,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Mark a post as read.
      */
-    markPostAsRead(form: MarkPostAsRead, options?: RequestOptions): Promise<SuccessResponse>;
+    markPostAsRead(form: MarkPostAsRead, options?: RequestOptions): Promise<PostResponse>;
     /**
      * @summary Mark multiple posts as read.
      */
@@ -382,11 +408,11 @@ export declare class LemmyHttp extends Controller {
      */
     removeComment(form: RemoveComment, options?: RequestOptions): Promise<CommentResponse>;
     /**
-     * @summary Mark a comment as read.
+     * @summary A moderator can lock a comment (IE disable replies).
      */
-    markCommentReplyAsRead(form: MarkCommentReplyAsRead, options?: RequestOptions): Promise<SuccessResponse>;
+    lockComment(form: LockComment, options?: RequestOptions): Promise<CommentResponse>;
     /**
-     * @summary Like / vote on a comment.
+     * @Summary Like / vote on a comment.
      */
     likeComment(form: CreateCommentLike, options?: RequestOptions): Promise<CommentResponse>;
     /**
@@ -466,21 +492,17 @@ export declare class LemmyHttp extends Controller {
      */
     listPersonContent(form?: ListPersonContentI, options?: RequestOptions): Promise<ListPersonContentResponse>;
     /**
-     * @summary Mark a person mention as read.
+     * @summary Make a note for a person.
      */
-    markCommentMentionAsRead(form: MarkPersonCommentMentionAsRead, options?: RequestOptions): Promise<SuccessResponse>;
-    /**
-     * @summary Mark a person post body mention as read.
-     */
-    markPostMentionAsRead(form: MarkPersonPostMentionAsRead, options?: RequestOptions): Promise<SuccessResponse>;
+    notePerson(form: NotePerson, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Ban a person from your site.
      */
     banPerson(form: BanPerson, options?: RequestOptions): Promise<BanPersonResponse>;
     /**
-     * @summary Get a list of banned users.
+     * @summary Get a list of users.
      */
-    listBannedPersons(form?: ListBannedPersonsI, options?: RequestOptions): Promise<BannedPersonsResponse>;
+    listUsers(form?: AdminListUsersI, options?: RequestOptions): Promise<AdminListUsersResponse>;
     /**
      * @summary Block a person.
      */
@@ -505,6 +527,10 @@ export declare class LemmyHttp extends Controller {
      * @summary Mark all replies as read.
      */
     markAllNotificationsAsRead(options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * @summary Mark a comment as read.
+     */
+    markNotificationAsRead(form: MarkNotificationAsRead, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Save your user settings.
      */
@@ -524,7 +550,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Get your inbox (replies, comment mentions, post mentions, and messages)
      */
-    listInbox(form: ListInboxI, options?: RequestOptions): Promise<ListInboxResponse>;
+    listNotifications(form: ListNotificationsI, options?: RequestOptions): Promise<ListNotificationsResponse>;
     /**
      * @summary Verify your email
      */
@@ -537,6 +563,18 @@ export declare class LemmyHttp extends Controller {
      * @summary List your saved content.
      */
     listPersonSaved(form: ListPersonSavedI, options?: RequestOptions): Promise<ListPersonSavedResponse>;
+    /**
+     * @summary List your read content.
+     */
+    listPersonRead(form: ListPersonReadI, options?: RequestOptions): Promise<ListPersonReadResponse>;
+    /**
+     * @summary List your hidden content.
+     */
+    listPersonHidden(form: ListPersonHiddenI, options?: RequestOptions): Promise<ListPersonHiddenResponse>;
+    /**
+     * @summary List your liked content.
+     */
+    listPersonLiked(form: ListPersonLikedI, options?: RequestOptions): Promise<ListPersonLikedResponse>;
     /**
      * @summary Add an admin to your site.
      */
@@ -610,7 +648,7 @@ export declare class LemmyHttp extends Controller {
      */
     createCommunityTag(form: CreateCommunityTag, options?: RequestOptions): Promise<Tag>;
     /**
-     * @summary Update a community post tag.
+     * @summary Edit a community post tag.
      */
     updateCommunityTag(form: UpdateCommunityTag, options?: RequestOptions): Promise<Tag>;
     /**
@@ -642,9 +680,13 @@ export declare class LemmyHttp extends Controller {
      */
     listReports(form: ListReportsI, options?: RequestOptions): Promise<ListReportsResponse>;
     /**
-     * @summary Block an instance as user.
+     * @summary Block an instance's communities as a user.
      */
-    userBlockInstance(form: UserBlockInstanceParams, options?: RequestOptions): Promise<SuccessResponse>;
+    userBlockInstanceCommunities(form: UserBlockInstanceCommunitiesParams, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * @summary Block an instance's persons as a user.
+     */
+    userBlockInstancePersons(form: UserBlockInstancePersonsParams, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Globally block an instance as admin.
      */
@@ -672,19 +714,19 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Upload new community icon.
      */
-    uploadCommunityIcon(image: UploadImage, options?: RequestOptions): Promise<UploadImageResponse>;
+    uploadCommunityIcon(query: CommunityIdQueryI, image: UploadImage, options?: RequestOptions): Promise<UploadImageResponse>;
     /**
      * @summary Delete the community icon.
      */
-    deleteCommunityIcon(options?: RequestOptions): Promise<SuccessResponse>;
+    deleteCommunityIcon(form: CommunityIdQuery, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Upload new community banner.
      */
-    uploadCommunityBanner(image: UploadImage, options?: RequestOptions): Promise<UploadImageResponse>;
+    uploadCommunityBanner(query: CommunityIdQueryI, image: UploadImage, options?: RequestOptions): Promise<UploadImageResponse>;
     /**
      * @summary Delete the community banner.
      */
-    deleteCommunityBanner(options?: RequestOptions): Promise<SuccessResponse>;
+    deleteCommunityBanner(form: CommunityIdQuery, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Upload new site icon.
      */
@@ -711,10 +753,15 @@ export declare class LemmyHttp extends Controller {
     imageHealth(options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * Mark donation dialog as shown, so it isn't displayed anymore.
-     *
-     * `HTTP.POST /user/donation_dialog_shown`
      */
-    donation_dialog_shown(options?: RequestOptions): Promise<SuccessResponse>;
+    donationDialogShown(options?: RequestOptions): Promise<SuccessResponse>;
+    createMultiCommunity(form: CreateMultiCommunity, options?: RequestOptions): Promise<GetMultiCommunityResponse>;
+    updateMultiCommunity(form: UpdateMultiCommunity, options?: RequestOptions): Promise<SuccessResponse>;
+    getMultiCommunity(form: GetMultiCommunityI, options?: RequestOptions): Promise<GetMultiCommunityResponse>;
+    createMultiCommunityEntry(form: CreateOrDeleteMultiCommunityEntry, options?: RequestOptions): Promise<SuccessResponse>;
+    deleteMultiCommunityEntry(form: CreateOrDeleteMultiCommunityEntry, options?: RequestOptions): Promise<SuccessResponse>;
+    listMultiCommunities(form: ListMultiCommunitiesI, options?: RequestOptions): Promise<ListMultiCommunitiesResponse>;
+    followMultiCommunity(form: FollowMultiCommunity, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * Set the headers (can be used to set the auth header)
      */
@@ -722,4 +769,13 @@ export declare class LemmyHttp extends Controller {
         [key: string]: string;
     }): void;
 }
+/**
+ * A Lemmy error type.
+ *
+ * The name is the i18n translatable error code.
+ * The msg is either an empty string, or extra non-translatable info.
+ */
+export declare class LemmyError extends Error {
+    constructor(name: string, msg?: string);
+}
 export {};