lemmy-js-client 0.20.0-alpha.7 → 0.20.0-ap-id.0

package/dist/types/ModlogCombinedView.d.ts

@@ -0,0 +1,52 @@
+import type { AdminAllowInstanceView } from "./AdminAllowInstanceView";
+import type { AdminBlockInstanceView } from "./AdminBlockInstanceView";
+import type { AdminPurgeCommentView } from "./AdminPurgeCommentView";
+import type { AdminPurgeCommunityView } from "./AdminPurgeCommunityView";
+import type { AdminPurgePersonView } from "./AdminPurgePersonView";
+import type { AdminPurgePostView } from "./AdminPurgePostView";
+import type { ModAddCommunityView } from "./ModAddCommunityView";
+import type { ModAddView } from "./ModAddView";
+import type { ModBanFromCommunityView } from "./ModBanFromCommunityView";
+import type { ModBanView } from "./ModBanView";
+import type { ModFeaturePostView } from "./ModFeaturePostView";
+import type { ModHideCommunityView } from "./ModHideCommunityView";
+import type { ModLockPostView } from "./ModLockPostView";
+import type { ModRemoveCommentView } from "./ModRemoveCommentView";
+import type { ModRemoveCommunityView } from "./ModRemoveCommunityView";
+import type { ModRemovePostView } from "./ModRemovePostView";
+import type { ModTransferCommunityView } from "./ModTransferCommunityView";
+export type ModlogCombinedView = ({
+    type_: "AdminAllowInstance";
+} & AdminAllowInstanceView) | ({
+    type_: "AdminBlockInstance";
+} & AdminBlockInstanceView) | ({
+    type_: "AdminPurgeComment";
+} & AdminPurgeCommentView) | ({
+    type_: "AdminPurgeCommunity";
+} & AdminPurgeCommunityView) | ({
+    type_: "AdminPurgePerson";
+} & AdminPurgePersonView) | ({
+    type_: "AdminPurgePost";
+} & AdminPurgePostView) | ({
+    type_: "ModAdd";
+} & ModAddView) | ({
+    type_: "ModAddCommunity";
+} & ModAddCommunityView) | ({
+    type_: "ModBan";
+} & ModBanView) | ({
+    type_: "ModBanFromCommunity";
+} & ModBanFromCommunityView) | ({
+    type_: "ModFeaturePost";
+} & ModFeaturePostView) | ({
+    type_: "ModHideCommunity";
+} & ModHideCommunityView) | ({
+    type_: "ModLockPost";
+} & ModLockPostView) | ({
+    type_: "ModRemoveComment";
+} & ModRemoveCommentView) | ({
+    type_: "ModRemoveCommunity";
+} & ModRemoveCommunityView) | ({
+    type_: "ModRemovePost";
+} & ModRemovePostView) | ({
+    type_: "ModTransferCommunity";
+} & ModTransferCommunityView);

package/dist/types/ModlogCombinedView.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/MyUserInfo.d.ts

@@ -5,7 +5,10 @@ import type { Instance } from "./Instance";
 import type { LanguageId } from "./LanguageId";
 import type { LocalUserView } from "./LocalUserView";
 import type { Person } from "./Person";
