lemmy-js-client 0.20.0-alpha.17 → 0.20.0-alpha.18

package/dist/types/SaveUserSettings.d.ts

@@ -3,34 +3,117 @@ import type { LanguageId } from "./LanguageId";
 import type { ListingType } from "./ListingType";
 import type { PostListingMode } from "./PostListingMode";
 import type { PostSortType } from "./PostSortType";
-export interface SaveUserSettings {
+import type { SensitiveString } from "./SensitiveString";
+/**
+ * Saves settings for your user.
+ */
+export type SaveUserSettings = {
+    /**
+     * Show nsfw posts.
+     */
     show_nsfw?: boolean;
+    /**
+     * Blur nsfw posts.
+     */
     blur_nsfw?: boolean;
+    /**
+     * Your user's theme.
+     */
     theme?: string;
+    /**
+     * The default post listing type, usually "local"
+     */
     default_listing_type?: ListingType;
+    /**
+     * A post-view mode that changes how multiple post listings look.
+     */
     post_listing_mode?: PostListingMode;
+    /**
+     * The default post sort, usually "active"
+     */
     default_post_sort_type?: PostSortType;
+    /**
+     * The default comment sort, usually "hot"
+     */
     default_comment_sort_type?: CommentSortType;
+    /**
+     * The language of the lemmy interface
+     */
     interface_language?: string;
+    /**
+     * A URL for your avatar.
+     */
     avatar?: string;
+    /**
+     * A URL for your banner.
+     */
     banner?: string;
+    /**
+     * Your display name, which can contain strange characters, and does not need to be unique.
+     */
     display_name?: string;
-    email?: string;
+    /**
+     * Your email.
+     */
+    email?: SensitiveString;
+    /**
+     * Your bio / info, in markdown.
+     */
     bio?: string;
+    /**
+     * Your matrix user id. Ex: @my_user:matrix.org
+     */
     matrix_user_id?: string;
+    /**
+     * Whether to show or hide avatars.
+     */
     show_avatars?: boolean;
+    /**
+     * Sends notifications to your email.
+     */
     send_notifications_to_email?: boolean;
+    /**
+     * Whether this account is a bot account. Users can hide these accounts easily if they wish.
+     */
     bot_account?: boolean;
+    /**
+     * Whether to show bot accounts.
+     */
     show_bot_accounts?: boolean;
+    /**
+     * Whether to show read posts.
+     */
     show_read_posts?: boolean;
+    /**
+     * A list of languages you are able to see discussion in.
+     */
     discussion_languages?: Array<LanguageId>;
+    /**
+     * Open links in a new tab
+     */
     open_links_in_new_tab?: boolean;
+    /**
+     * Enable infinite scroll
+     */
     infinite_scroll_enabled?: boolean;
+    /**
+     * Whether to allow keyboard navigation (for browsing and interacting with posts and comments).
+     */
     enable_keyboard_navigation?: boolean;
+    /**
+     * Whether user avatars or inline images in the UI that are gifs should be allowed to play or
+     * should be paused
+     */
     enable_animated_images?: boolean;
+    /**
+     * Whether to auto-collapse bot comments.
+     */
     collapse_bot_comments?: boolean;
+    /**
+     * Some vote display mode settings
+     */
     show_scores?: boolean;
     show_upvotes?: boolean;
     show_downvotes?: boolean;
     show_upvote_percentage?: boolean;
-}
+};

package/dist/types/Search.d.ts

@@ -3,7 +3,10 @@ import type { ListingType } from "./ListingType";
 import type { PersonId } from "./PersonId";
 import type { PostSortType } from "./PostSortType";
 import type { SearchType } from "./SearchType";
