lemmy-js-client 1.0.0-search-and-resolve.1 → 1.0.0-search-resolve-field.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,19 +1,15 @@
 import { Controller } from "@tsoa/runtime";
-import { AdminListUsersI, CommunityIdQueryI, DeleteImageParamsI, GetCommentI, GetCommentsI, GetCommunityI, GetCommunityPendingFollowsCountI, GetModlogI, GetPersonDetailsI, GetPostI, GetPostsI, GetRandomCommunityI, GetRegistrationApplicationI, GetReportCountI, GetSiteMetadataI, ListCommentLikesI, ListCommunitiesI, ListCommunityPendingFollowsI, ListCustomEmojisI, ListInboxI, ListMediaI, ListPersonContentI, ListPersonHiddenI, ListPersonReadI, ListPersonSavedI, ListPostLikesI, ListRegistrationApplicationsI, ListReportsI, ListTaglinesI, ResolveObjectI, SearchI, UploadImage } from "./other_types";
+import { AdminListUsersI, CommunityIdQueryI, DeleteImageParamsI, GetCommentI, GetCommentsI, GetCommunityI, 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, GetFederatedInstancesI } from "./other_types";
 import { AddAdmin } from "./types/AddAdmin";
 import { AddAdminResponse } from "./types/AddAdminResponse";
 import { AddModToCommunity } from "./types/AddModToCommunity";
 import { AddModToCommunityResponse } from "./types/AddModToCommunityResponse";
 import { ApproveRegistrationApplication } from "./types/ApproveRegistrationApplication";
 import { BanFromCommunity } from "./types/BanFromCommunity";
-import { BanFromCommunityResponse } from "./types/BanFromCommunityResponse";
 import { MarkManyPostsAsRead } from "./types/MarkManyPostsAsRead";
 import { BanPerson } from "./types/BanPerson";
-import { BanPersonResponse } from "./types/BanPersonResponse";
 import { BlockCommunity } from "./types/BlockCommunity";
-import { BlockCommunityResponse } from "./types/BlockCommunityResponse";
 import { BlockPerson } from "./types/BlockPerson";
-import { BlockPersonResponse } from "./types/BlockPersonResponse";
 import { ChangePassword } from "./types/ChangePassword";
 import { CommentReportResponse } from "./types/CommentReportResponse";
 import { CommentResponse } from "./types/CommentResponse";
@@ -25,6 +21,7 @@ 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";
@@ -69,11 +66,10 @@ 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";
 import { PasswordReset } from "./types/PasswordReset";
 import { PostReportResponse } from "./types/PostReportResponse";
@@ -99,7 +95,6 @@ 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";
@@ -122,23 +117,36 @@ 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";
+import { UpdateCommunityNotifications } from "./types/UpdateCommunityNotifications";
+import { UpdatePostNotifications } from "./types/UpdatePostNotifications";
+import { MultiCommunityResponse } from "./types/MultiCommunityResponse";
+import { PersonResponse } from "./types/PersonResponse";
 type RequestOptions = Pick<RequestInit, "signal">;
 /**
  * Helps build lemmy HTTP requests.
@@ -261,7 +269,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Get a community's pending follows count.
      */
-    getCommunityPendingFollowsCount(form: GetCommunityPendingFollowsCountI, options?: RequestOptions): Promise<GetCommunityPendingFollowsCountResponse>;
+    getCommunityPendingFollowsCount(options?: RequestOptions): Promise<GetCommunityPendingFollowsCountResponse>;
     /**
      * @summary Get a community's pending followers.
      */
@@ -273,7 +281,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Block a community.
      */
-    blockCommunity(form: BlockCommunity, options?: RequestOptions): Promise<BlockCommunityResponse>;
+    blockCommunity(form: BlockCommunity, options?: RequestOptions): Promise<CommunityResponse>;
     /**
      * @summary Delete a community.
      */
@@ -293,7 +301,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Ban a user from a community.
      */
-    banFromCommunity(form: BanFromCommunity, options?: RequestOptions): Promise<BanFromCommunityResponse>;
+    banFromCommunity(form: BanFromCommunity, options?: RequestOptions): Promise<PersonResponse>;
     /**
      * @summary Add a moderator to your community.
      */
@@ -322,6 +330,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.
      */
@@ -341,7 +353,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Hide a post from list views.
      */