-export interface MyUserInfo {
+/**
+ * Your user info.
+ */
+export type MyUserInfo = {
     local_user_view: LocalUserView;
     follows: Array<CommunityFollowerView>;
     moderates: Array<CommunityModeratorView>;
@@ -13,4 +16,4 @@ export interface MyUserInfo {
     instance_blocks: Array<Instance>;
     person_blocks: Array<Person>;
     discussion_languages: Array<LanguageId>;
-}
+};

package/dist/types/OAuthAccount.d.ts

@@ -1,9 +1,12 @@
 import type { LocalUserId } from "./LocalUserId";
 import type { OAuthProviderId } from "./OAuthProviderId";
-export interface OAuthAccount {
+/**
+ * An auth account method.
+ */
+export type OAuthAccount = {
     local_user_id: LocalUserId;
     oauth_provider_id: OAuthProviderId;
     oauth_user_id: string;
     published: string;
     updated?: string;
-}
+};

package/dist/types/OAuthProvider.d.ts

@@ -1,17 +1,63 @@
 import type { OAuthProviderId } from "./OAuthProviderId";
-export interface OAuthProvider {
+/**
+ * oauth provider with client_secret - should never be sent to the client
+ */
+export type OAuthProvider = {
     id: OAuthProviderId;
+    /**
+     * The OAuth 2.0 provider name displayed to the user on the Login page
+     */
     display_name: string;
+    /**
+     * The issuer url of the OAUTH provider.
+     */
     issuer: string;
+    /**
+     * The authorization endpoint is used to interact with the resource owner and obtain an
+     * authorization grant. This is usually provided by the OAUTH provider.
+     */
     authorization_endpoint: string;
+    /**
+     * The token endpoint is used by the client to obtain an access token by presenting its
+     * authorization grant or refresh token. This is usually provided by the OAUTH provider.
+     */
     token_endpoint: string;
+    /**
+     * The UserInfo Endpoint is an OAuth 2.0 Protected Resource that returns Claims about the
+     * authenticated End-User. This is defined in the OIDC specification.
+     */
     userinfo_endpoint: string;
+    /**
+     * The OAuth 2.0 claim containing the unique user ID returned by the provider. Usually this
+     * should be set to "sub".
+     */
     id_claim: string;
+    /**
+     * The client_id is provided by the OAuth 2.0 provider and is a unique identifier to this
+     * service
+     */
     client_id: string;
+    /**
+     * Lists the scopes requested from users. Users will have to grant access to the requested scope
+     * at sign up.
+     */
     scopes: string;
+    /**
+     * Automatically sets email as verified on registration
+     */
     auto_verify_email: boolean;
+    /**
+     * Allows linking an OAUTH account to an existing user account by matching emails
+     */
     account_linking_enabled: boolean;
+    /**
+     * switch to enable or disable an oauth provider
+     */
     enabled: boolean;
     published: string;
     updated?: string;
-}
+    /**
+     * switch to enable or disable PKCE
+     */
+    use_pkce: boolean;
+};

package/dist/types/OAuthProviderId.d.ts

@@ -1 +1,4 @@
+/**
+ * The oauth provider id.
+ */
 export type OAuthProviderId = number;

package/dist/types/OpenGraphData.d.ts

@@ -1,6 +1,10 @@
-export interface OpenGraphData {
+import type { DbUrl } from "./DbUrl";
+/**
+ * Site metadata, from its opengraph tags.
+ */
+export type OpenGraphData = {
     title?: string;
     description?: string;
-    image?: string;
-    embed_video_url?: string;
-}
+    image?: DbUrl;
+    embed_video_url?: DbUrl;
+};

package/dist/types/OpenGraphData.js

@@ -1,3 +1,2 @@
 "use strict";
-// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PaginationCursor.d.ts

@@ -1 +1,7 @@
+/**
+ * currently this is just a wrapper around post id, but should be seen as opaque from the client's
+ * perspective. stringified since we might want to use arbitrary info later, with a P prepended to
+ * prevent ossification (api users love to make assumptions (e.g. parse stuff that looks like
+ * numbers as numbers) about apis that aren't part of the spec
+ */
 export type PaginationCursor = string;

package/dist/types/PasswordChangeAfterReset.d.ts

@@ -1,5 +1,9 @@
-export interface PasswordChangeAfterReset {
-    token: string;
-    password: string;
-    password_verify: string;
-}
+import type { SensitiveString } from "./SensitiveString";
+/**
+ * Change your password after receiving a reset request.
+ */
+export type PasswordChangeAfterReset = {
+    token: SensitiveString;
+    password: SensitiveString;
+    password_verify: SensitiveString;
+};

package/dist/types/PasswordChangeAfterReset.js

@@ -1,3 +1,2 @@
 "use strict";
-// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PasswordReset.d.ts

@@ -1,3 +1,7 @@
-export interface PasswordReset {
-    email: string;
-}
+import type { SensitiveString } from "./SensitiveString";
+/**
+ * Reset your password via email.
+ */
+export type PasswordReset = {
+    email: SensitiveString;
+};

package/dist/types/PasswordReset.js

@@ -1,3 +1,2 @@
 "use strict";
-// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PendingFollow.d.ts

@@ -0,0 +1,9 @@
+import type { Community } from "./Community";
+import type { Person } from "./Person";
+import type { SubscribedType } from "./SubscribedType";
+export type PendingFollow = {
+    person: Person;
+    community: Community;
+    is_new_instance: boolean;
+    subscribed: SubscribedType;
+};

package/dist/types/PendingFollow.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/Person.d.ts

@@ -1,20 +1,57 @@
+import type { DbUrl } from "./DbUrl";
 import type { InstanceId } from "./InstanceId";
 import type { PersonId } from "./PersonId";
-export interface Person {
+/**
+ * A person.
+ */
+export type Person = {
     id: PersonId;
     name: string;
+    /**
+     * A shorter display name.
+     */
     display_name?: string;
-    avatar?: string;
+    /**
+     * A URL for an avatar.
+     */
+    avatar?: DbUrl;
+    /**
+     * Whether the person is banned.
+     */
     banned: boolean;
     published: string;
     updated?: string;
-    actor_id: string;
+    /**
+     * The federated ap_id.
+     */
+    ap_id: DbUrl;
+    /**
+     * An optional bio, in markdown.
+     */
     bio?: string;
+    /**
+     * Whether the person is local to our site.
+     */
     local: boolean;
-    banner?: string;
+    /**
+     * A URL for a banner.
+     */
+    banner?: DbUrl;
+    /**
+     * Whether the person is deleted.
+     */
     deleted: boolean;
+    /**
+     * A matrix id, usually given an @person:matrix.org
+     */
     matrix_user_id?: string;
+    /**
+     * Whether the person is a bot account.
+     */
     bot_account: boolean;
+    /**
+     * When their ban, if it exists, expires, if at all.
+     */
     ban_expires?: string;
     instance_id: InstanceId;
-}
+};

package/dist/types/PersonAggregates.d.ts

@@ -1,6 +1,9 @@
 import type { PersonId } from "./PersonId";
-export interface PersonAggregates {
+/**
+ * Aggregate data for a person.
+ */
+export type PersonAggregates = {
     person_id: PersonId;
     post_count: number;
     comment_count: number;
-}
+};

package/dist/types/{PersonMention.d.ts → PersonCommentMention.d.ts}

@@ -1,10 +1,13 @@
 import type { CommentId } from "./CommentId";
+import type { PersonCommentMentionId } from "./PersonCommentMentionId";
 import type { PersonId } from "./PersonId";
-import type { PersonMentionId } from "./PersonMentionId";
-export interface PersonMention {
-    id: PersonMentionId;
+/**
+ * A person mention.
+ */
+export type PersonCommentMention = {
+    id: PersonCommentMentionId;
     recipient_id: PersonId;
     comment_id: CommentId;
     read: boolean;
     published: string;
-}
+};

package/dist/types/PersonCommentMention.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonCommentMentionId.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The person comment mention id.
+ */
+export type PersonCommentMentionId = number;

package/dist/types/PersonCommentMentionId.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/{PersonMentionView.d.ts → PersonCommentMentionView.d.ts}

@@ -2,11 +2,14 @@ import type { Comment } from "./Comment";
 import type { CommentAggregates } from "./CommentAggregates";
 import type { Community } from "./Community";
 import type { Person } from "./Person";
-import type { PersonMention } from "./PersonMention";
+import type { PersonCommentMention } from "./PersonCommentMention";
 import type { Post } from "./Post";
 import type { SubscribedType } from "./SubscribedType";
-export interface PersonMentionView {
-    person_mention: PersonMention;
+/**
+ * A person comment mention view.
+ */
+export type PersonCommentMentionView = {
+    person_comment_mention: PersonCommentMention;
     comment: Comment;
     creator: Person;
     post: Post;
@@ -21,4 +24,4 @@ export interface PersonMentionView {
     saved: boolean;
     creator_blocked: boolean;
     my_vote?: number;
-}
+};

package/dist/types/PersonCommentMentionView.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonContentCombinedPaginationCursor.d.ts

@@ -0,0 +1,4 @@
+/**
+ * like PaginationCursor but for the person_content_combined table
+ */
+export type PersonContentCombinedPaginationCursor = string;

package/dist/types/PersonContentCombinedPaginationCursor.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonContentCombinedView.d.ts

@@ -0,0 +1,7 @@
+import type { CommentView } from "./CommentView";
+import type { PostView } from "./PostView";
+export type PersonContentCombinedView = ({
+    type_: "Post";
+} & PostView) | ({
+    type_: "Comment";
+} & CommentView);

package/dist/types/PersonContentCombinedView.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonContentType.d.ts

@@ -0,0 +1,4 @@
+/**
+ * A list of possible types for a person's content.
+ */
+export type PersonContentType = "All" | "Comments" | "Posts";

package/dist/types/PersonContentType.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonId.d.ts

@@ -1 +1,4 @@
+/**
+ * The person id.
+ */
 export type PersonId = number;

package/dist/types/PersonPostMention.d.ts

@@ -0,0 +1,13 @@
+import type { PersonId } from "./PersonId";
+import type { PersonPostMentionId } from "./PersonPostMentionId";
+import type { PostId } from "./PostId";
+/**
+ * A person mention.
+ */
+export type PersonPostMention = {
+    id: PersonPostMentionId;
+    recipient_id: PersonId;
+    post_id: PostId;
+    read: boolean;
+    published: string;
+};

package/dist/types/PersonPostMention.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonPostMentionId.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The person post mention id.
+ */
+export type PersonPostMentionId = number;

package/dist/types/PersonPostMentionId.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonPostMentionView.d.ts

@@ -0,0 +1,32 @@
+import type { Community } from "./Community";
+import type { ImageDetails } from "./ImageDetails";
+import type { Person } from "./Person";
+import type { PersonPostMention } from "./PersonPostMention";
+import type { Post } from "./Post";
+import type { PostAggregates } from "./PostAggregates";
+import type { PostTags } from "./PostTags";
+import type { SubscribedType } from "./SubscribedType";
+/**
+ * A person post mention view.
+ */
+export type PersonPostMentionView = {
+    person_post_mention: PersonPostMention;
+    post: Post;
+    creator: Person;
+    community: Community;
+    image_details?: ImageDetails;
+    recipient: Person;
+    counts: PostAggregates;
+    creator_banned_from_community: boolean;
+    banned_from_community: boolean;
+    creator_is_moderator: boolean;
+    creator_is_admin: boolean;
+    subscribed: SubscribedType;
+    saved: boolean;
+    read: boolean;
+    hidden: boolean;
+    creator_blocked: boolean;
+    my_vote?: number;
+    unread_comments: number;
+    post_tags: PostTags;
+};

package/dist/types/PersonPostMentionView.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonSavedCombinedPaginationCursor.d.ts

@@ -0,0 +1,4 @@
+/**
+ * like PaginationCursor but for the person_saved_combined table
+ */
+export type PersonSavedCombinedPaginationCursor = string;

package/dist/types/PersonSavedCombinedPaginationCursor.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was generated by [ts-rs](https://github.com/Aleph-Alpha/ts-rs). Do not edit this file manually.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/PersonView.d.ts

@@ -1,7 +1,10 @@
 import type { Person } from "./Person";
 import type { PersonAggregates } from "./PersonAggregates";
-export interface PersonView {
+/**
+ * A person view.
+ */
+export type PersonView = {
     person: Person;
     counts: PersonAggregates;
     is_admin: boolean;
-}
+};

package/dist/types/Post.d.ts

@@ -1,29 +1,82 @@
 import type { CommunityId } from "./CommunityId";
+import type { DbUrl } from "./DbUrl";
 import type { LanguageId } from "./LanguageId";
 import type { PersonId } from "./PersonId";
 import type { PostId } from "./PostId";
-export interface Post {
+/**
+ * A post.
+ */
+export type Post = {
     id: PostId;
     name: string;
-    url?: string;
+    /**
+     * An optional link / url for the post.
+     */
+    url?: DbUrl;
+    /**
+     * An optional post body, in markdown.
+     */
     body?: string;
     creator_id: PersonId;
     community_id: CommunityId;
+    /**
+     * Whether the post is removed.
+     */
     removed: boolean;
+    /**
+     * Whether the post is locked.
+     */
     locked: boolean;
     published: string;
     updated?: string;
+    /**
+     * Whether the post is deleted.
+     */
     deleted: boolean;
+    /**
+     * Whether the post is NSFW.
+     */
     nsfw: boolean;
+    /**
+     * A title for the link.
+     */
     embed_title?: string;
+    /**
+     * A description for the link.
+     */
     embed_description?: string;
-    thumbnail_url?: string;
-    ap_id: string;
+    /**
+     * A thumbnail picture url.
+     */
+    thumbnail_url?: DbUrl;
+    /**
+     * The federated activity id / ap_id.
+     */
+    ap_id: DbUrl;
+    /**
+     * Whether the post is local.
+     */
     local: boolean;
-    embed_video_url?: string;
+    /**
+     * A video url for the link.
+     */
+    embed_video_url?: DbUrl;
     language_id: LanguageId;
+    /**
+     * Whether the post is featured to its community.
+     */
     featured_community: boolean;
+    /**
+     * Whether the post is featured to its site.
+     */
     featured_local: boolean;
     url_content_type?: string;
+    /**
+     * An optional alt_text, usable for image posts.
+     */
     alt_text?: string;
-}
+    /**
+     * Time at which the post will be published. None means publish immediately.
+     */
+    scheduled_publish_time?: string;
+};

package/dist/types/PostAggregates.d.ts

@@ -1,10 +1,18 @@
 import type { PostId } from "./PostId";
-export interface PostAggregates {
+/**
+ * Aggregate data for a post.
+ */
+export type PostAggregates = {
     post_id: PostId;
     comments: number;
     score: number;
     upvotes: number;
     downvotes: number;
     published: string;
+    /**
+     * The time of the newest comment in the post.
+     */
     newest_comment_time: string;
-}
+    report_count: number;
+    unresolved_report_count: number;
+};

package/dist/types/PostFeatureType.d.ts

@@ -1 +1,4 @@
+/**
+ * The feature type for a post.
+ */
 export type PostFeatureType = "Local" | "Community";

package/dist/types/PostId.d.ts

@@ -1 +1,4 @@
+/**
+ * The post id.
+ */
 export type PostId = number;

package/dist/types/PostListingMode.d.ts

@@ -1 +1,4 @@
+/**
+ * A post-view mode that changes how multiple post listings look.
+ */
 export type PostListingMode = "List" | "Card" | "SmallCard";