-export interface Search {
+/**
+ * Searches the site, given a query string, and some optional filters.
+ */
+export type Search = {
     q: string;
     community_id?: CommunityId;
     community_name?: string;
@@ -18,4 +21,4 @@ export interface Search {
     saved_only?: boolean;
     liked_only?: boolean;
     disliked_only?: boolean;
-}
+};

package/dist/types/SearchResponse.d.ts

@@ -3,10 +3,13 @@ import type { CommunityView } from "./CommunityView";
 import type { PersonView } from "./PersonView";
 import type { PostView } from "./PostView";
 import type { SearchType } from "./SearchType";
-export interface SearchResponse {
+/**
+ * The search response, containing lists of the return type possibilities
+ */
+export type SearchResponse = {
     type_: SearchType;
     comments: Array<CommentView>;
     posts: Array<PostView>;
     communities: Array<CommunityView>;
     users: Array<PersonView>;
-}
+};

package/dist/types/SearchType.d.ts

@@ -1 +1,4 @@
+/**
+ * The type of content returned from a search.
+ */
 export type SearchType = "All" | "Comments" | "Posts" | "Communities" | "Users";

package/dist/types/SensitiveString.d.ts

@@ -0,0 +1 @@
+export type SensitiveString = string;

package/dist/types/SensitiveString.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/Site.d.ts

@@ -1,18 +1,47 @@
+import type { DbUrl } from "./DbUrl";
 import type { InstanceId } from "./InstanceId";
 import type { SiteId } from "./SiteId";
-export interface Site {
+/**
+ * The site.
+ */
+export type Site = {
     id: SiteId;
     name: string;
+    /**
+     * A sidebar for the site in markdown.
+     */
     sidebar?: string;
     published: string;
     updated?: string;
-    icon?: string;
-    banner?: string;
+    /**
+     * An icon URL.
+     */
+    icon?: DbUrl;
+    /**
+     * A banner url.
+     */
+    banner?: DbUrl;
+    /**
+     * A shorter, one-line description of the site.
+     */
     description?: string;
-    actor_id: string;
+    /**
+     * The federated actor_id.
+     */
+    actor_id: DbUrl;
+    /**
+     * The time the site was last refreshed.
+     */
     last_refreshed_at: string;
-    inbox_url: string;
+    /**
+     * The site inbox
+     */
+    inbox_url: DbUrl;
     public_key: string;
     instance_id: InstanceId;
+    /**
+     * If present, nsfw content is visible by default. Should be displayed by frontends/clients
+     * when the site is first opened by a user.
+     */
     content_warning?: string;
-}
+};

package/dist/types/SiteAggregates.d.ts

@@ -1,12 +1,27 @@
 import type { SiteId } from "./SiteId";
-export interface SiteAggregates {
+/**
+ * Aggregate data for a site.
+ */
+export type SiteAggregates = {
     site_id: SiteId;
     users: number;
     posts: number;
     comments: number;
     communities: number;
+    /**
+     * The number of users with any activity in the last day.
+     */
     users_active_day: number;
+    /**
+     * The number of users with any activity in the last week.
+     */
     users_active_week: number;
+    /**
+     * The number of users with any activity in the last month.
+     */
     users_active_month: number;
+    /**
+     * The number of users with any activity in the last half year.
+     */
     users_active_half_year: number;
-}
+};

package/dist/types/SiteId.d.ts

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

package/dist/types/SiteResponse.d.ts

@@ -1,4 +1,11 @@
 import type { SiteView } from "./SiteView";
-export interface SiteResponse {
+/**
+ * The response for a site.
+ */
+export type SiteResponse = {
     site_view: SiteView;
-}
+    /**
+     * deprecated, use field `tagline` or /api/v3/tagline/list
+     */
+    taglines: Array<null>;
+};

package/dist/types/SiteView.d.ts

@@ -2,9 +2,12 @@ import type { LocalSite } from "./LocalSite";
 import type { LocalSiteRateLimit } from "./LocalSiteRateLimit";
 import type { Site } from "./Site";
 import type { SiteAggregates } from "./SiteAggregates";
-export interface SiteView {
+/**
+ * A site view.
+ */
+export type SiteView = {
     site: Site;
     local_site: LocalSite;
     local_site_rate_limit: LocalSiteRateLimit;
     counts: SiteAggregates;
-}
+};

package/dist/types/SubscribedType.d.ts

@@ -1 +1,4 @@
-export type SubscribedType = "Subscribed" | "NotSubscribed" | "Pending";
+/**
+ * A type / status for a community subscribe.
+ */
+export type SubscribedType = "Subscribed" | "NotSubscribed" | "Pending" | "ApprovalRequired";

package/dist/types/SuccessResponse.d.ts

@@ -1,3 +1,6 @@
-export interface SuccessResponse {
+/**
+ * Saves settings for your user.
+ */
+export type SuccessResponse = {
     success: boolean;
-}
+};

package/dist/types/Tagline.d.ts

@@ -1,6 +1,9 @@
-export interface Tagline {
+/**
+ * A tagline, shown at the top of your site.
+ */
+export type Tagline = {
     id: number;
     content: string;
     published: string;
     updated?: string;
-}
+};

package/dist/types/TaglineId.d.ts

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

package/dist/types/TaglineResponse.d.ts

@@ -1,4 +1,4 @@
 import type { Tagline } from "./Tagline";
-export interface TaglineResponse {
+export type TaglineResponse = {
     tagline: Tagline;
-}
+};

package/dist/types/TransferCommunity.d.ts

@@ -1,6 +1,9 @@
 import type { CommunityId } from "./CommunityId";
 import type { PersonId } from "./PersonId";
-export interface TransferCommunity {
+/**
+ * Transfer a community to a new owner.
+ */
+export type TransferCommunity = {
     community_id: CommunityId;
     person_id: PersonId;
-}
+};

package/dist/types/UpdateTagline.d.ts

@@ -1,5 +1,8 @@
 import type { TaglineId } from "./TaglineId";
-export interface UpdateTagline {
+/**
+ * Update a tagline
+ */
+export type UpdateTagline = {
     id: TaglineId;
     content: string;
-}
+};

package/dist/types/UpdateTotp.d.ts

@@ -1,4 +1,4 @@
-export interface UpdateTotp {
+export type UpdateTotp = {
     totp_token: string;
     enabled: boolean;
-}
+};

package/dist/types/UpdateTotpResponse.d.ts

@@ -1,3 +1,3 @@
-export interface UpdateTotpResponse {
+export type UpdateTotpResponse = {
     enabled: boolean;
-}
+};

package/dist/types/VerifyEmail.d.ts

@@ -1,3 +1,6 @@
-export interface VerifyEmail {
+/**
+ * Verify your email.
+ */
+export type VerifyEmail = {
     token: string;
-}
+};

package/dist/types/VoteView.d.ts

@@ -1,6 +1,9 @@
 import type { Person } from "./Person";
-export interface VoteView {
+/**
+ * A vote view for checking a post or comments votes.
+ */
+export type VoteView = {
     creator: Person;
     creator_banned_from_community: boolean;
     score: number;
-}
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "lemmy-js-client",
   "description": "A javascript / typescript client for Lemmy",
-  "version": "0.20.0-alpha.17",
+  "version": "0.20.0-alpha.18",
   "author": "Dessalines <tyhou13@gmx.com>",
   "license": "AGPL-3.0",
   "main": "./dist/index.js",
@@ -19,7 +19,7 @@
     "url": "git+https://github.com/LemmyNet/lemmy-js-client.git"
   },
   "devDependencies": {
-    "@types/node": "^22.7.3",
+    "@types/node": "^22.7.4",
     "@typescript-eslint/eslint-plugin": "^8.7.0",
     "@typescript-eslint/parser": "^8.7.0",
     "eslint": "^9.11.1",
@@ -35,7 +35,7 @@
     "typescript": "^5.5.4",
     "typescript-eslint": "^8.7.0"
   },
-  "packageManager": "pnpm@9.11.0",
+  "packageManager": "pnpm@9.12.3",
   "types": "./dist/index.d.ts",
   "lint-staged": {
     "*.{ts,tsx,js}": [