-    hidePost(form: HidePost, options?: RequestOptions): Promise<SuccessResponse>;
+    hidePost(form: HidePost, options?: RequestOptions): Promise<PostResponse>;
     /**
      * @summary A moderator can lock a post ( IE disable new comments ).
      */
@@ -395,11 +407,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>;
     /**
@@ -446,10 +458,6 @@ export declare class LemmyHttp extends Controller {
      * @summary Delete a private message.
      */
     deletePrivateMessage(form: DeletePrivateMessage, options?: RequestOptions): Promise<PrivateMessageResponse>;
-    /**
-     * @summary Mark a private message as read.
-     */
-    markPrivateMessageAsRead(form: MarkPrivateMessageAsRead, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Create a report for a private message.
      */
@@ -479,17 +487,13 @@ 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>;
+    banPerson(form: BanPerson, options?: RequestOptions): Promise<PersonResponse>;
     /**
      * @summary Get a list of users.
      */
@@ -497,7 +501,7 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Block a person.
      */
-    blockPerson(form: BlockPerson, options?: RequestOptions): Promise<BlockPersonResponse>;
+    blockPerson(form: BlockPerson, options?: RequestOptions): Promise<PersonResponse>;
     /**
      * @summary Fetch a Captcha.
      */
@@ -515,9 +519,13 @@ export declare class LemmyHttp extends Controller {
      */
     passwordChangeAfterReset(form: PasswordChangeAfterReset, options?: RequestOptions): Promise<SuccessResponse>;
     /**
-     * @summary Mark all replies as read.
+     * @summary Mark all notifications as read.
      */
     markAllNotificationsAsRead(options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * @summary Mark a notification as read.
+     */
+    markNotificationAsRead(form: MarkNotificationAsRead, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Save your user settings.
      */
@@ -537,7 +545,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
      */
@@ -558,6 +566,10 @@ export declare class LemmyHttp extends Controller {
      * @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.
      */
@@ -631,7 +643,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>;
     /**
@@ -657,15 +669,19 @@ export declare class LemmyHttp extends Controller {
     /**
      * @summary Fetch federated instances.
      */
-    getFederatedInstances(options?: RequestOptions): Promise<GetFederatedInstancesResponse>;
+    getFederatedInstances(form: GetFederatedInstancesI, options?: RequestOptions): Promise<GetFederatedInstancesResponse>;
     /**
      * @summary List user reports.
      */
     listReports(form: ListReportsI, options?: RequestOptions): Promise<ListReportsResponse>;
     /**
-     * @summary Block an instance as user.
+     * @summary Block an instance's communities as a user.
+     */
+    userBlockInstanceCommunities(form: UserBlockInstanceCommunitiesParams, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * @summary Block an instance's persons as a user.
      */
-    userBlockInstance(form: UserBlockInstanceParams, options?: RequestOptions): Promise<SuccessResponse>;
+    userBlockInstancePersons(form: UserBlockInstancePersonsParams, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * @summary Globally block an instance as admin.
      */
@@ -732,10 +748,23 @@ 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<MultiCommunityResponse>;
+    updateMultiCommunity(form: UpdateMultiCommunity, options?: RequestOptions): Promise<MultiCommunityResponse>;
+    getMultiCommunity(form: GetMultiCommunityI, options?: RequestOptions): Promise<GetMultiCommunityResponse>;
+    createMultiCommunityEntry(form: CreateOrDeleteMultiCommunityEntry, options?: RequestOptions): Promise<CommunityResponse>;
+    deleteMultiCommunityEntry(form: CreateOrDeleteMultiCommunityEntry, options?: RequestOptions): Promise<SuccessResponse>;
+    listMultiCommunities(form: ListMultiCommunitiesI, options?: RequestOptions): Promise<ListMultiCommunitiesResponse>;
+    followMultiCommunity(form: FollowMultiCommunity, options?: RequestOptions): Promise<MultiCommunityResponse>;
+    /**
+     * @summary Change notification settings for a community
+     */
+    updateCommunityNotifications(form: UpdateCommunityNotifications, options?: RequestOptions): Promise<SuccessResponse>;
+    /**
+     * @summary Change notification settings for a post
+     */
+    updatePostNotifications(form: UpdatePostNotifications, options?: RequestOptions): Promise<SuccessResponse>;
     /**
      * Set the headers (can be used to set the auth header)
      */
@@ -743,4 +772,14 @@ 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 {
+    status: number;
+    constructor(name: string, status: number, msg?: string);
+}
 export {};