artalk 2.7.3 → 2.8.0

package/dist/main.d.ts

@@ -1,9 +1,5 @@
 import { marked } from 'marked';
 
-declare type AC = {
-    [K in keyof TC]: InstanceType<TC[K]>;
-};
-
 /**
  * 通用操作按钮
  */
@@ -55,49 +51,989 @@ declare interface ActionBtnOptions {
     confirmText?: string;
 }
 
-/**
- * 管理员 API
- */
-declare class AdminApi extends ApiBase {
-    /** 缓存清除 */
-    cacheFlushAll(): Promise<unknown>;
-    /** 缓存预热 */
-    cacheWarmUp(): Promise<unknown>;
-}
-
-declare class Api {
+declare class Api extends Api_2<void> {
+    private _opts;
     constructor(opts: ApiOptions);
-}
-
-declare interface Api extends AC {
-}
-
-declare abstract class ApiBase {
-    protected options: ApiOptions;
-    constructor(options: ApiOptions);
-    protected POST<T>(path: string, data?: {
-        [key: string]: any;
-    }): Promise<T>;
-    protected Fetch(path: string, init: RequestInit, timeout?: number): Promise<any>;
     /**
-     * Carry user info to request params
+     * Get user info as params for request
      *
-     * @param params Request params
      * @returns Request params with user info
      */
-    protected withUserInfo(params: any): any;
-}
-
-declare const ApiComponents: {
-    comment: typeof CommentApi;
-    page: typeof PageApi;
-    site: typeof SiteApi;
-    user: typeof UserApi;
-    system: typeof SystemApi;
-    captcha: typeof CaptchaApi;
-    admin: typeof AdminApi;
-    upload: typeof UploadApi;
-};
+    getUserFields(): {
+        name: string;
+        email: string;
+    } | undefined;
+}
+
+/**
+ * @title Artalk API
+ * @version 2.0
+ * @license MIT (https://github.com/ArtalkJS/Artalk/blob/master/LICENSE)
+ * @baseUrl /api/v2
+ * @contact API Support <artalkjs@gmail.com> (https://artalk.js.org)
+ *
+ * Artalk is a modern comment system based on Golang.
+ */
+declare class Api_2<SecurityDataType extends unknown> extends HttpClient<SecurityDataType> {
+    cache: {
+        /**
+         * @description Flush all cache on the server
+         *
+         * @tags Cache
+         * @name FlushCache
+         * @summary Flush Cache
+         * @request POST:/cache/flush
+         * @secure
+         * @response `200` `(HandlerMap & {
+         msg?: string,
+
+         })` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         */
+        flushCache: (params?: RequestParams) => Promise<HttpResponse<HandlerMap & {
+            msg?: string | undefined;
+        }, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Cache warming helps you to pre-load the cache to improve the performance of the first request
+         *
+         * @tags Cache
+         * @name WarmUpCache
+         * @summary Warm-Up Cache
+         * @request POST:/cache/warm_up
+         * @secure
+         * @response `200` `(HandlerMap & {
+         msg?: string,
+
+         })` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         */
+        warmUpCache: (params?: RequestParams) => Promise<HttpResponse<HandlerMap & {
+            msg?: string | undefined;
+        }, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    captcha: {
+        /**
+         * @description Get a base64 encoded captcha image or a HTML page to verify for user
+         *
+         * @tags Captcha
+         * @name GetCaptcha
+         * @summary Get Captcha
+         * @request GET:/captcha
+         * @response `200` `HandlerResponseCaptchaGet` OK
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        getCaptcha: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseCaptchaGet, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Get the status of the user's captcha verification
+         *
+         * @tags Captcha
+         * @name GetCaptchaStatus
+         * @summary Get Captcha Status
+         * @request GET:/captcha/status
+         * @response `200` `HandlerResponseCaptchaStatus` OK
+         */
+        getCaptchaStatus: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseCaptchaStatus, any>>;
+        /**
+         * @description Verify user enters correct captcha code
+         *
+         * @tags Captcha
+         * @name VerifyCaptcha
+         * @summary Verify Captcha
+         * @request POST:/captcha/verify
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         img_data?: string,
+
+         })` Forbidden
+         */
+        verifyCaptcha: (data: HandlerParamsCaptchaVerify, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            img_data?: string | undefined;
+        }>>;
+    };
+    comments: {
+        /**
+         * @description Get a list of comments by some conditions
+         *
+         * @tags Comment
+         * @name GetComments
+         * @summary Get Comment List
+         * @request GET:/comments
+         * @secure
+         * @response `200` `HandlerResponseCommentList` OK
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        getComments: (query: {
+            /** The user email */
+            email?: string;
+            /** Enable flat_mode */
+            flat_mode?: boolean;
+            /** The limit for pagination */
+            limit?: number;
+            /** The username */
+            name?: string;
+            /** The offset for pagination */
+            offset?: number;
+            /** The comment page_key */
+            page_key: string;
+            /** The scope of comments */
+            scope?: 'page' | 'user' | 'site';
+            /** Search keywords */
+            search?: string;
+            /** The site name of your content scope */
+            site_name?: string;
+            /** Sort by condition */
+            sort_by?: 'date_asc' | 'date_desc' | 'vote';
+            /** Message center show type */
+            type?: 'all' | 'mentions' | 'mine' | 'pending';
+            /** Only show comments by admin */
+            view_only_admin?: boolean;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseCommentList, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Create a new comment
+         *
+         * @tags Comment
+         * @name CreateComment
+         * @summary Create Comment
+         * @request POST:/comments
+         * @secure
+         * @response `200` `HandlerResponseCommentCreate` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        createComment: (comment: HandlerParamsCommentCreate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseCommentCreate, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Update a specific comment
+         *
+         * @tags Comment
+         * @name UpdateComment
+         * @summary Update Comment
+         * @request PUT:/comments/{id}
+         * @secure
+         * @response `200` `HandlerResponseCommentUpdate` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        updateComment: (id: number, comment: HandlerParamsCommentUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseCommentUpdate, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Delete a specific comment
+         *
+         * @tags Comment
+         * @name DeleteComment
+         * @summary Delete Comment
+         * @request DELETE:/comments/{id}
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        deleteComment: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    conf: {
+        /**
+         * @description Get System Configs for UI
+         *
+         * @tags System
+         * @name Conf
+         * @summary Get System Configs
+         * @request GET:/conf
+         * @response `200` `CommonConfData` OK
+         */
+        conf: (params?: RequestParams) => Promise<HttpResponse<CommonConfData, any>>;
+    };
+    notifies: {
+        /**
+         * @description Get a list of notifies for user
+         *
+         * @tags Notify
+         * @name GetNotifies
+         * @summary Get Notifies
+         * @request GET:/notifies
+         * @response `200` `HandlerResponseNotifyList` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        getNotifies: (query: {
+            /** The user email */
+            email: string;
+            /** The user name */
+            name: string;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseNotifyList, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Mark all notifies as read for user
+         *
+         * @tags Notify
+         * @name MarkAllNotifyRead
+         * @summary Mark All Notifies as Read
+         * @request POST:/notifies/read
+         * @response `200` `HandlerMap` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        markAllNotifyRead: (options: HandlerParamsNotifyReadAll, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Mark specific notification as read for user
+         *
+         * @tags Notify
+         * @name MarkNotifyRead
+         * @summary Mark Notify as Read
+         * @request POST:/notifies/{comment_id}/{notify_key}
+         * @response `200` `HandlerMap` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        markNotifyRead: (commentId: number, notifyKey: string, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    pages: {
+        /**
+         * @description Get a list of pages by some conditions
+         *
+         * @tags Page
+         * @name GetPages
+         * @summary Get Page List
+         * @request GET:/pages
+         * @secure
+         * @response `200` `HandlerResponsePageList` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         */
+        getPages: (query?: {
+            /** The limit for pagination */
+            limit?: number;
+            /** The offset for pagination */
+            offset?: number;
+            /** The site name of your content scope */
+            site_name?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponsePageList, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Fetch the data of all pages
+         *
+         * @tags Page
+         * @name FetchAllPages
+         * @summary Fetch All Pages Data
+         * @request POST:/pages/fetch
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        fetchAllPages: (options: HandlerParamsPageFetchAll, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Get the status of the task of fetching all pages
+         *
+         * @tags Page
+         * @name GetPageFetchStatus
+         * @summary Get Pages Fetch Status
+         * @request GET:/pages/fetch/status
+         * @secure
+         * @response `200` `HandlerResponsePageFetchStatus` OK
+         */
+        getPageFetchStatus: (params?: RequestParams) => Promise<HttpResponse<HandlerResponsePageFetchStatus, any>>;
+        /**
+         * @description Increase and get the number of page views
+         *
+         * @tags Page
+         * @name LogPv
+         * @summary Increase Page Views (PV)
+         * @request POST:/pages/pv
+         * @response `200` `HandlerResponsePagePV` OK
+         */
+        logPv: (page: HandlerParamsPagePV, params?: RequestParams) => Promise<HttpResponse<HandlerResponsePagePV, any>>;
+        /**
+         * @description Update a specific page
+         *
+         * @tags Page
+         * @name UpdatePage
+         * @summary Update Page
+         * @request PUT:/pages/{id}
+         * @secure
+         * @response `200` `HandlerResponsePageUpdate` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        updatePage: (id: number, page: HandlerParamsPageUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponsePageUpdate, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Delete a specific page
+         *
+         * @tags Page
+         * @name DeletePage
+         * @summary Delete Page
+         * @request DELETE:/pages/{id}
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        deletePage: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Fetch the data of a specific page
+         *
+         * @tags Page
+         * @name FetchPage
+         * @summary Fetch Page Data
+         * @request POST:/pages/{id}/fetch
+         * @secure
+         * @response `200` `HandlerResponsePageFetch` OK
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        fetchPage: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerResponsePageFetch, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    sendEmail: {
+        /**
+         * @description Send an email to test the email sender
+         *
+         * @tags System
+         * @name SendEmail
+         * @summary Send Email
+         * @request POST:/send_email
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `500` `HandlerMap` Internal Server Error
+         */
+        sendEmail: (email: HandlerParamsEmailSend, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap | (HandlerMap & {
+            msg?: string | undefined;
+        })>>;
+    };
+    settings: {
+        /**
+         * @description Get settings from app config file
+         *
+         * @tags System
+         * @name GetSettings
+         * @summary Get Settings
+         * @request GET:/settings
+         * @secure
+         * @response `200` `HandlerResponseSettingGet` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        getSettings: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseSettingGet, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Apply settings and restart the server
+         *
+         * @tags System
+         * @name ApplySettings
+         * @summary Save and apply Settings
+         * @request PUT:/settings
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        applySettings: (settings: HandlerParamsSettingApply, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Get config templates in different languages for rendering the settings page in the frontend
+         *
+         * @tags System
+         * @name GetSettingsTemplate
+         * @summary Get Settings Template
+         * @request GET:/settings/template/{locale}
+         * @secure
+         * @response `200` `HandlerResponseSettingTemplate` OK
+         */
+        getSettingsTemplate: (locale: string, params?: RequestParams) => Promise<HttpResponse<HandlerResponseSettingTemplate, any>>;
+    };
+    sites: {
+        /**
+         * @description Get a list of sites by some conditions
+         *
+         * @tags Site
+         * @name GetSites
+         * @summary Get Site List
+         * @request GET:/sites
+         * @secure
+         * @response `200` `HandlerResponseSiteList` OK
+         */
+        getSites: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseSiteList, any>>;
+        /**
+         * @description Create a new site
+         *
+         * @tags Site
+         * @name CreateSite
+         * @summary Create Site
+         * @request POST:/sites
+         * @secure
+         * @response `200` `HandlerResponseSiteCreate` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        createSite: (site: HandlerParamsSiteCreate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseSiteCreate, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Update a specific site
+         *
+         * @tags Site
+         * @name UpdateSite
+         * @summary Update Site
+         * @request PUT:/sites/{id}
+         * @secure
+         * @response `200` `HandlerResponseSiteUpdate` OK
+         */
+        updateSite: (id: number, site: HandlerParamsSiteUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseSiteUpdate, any>>;
+        /**
+         * @description Delete a specific site
+         *
+         * @tags Site
+         * @name DeleteSite
+         * @summary Site Delete
+         * @request DELETE:/sites/{id}
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        deleteSite: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    stats: {
+        /**
+         * @description Get the statistics of various data analysis
+         *
+         * @tags Statistic
+         * @name GetStats
+         * @summary Statistic
+         * @request GET:/stats/{type}
+         * @response `200` `CommonJSONResult` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        getStats: (type: 'latest_comments' | 'latest_pages' | 'pv_most_pages' | 'comment_most_pages' | 'page_pv' | 'site_pv' | 'page_comment' | 'site_comment' | 'rand_comments' | 'rand_pages', query?: {
+            /** The limit for pagination */
+            limit?: number;
+            /** multiple page keys separated by commas */
+            page_keys?: string;
+            /** The site name of your content scope */
+            site_name?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<CommonJSONResult, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    transfer: {
+        /**
+         * @description Export data from Artalk
+         *
+         * @tags Transfer
+         * @name ExportArtrans
+         * @summary Export Artrans
+         * @request GET:/transfer/export
+         * @secure
+         * @response `200` `HandlerResponseTransferExport` OK
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        exportArtrans: (params?: RequestParams) => Promise<HttpResponse<HandlerResponseTransferExport, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Import data to Artalk
+         *
+         * @tags Transfer
+         * @name ImportArtrans
+         * @summary Import Artrans
+         * @request POST:/transfer/import
+         * @secure
+         * @response `200` `string` OK
+         */
+        importArtrans: (data: HandlerParamsTransferImport, params?: RequestParams) => Promise<HttpResponse<string, any>>;
+        /**
+         * @description Upload a file to prepare to import
+         *
+         * @tags Transfer
+         * @name UploadArtrans
+         * @summary Upload Artrans
+         * @request POST:/transfer/upload
+         * @secure
+         * @response `200` `(HandlerResponseTransferUpload & {
+         filename?: string,
+
+         })` OK
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        uploadArtrans: (data: {
+            /**
+             * Upload file in preparation for import task
+             * @format binary
+             */
+            file: File;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseTransferUpload & {
+            filename?: string | undefined;
+        }, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    upload: {
+        /**
+         * @description Upload file from this endpoint
+         *
+         * @tags Upload
+         * @name Upload
+         * @summary Upload
+         * @request POST:/upload
+         * @secure
+         * @response `200` `HandlerResponseUpload` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        upload: (data: {
+            /**
+             * Upload file
+             * @format binary
+             */
+            file: File;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUpload, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    user: {
+        /**
+         * @description Get user info to prepare for login or check current user status
+         *
+         * @tags Account
+         * @name GetUser
+         * @summary Get User Info
+         * @request GET:/user
+         * @secure
+         * @response `200` `HandlerResponseUserInfo` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         */
+        getUser: (query?: {
+            /** The user email */
+            email?: string;
+            /** The username */
+            name?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserInfo, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Login user by name or email
+         *
+         * @tags Account
+         * @name Login
+         * @summary Get Access Token
+         * @request POST:/user/access_token
+         * @response `200` `HandlerResponseUserLogin` OK
+         * @response `400` `(HandlerMap & {
+         " data"?: {
+         need_name_select?: (string)[],
+
+         },
+         msg?: string,
+
+         })` Multiple users with the same email address are matched
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        login: (user: HandlerParamsUserLogin, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserLogin, (HandlerMap & {
+            ' data'?: {
+                need_name_select?: string[] | undefined;
+            } | undefined;
+            msg?: string | undefined;
+        }) | (HandlerMap & {
+            msg?: string | undefined;
+        })>>;
+        /**
+         * @description Get user login status by header Authorization
+         *
+         * @tags Account
+         * @name GetUserStatus
+         * @summary Get Login Status
+         * @request GET:/user/status
+         * @secure
+         * @response `200` `HandlerResponseUserStatus` OK
+         */
+        getUserStatus: (query?: {
+            /** The user email */
+            email?: string;
+            /** The username */
+            name?: string;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserStatus, any>>;
+    };
+    users: {
+        /**
+         * @description Create a new user
+         *
+         * @tags User
+         * @name CreateUser
+         * @summary Create User
+         * @request POST:/users
+         * @secure
+         * @response `200` `HandlerResponseUserCreate` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        createUser: (user: HandlerParamsUserCreate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserCreate, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Update a specific user
+         *
+         * @tags User
+         * @name UpdateUser
+         * @summary Update User
+         * @request PUT:/users/{id}
+         * @secure
+         * @response `200` `HandlerResponseUserUpdate` OK
+         * @response `400` `(HandlerMap & {
+         msg?: string,
+
+         })` Bad Request
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        updateUser: (id: number, user: HandlerParamsUserUpdate, params?: RequestParams) => Promise<HttpResponse<HandlerResponseUserUpdate, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Delete a specific user
+         *
+         * @tags User
+         * @name DeleteUser
+         * @summary Delete User
+         * @request DELETE:/users/{id}
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        deleteUser: (id: number, params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Get a list of users by some conditions
+         *
+         * @tags User
+         * @name GetUsers
+         * @summary Get User List
+         * @request GET:/users/{type}
+         * @secure
+         * @response `200` `HandlerResponseAdminUserList` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         */
+        getUsers: (type?: 'all' | 'admin' | 'in_conf', query?: {
+            /** The limit for pagination */
+            limit?: number;
+            /** The offset for pagination */
+            offset?: number;
+        }, params?: RequestParams) => Promise<HttpResponse<HandlerResponseAdminUserList, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+    version: {
+        /**
+         * @description Get the version of Artalk
+         *
+         * @tags System
+         * @name GetVersion
+         * @summary Get Version Info
+         * @request GET:/version
+         * @response `200` `CommonApiVersionData` OK
+         */
+        getVersion: (params?: RequestParams) => Promise<HttpResponse<CommonApiVersionData, any>>;
+    };
+    votes: {
+        /**
+         * @description Sync the number of votes in the `comments` or `pages` data tables to keep them the same as the `votes` table
+         *
+         * @tags Vote
+         * @name SyncVotes
+         * @summary Sync Vote Data
+         * @request POST:/votes/sync
+         * @secure
+         * @response `200` `HandlerMap` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         */
+        syncVotes: (params?: RequestParams) => Promise<HttpResponse<HandlerMap, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+        /**
+         * @description Vote for a specific comment or page
+         *
+         * @tags Vote
+         * @name Vote
+         * @summary Vote
+         * @request POST:/votes/{type}/{target_id}
+         * @response `200` `HandlerResponseVote` OK
+         * @response `403` `(HandlerMap & {
+         msg?: string,
+
+         })` Forbidden
+         * @response `404` `(HandlerMap & {
+         msg?: string,
+
+         })` Not Found
+         * @response `500` `(HandlerMap & {
+         msg?: string,
+
+         })` Internal Server Error
+         */
+        vote: (type: 'comment_up' | 'comment_down' | 'page_up' | 'page_down', targetId: number, vote: HandlerParamsVote, params?: RequestParams) => Promise<HttpResponse<HandlerResponseVote, HandlerMap & {
+            msg?: string | undefined;
+        }>>;
+    };
+}
+
+declare interface ApiConfig<SecurityDataType = unknown> {
+    baseUrl?: string;
+    baseApiParams?: Omit<RequestParams, 'baseUrl' | 'cancelToken' | 'signal'>;
+    securityWorker?: (securityData: SecurityDataType | null) => Promise<RequestParams | void> | RequestParams | void;
+    customFetch?: typeof fetch;
+}
 
 declare interface ApiOptions {
     baseURL: string;
@@ -105,23 +1041,18 @@ declare interface ApiOptions {
     pageKey: string;
     pageTitle: string;
     timeout?: number;
-    apiToken?: string;
+    getApiToken?: () => string | undefined;
     userInfo?: {
         name: string;
         email: string;
     };
     onNeedCheckCaptcha?: (payload: {
-        recall: () => void;
-        reject: () => void;
         data: {
-            imgData: string;
-            iframe: string;
+            imgData?: string;
+            iframe?: string;
         };
-    }) => void;
-    onNeedCheckAdmin?: (payload: {
-        recall: () => void;
-        reject: () => void;
-    }) => void;
+    }) => Promise<void>;
+    onNeedCheckAdmin?: (payload: {}) => Promise<void>;
 }
 
 export declare interface ApiVersionData {
@@ -133,12 +1064,6 @@ export declare interface ApiVersionData {
     commit_hash: string;
 }
 
-declare interface ApiVersionInfo {
-    app: string;
-    version: string;
-    commit_hash: string;
-}
-
 /**
  * Artalk
  *
@@ -272,6 +1197,7 @@ export declare interface ArtalkConfig {
     listUnreadHighlight?: boolean;
     scrollRelativeTo?: () => HTMLElement;
     immediateFetch?: boolean;
+    pvAdd?: boolean;
 }
 
 export declare type ArtalkPlugin = (ctx: ContextApi) => void;
@@ -296,6 +1222,8 @@ declare namespace ArtalkType {
         ListLastFetchData,
         DataManagerApi,
         NotifyLevel,
+        UserInfoApiResponseData,
+        FetchError,
         ContextApi,
         EditorState,
         EditorApi,
@@ -306,27 +1234,15 @@ declare namespace ArtalkType {
 }
 export { ArtalkType }
 
-/**
- * 验证码 API
- */
-declare class CaptchaApi extends ApiBase {
-    /** 验证码 · 获取 */
-    captchaGet(): Promise<string>;
-    /** 验证码 · 检验 */
-    captchaCheck(value: string): Promise<string>;
-    /** 验证码 · 状态 */
-    captchaStatus(): Promise<{
-        is_pass: boolean;
-    }>;
-}
-
-declare interface Checker {
+declare type CancelToken = Symbol | string | number;
+
+declare interface Checker<T = any> {
     el?: HTMLElement;
     inputType?: 'password' | 'text';
     body: (checker: CheckerCtx) => HTMLElement;
-    request: (checker: CheckerCtx, inputVal: string) => Promise<string>;
-    onSuccess?: (checker: CheckerCtx, respData: string, inputVal: string, formEl: HTMLElement) => void;
-    onError?: (checker: CheckerCtx, err: any, inputVal: string, formEl: HTMLElement) => void;
+    request: (checker: CheckerCtx, inputVal: string) => Promise<T>;
+    onSuccess?: (checker: CheckerCtx, respData: T, inputVal: string, formEl: HTMLElement) => void;
+    onError?: (checker: CheckerCtx, errData: any, inputVal: string, formEl: HTMLElement) => void;
 }
 
 declare interface CheckerCaptchaPayload extends CheckerPayload {
@@ -351,21 +1267,20 @@ declare interface CheckerCtx {
 declare class CheckerLauncher {
     private opts;
     constructor(opts: CheckerLauncherOptions);
-    checkCaptcha(payload: CheckerCaptchaPayload): void;
-    checkAdmin(payload: CheckerPayload): void;
+    checkCaptcha: ((payload: CheckerCaptchaPayload) => Promise<void>);
+    checkAdmin: ((payload: CheckerPayload) => Promise<void>);
     fire(checker: Checker, payload: CheckerPayload, postFire?: (c: CheckerCtx) => void): void;
-    private close;
 }
 
 declare interface CheckerLauncherOptions {
     getCtx: () => ContextApi;
     getApi: () => Api;
-    getIframeURLBase: () => string;
+    getCaptchaIframeURL: () => string;
     onReload: () => void;
 }
 
 declare interface CheckerPayload {
-    onSuccess?: (inputVal: string, dialogEl?: HTMLElement) => void;
+    onSuccess?: () => void;
     onMount?: (dialogEl: HTMLElement) => void;
     onCancel?: () => void;
 }
@@ -376,65 +1291,12 @@ declare interface CheckerStore {
     iframe?: string;
 }
 
-declare class Comment_2 extends Component {
-    private renderInstance;
-    private actionInstance;
-    private data;
-    private cConf;
-    private parent;
-    private children;
-    private nestCurt;
-    private nestMax;
-    constructor(ctx: ContextApi, data: CommentData, conf: CommentConf);
-    /** 渲染 UI */
-    render(): void;
-    /** 获取评论操作实例对象 */
-    getActions(): CommentActions;
-    /** 获取评论渲染器实例对象 */
-    getRender(): Render;
-    /** 获取评论数据 */
-    getData(): CommentData;
-    /** 设置数据 */
-    setData(data: CommentData): void;
-    /** 获取父评论 */
-    getParent(): Comment_2 | null;
-    /** 获取所有子评论 */
-    getChildren(): Comment_2[];
-    /** 获取当前嵌套层数 */
-    getNestCurt(): number;
-    /** 判断是否为根评论 */
-    getIsRoot(): boolean;
-    /** 获取评论 ID */
-    getID(): number;
-    /** 置入子评论 */
-    putChild(childC: Comment_2, insertMode?: 'append' | 'prepend'): void;
-    /** 获取存放子评论的元素对象 */
-    getChildrenEl(): HTMLElement;
-    /** 获取所有父评论 */
-    getParents(): Comment_2[];
-    /** 获取评论元素对象 */
-    getEl(): HTMLElement;
-    /** 获取 Gravatar 头像 URL */
-    getGravatarURL(): string;
-    /** 获取评论 markdown 解析后的内容 */
-    getContentMarked(): string;
-    /** 获取格式化后的日期 */
-    getDateFormatted(): any;
-    /** 获取用户 UserAgent 信息 */
-    getUserUA(): {
-        browser: string;
-        os: string;
-    };
-    /** 获取配置 */
-    getConf(): CommentConf;
-}
-
 declare class CommentActions {
     private comment;
     private get ctx();
     private get data();
     private get cConf();
-    constructor(comment: Comment_2);
+    constructor(comment: CommentNode);
     /** 投票操作 */
     vote(type: 'up' | 'down'): void;
     /** 管理员 - 评论状态修改 */
@@ -445,34 +1307,6 @@ declare class CommentActions {
     goToReplyComment(): void;
 }
 
-/**
- * 评论 API
- */
-declare class CommentApi extends ApiBase {
-    /** 评论 · 获取 */
-    get(offset: number, pageSize: number, flatMode?: boolean, paramsEditor?: (params: any) => void): Promise<ListData>;
-    /** 评论 · 创建 */
-    add(comment: {
-        nick: string;
-        email: string;
-        link: string;
-        content: string;
-        rid: number;
-        page_key: string;
-        page_title?: string;
-        site_name?: string;
-    }): Promise<CommentData>;
-    /** 评论 · 修改 */
-    commentEdit(data: Partial<CommentData>): Promise<CommentData>;
-    /** 评论 · 删除 */
-    commentDel(commentID: number, siteName?: string): Promise<unknown>;
-    /** 投票 */
-    vote(targetID: number, type: string): Promise<{
-        up: number;
-        down: number;
-    }>;
-}
-
 declare interface CommentConf {
     isUnread?: boolean;
     openURL?: string;
@@ -504,13 +1338,11 @@ export declare interface CommentData {
     /** 评论日期 */
     date: string;
     /** 是否折叠 */
-    is_collapsed?: boolean;
+    is_collapsed: boolean;
     /** 是否待审 */
-    is_pending?: boolean;
+    is_pending: boolean;
     /** 是否置顶 */
-    is_pinned?: boolean;
-    /** 是否为管理员 */
-    is_admin?: boolean;
+    is_pinned: boolean;
     /** 徽章文字 */
     badge_name?: string;
     /** 徽章颜色 */
@@ -518,7 +1350,7 @@ export declare interface CommentData {
     /** IP 归属地 */
     ip_region?: string;
     /** 是否允许回复 */
-    is_allow_reply?: boolean;
+    is_allow_reply: boolean;
     /** 评论页面 key */
     page_key: string;
     /** 评论页面 url */
@@ -533,25 +1365,103 @@ export declare interface CommentData {
     vote_down: number;
 }
 
-declare type CommentNode = {
+declare class CommentNode extends Component {
+    private renderInstance;
+    private actionInstance;
+    private data;
+    private cConf;
+    private parent;
+    private children;
+    private nestCurt;
+    private nestMax;
+    constructor(ctx: ContextApi, data: CommentData, conf: CommentConf);
+    /** 渲染 UI */
+    render(): void;
+    /** 获取评论操作实例对象 */
+    getActions(): CommentActions;
+    /** 获取评论渲染器实例对象 */
+    getRender(): Render;
+    /** 获取评论数据 */
+    getData(): CommentData;
+    /** 设置数据 */
+    setData(data: CommentData): void;
+    /** 获取父评论 */
+    getParent(): CommentNode | null;
+    /** 获取所有子评论 */
+    getChildren(): CommentNode[];
+    /** 获取当前嵌套层数 */
+    getNestCurt(): number;
+    /** 判断是否为根评论 */
+    getIsRoot(): boolean;
+    /** 获取评论 ID */
+    getID(): number;
+    /** 置入子评论 */
+    putChild(childC: CommentNode, insertMode?: 'append' | 'prepend'): void;
+    /** 获取存放子评论的元素对象 */
+    getChildrenEl(): HTMLElement;
+    /** 获取所有父评论 */
+    getParents(): CommentNode[];
+    /** 获取评论元素对象 */
+    getEl(): HTMLElement;
+    /** 获取 Gravatar 头像 URL */
+    getGravatarURL(): string;
+    /** 获取评论 markdown 解析后的内容 */
+    getContentMarked(): string;
+    /** 获取格式化后的日期 */
+    getDateFormatted(): any;
+    /** 获取用户 UserAgent 信息 */
+    getUserUA(): {
+        browser: string;
+        os: string;
+    };
+    /** 获取配置 */
+    getConf(): CommentConf;
+}
+
+declare type CommentNode_2 = {
     id: number;
     comment: CommentData;
-    children: CommentNode[];
-    parent?: CommentNode;
+    children: CommentNode_2[];
+    parent?: CommentNode_2;
     level: number;
 };
 
+declare interface CommonApiVersionData {
+    app: string;
+    commit_hash: string;
+    version: string;
+}
+
+declare interface CommonConfData {
+    frontend_conf: CommonMap;
+    version: CommonApiVersionData;
+}
+
+declare interface CommonJSONResult {
+    /** Data */
+    data: any;
+    /** Message */
+    msg: string;
+}
+
+declare type CommonMap = Record<string, any>;
+
 declare abstract class Component {
     ctx: ContextApi;
     $el: HTMLElement;
-    readonly conf: ArtalkConfig;
+    get conf(): ArtalkConfig;
     constructor(ctx: ContextApi);
 }
 
+declare enum ContentType {
+    Json = "application/json",
+    FormData = "multipart/form-data",
+    UrlEncoded = "application/x-www-form-urlencoded",
+    Text = "text/plain"
+}
+
 /**
- * Context 接口
- *
- * (面向接口的编程)
+ * Artalk Context
  */
 export declare interface ContextApi extends EventManagerFuncs<EventPayloadMap> {
     /** Artalk 根元素对象 */
@@ -578,6 +1488,20 @@ export declare interface ContextApi extends EventManagerFuncs<EventPayloadMap> {
     reload(): void;
     /** 列表滚动到第一个评论的位置 */
     listGotoFirst(): void;
+    /** Get the comment data list */
+    getComments(): CommentData[];
+    /** Get the comment node list */
+    getCommentNodes(): CommentNode[];
+    /**
+     * Get the comment data list
+     * @deprecated Use `getComments()` instead
+     */
+    getCommentDataList(): CommentData[];
+    /**
+     * Get the comment node list
+     * @deprecated Use `getCommentNodes()` instead
+     */
+    getCommentList(): CommentNode[];
     /** 显示侧边栏 */
     showSidebar(payload?: SidebarShowPayload): void;
     /** 隐藏侧边栏 */
@@ -591,9 +1515,9 @@ export declare interface ContextApi extends EventManagerFuncs<EventPayloadMap> {
     /** 评论框 - 复原状态 */
     editorResetState(): void;
     /** 验证码检测 */
-    checkCaptcha(payload: CheckerCaptchaPayload): void;
+    checkCaptcha(payload: CheckerCaptchaPayload): Promise<void>;
     /** 管理员检测 */
-    checkAdmin(payload: CheckerPayload): void;
+    checkAdmin(payload: CheckerPayload): Promise<void>;
     /** i18n 翻译 */
     $t(key: keyof I18n, args?: {
         [key: string]: string;
@@ -606,6 +1530,8 @@ export declare interface ContextApi extends EventManagerFuncs<EventPayloadMap> {
     getEl(): HTMLElement;
     /** 更新配置 */
     updateConf(conf: Partial<ArtalkConfig>): void;
+    /** 监听配置更新 */
+    watchConf<T extends (keyof ArtalkConfig)[]>(keys: T, effect: (val: Pick<ArtalkConfig, T[number]>) => void): void;
 }
 
 export declare interface DataManagerApi {
@@ -621,8 +1547,8 @@ export declare interface DataManagerApi {
     insertComment(comment: CommentData): void;
     updateComment(comment: CommentData): void;
     deleteComment(id: number): void;
-    getUnreads(): NotifyData[];
-    updateUnreads(unreads: NotifyData[]): void;
+    getNotifies(): NotifyData[];
+    updateNotifies(notifies: NotifyData[]): void;
     getPage(): PageData | undefined;
     updatePage(pageData: PageData): void;
 }
@@ -869,8 +1795,90 @@ declare const en: {
     currentVersion: string;
     ignore: string;
     open: string;
+    openName: string;
 };
 
+declare interface EntityCookedComment {
+    badge_color: string;
+    badge_name: string;
+    content: string;
+    content_marked: string;
+    date: string;
+    email_encrypted: string;
+    id: number;
+    ip_region: string;
+    is_allow_reply: boolean;
+    is_collapsed: boolean;
+    is_pending: boolean;
+    is_pinned: boolean;
+    link: string;
+    nick: string;
+    page_key: string;
+    page_url: string;
+    rid: number;
+    site_name: string;
+    ua: string;
+    user_id: number;
+    visible: boolean;
+    vote_down: number;
+    vote_up: number;
+}
+
+declare interface EntityCookedNotify {
+    comment_id: number;
+    id: number;
+    is_emailed: boolean;
+    is_read: boolean;
+    read_link: string;
+    user_id: number;
+}
+
+declare interface EntityCookedPage {
+    admin_only: boolean;
+    id: number;
+    key: string;
+    pv: number;
+    site_name: string;
+    title: string;
+    url: string;
+    vote_down: number;
+    vote_up: number;
+}
+
+declare interface EntityCookedSite {
+    first_url: string;
+    id: number;
+    name: string;
+    urls: string[];
+    urls_raw: string;
+}
+
+declare interface EntityCookedUser {
+    badge_color: string;
+    badge_name: string;
+    email: string;
+    id: number;
+    is_admin: boolean;
+    link: string;
+    name: string;
+    receive_email: boolean;
+}
+
+declare interface EntityCookedUserForAdmin {
+    badge_color: string;
+    badge_name: string;
+    comment_count: number;
+    email: string;
+    id: number;
+    is_admin: boolean;
+    is_in_conf: boolean;
+    last_ip: string;
+    last_ua: string;
+    link: string;
+    name: string;
+    receive_email: boolean;
+}
+
 declare interface ErrorData {
     msg: string;
     data?: any;
@@ -906,32 +1914,485 @@ declare interface EventOptions {
 
 /** EventName to EventPayload Type */
 export declare interface EventPayloadMap {
-    'inited': undefined;
-    'destroy': undefined;
+    'created': undefined;
+    'mounted': undefined;
+    'updated': ArtalkConfig;
+    'unmounted': undefined;
     'conf-fetch': undefined;
     'list-fetch': Partial<ListFetchParams>;
     'list-fetched': ListFetchedArgs;
     'list-load': CommentData[];
     'list-loaded': CommentData[];
-    'list-error': ErrorData;
+    'list-failed': ErrorData;
     'list-goto-first': undefined;
     'list-reach-bottom': undefined;
     'comment-inserted': CommentData;
     'comment-updated': CommentData;
     'comment-deleted': CommentData;
-    'comment-rendered': Comment_2;
-    'unreads-updated': NotifyData[];
+    'comment-rendered': CommentNode;
+    'notifies-updated': NotifyData[];
     'list-goto': number;
     'page-loaded': PageData;
     'editor-submit': undefined;
     'editor-submitted': undefined;
     'user-changed': LocalUser;
-    'conf-loaded': ArtalkConfig;
-    'dark-mode-changed': boolean | 'auto';
     'sidebar-show': undefined;
     'sidebar-hide': undefined;
 }
 
+export declare interface FetchError extends Error {
+    code: number;
+    message: string;
+    data?: any;
+}
+
+declare interface FullRequestParams extends Omit<RequestInit, 'body'> {
+    /** set parameter to `true` for call `securityWorker` for this request */
+    secure?: boolean;
+    /** request path */
+    path: string;
+    /** content type of request body */
+    type?: ContentType;
+    /** query params */
+    query?: QueryParamsType;
+    /** format of response (i.e. response.json() -> format: "json") */
+    format?: ResponseFormat;
+    /** request body */
+    body?: unknown;
+    /** base url */
+    baseUrl?: string;
+    /** request cancellation token */
+    cancelToken?: CancelToken;
+}
+
+declare type HandlerMap = Record<string, any>;
+
+declare interface HandlerParamsCaptchaVerify {
+    /** The captcha value to check */
+    value: string;
+}
+
+declare interface HandlerParamsCommentCreate {
+    /** The comment content */
+    content: string;
+    /** The comment email */
+    email: string;
+    /** The comment link */
+    link?: string;
+    /** The comment name */
+    name: string;
+    /** The comment page_key */
+    page_key: string;
+    /** The comment page_title */
+    page_title?: string;
+    /** The comment rid */
+    rid?: number;
+    /** The site name of your content scope */
+    site_name: string;
+    /** The comment ua */
+    ua?: string;
+}
+
+declare interface HandlerParamsCommentUpdate {
+    /** The comment content */
+    content: string;
+    /** The comment email */
+    email?: string;
+    /** The comment ip */
+    ip?: string;
+    /** The comment is_collapsed */
+    is_collapsed: boolean;
+    /** The comment is_pending */
+    is_pending: boolean;
+    /** The comment is_pinned */
+    is_pinned: boolean;
+    /** The comment link */
+    link?: string;
+    /** The comment nick */
+    nick?: string;
+    /** The comment page_key */
+    page_key: string;
+    /** The comment rid */
+    rid: number;
+    /** The site name of your content scope */
+    site_name: string;
+    /** The comment ua */
+    ua: string;
+}
+
+declare interface HandlerParamsEmailSend {
+    /** The body of email */
+    body: string;
+    /** The subject of email */
+    subject: string;
+    /** The email address of the receiver */
+    to_addr: string;
+}
+
+declare interface HandlerParamsNotifyReadAll {
+    /** The user email */
+    email: string;
+    /** The username */
+    name: string;
+}
+
+declare interface HandlerParamsPageFetchAll {
+    /** If not empty, only fetch pages of this site */
+    site_name?: string;
+}
+
+declare interface HandlerParamsPagePV {
+    /** The page key */
+    page_key: string;
+    /** The page title */
+    page_title?: string;
+    /** The site name of your content scope */
+    site_name?: string;
+}
+
+declare interface HandlerParamsPageUpdate {
+    /** Updated page admin_only option */
+    admin_only: boolean;
+    /** Updated page key */
+    key: string;
+    /** The site name of your content scope */
+    site_name: string;
+    /** Updated page title */
+    title: string;
+}
+
+declare interface HandlerParamsSettingApply {
+    /** The content of the config file in YAML format */
+    yaml: string;
+}
+
+declare interface HandlerParamsSiteCreate {
+    /** The site name */
+    name: string;
+    /** The site urls */
+    urls: string[];
+}
+
+declare interface HandlerParamsSiteUpdate {
+    /** Updated site name */
+    name: string;
+    /** Updated site urls */
+    urls: string[];
+}
+
+declare interface HandlerParamsTransferImport {
+    /** Automatically answer yes for all questions. */
+    assumeyes?: boolean;
+    /** The JSON data */
+    json_data?: string;
+    /** The JSON file path */
+    json_file?: string;
+    /** The target site name */
+    target_site_name?: string;
+    /** The target site url */
+    target_site_url?: string;
+    /** Enable URL resolver */
+    url_resolver?: boolean;
+}
+
+declare interface HandlerParamsUserCreate {
+    /** The user badge color (hex format) */
+    badge_color?: string;
+    /** The user badge name */
+    badge_name?: string;
+    /** The user email */
+    email: string;
+    /** The user is an admin */
+    is_admin: boolean;
+    /** The user link */
+    link?: string;
+    /** The user name */
+    name: string;
+    /** The user password */
+    password?: string;
+    /** The user receive email */
+    receive_email: boolean;
+}
+
+declare interface HandlerParamsUserLogin {
+    /** The user email */
+    email: string;
+    /** The username */
+    name?: string;
+    /** The user password */
+    password: string;
+}
+
+declare interface HandlerParamsUserUpdate {
+    /** The user badge color (hex format) */
+    badge_color?: string;
+    /** The user badge name */
+    badge_name?: string;
+    /** The user email */
+    email: string;
+    /** The user is an admin */
+    is_admin: boolean;
+    /** The user link */
+    link?: string;
+    /** The user name */
+    name: string;
+    /** The user password */
+    password?: string;
+    /** The user receive email */
+    receive_email: boolean;
+}
+
+declare interface HandlerParamsVote {
+    /** The user email */
+    email?: string;
+    /** The username */
+    name?: string;
+}
+
+declare interface HandlerResponseAdminUserList {
+    count: number;
+    users: EntityCookedUserForAdmin[];
+}
+
+declare interface HandlerResponseCaptchaGet {
+    img_data: string;
+}
+
+declare interface HandlerResponseCaptchaStatus {
+    is_pass: boolean;
+}
+
+declare interface HandlerResponseCommentCreate {
+    badge_color: string;
+    badge_name: string;
+    content: string;
+    content_marked: string;
+    date: string;
+    email_encrypted: string;
+    id: number;
+    ip_region: string;
+    is_allow_reply: boolean;
+    is_collapsed: boolean;
+    is_pending: boolean;
+    is_pinned: boolean;
+    link: string;
+    nick: string;
+    page_key: string;
+    page_url: string;
+    rid: number;
+    site_name: string;
+    ua: string;
+    user_id: number;
+    visible: boolean;
+    vote_down: number;
+    vote_up: number;
+}
+
+declare interface HandlerResponseCommentList {
+    comments: EntityCookedComment[];
+    count: number;
+    page: EntityCookedPage;
+    roots_count: number;
+}
+
+declare interface HandlerResponseCommentUpdate {
+    badge_color: string;
+    badge_name: string;
+    content: string;
+    content_marked: string;
+    date: string;
+    email_encrypted: string;
+    id: number;
+    ip_region: string;
+    is_allow_reply: boolean;
+    is_collapsed: boolean;
+    is_pending: boolean;
+    is_pinned: boolean;
+    link: string;
+    nick: string;
+    page_key: string;
+    page_url: string;
+    rid: number;
+    site_name: string;
+    ua: string;
+    user_id: number;
+    visible: boolean;
+    vote_down: number;
+    vote_up: number;
+}
+
+declare interface HandlerResponseNotifyList {
+    count: number;
+    notifies: EntityCookedNotify[];
+}
+
+declare interface HandlerResponsePageFetch {
+    admin_only: boolean;
+    id: number;
+    key: string;
+    pv: number;
+    site_name: string;
+    title: string;
+    url: string;
+    vote_down: number;
+    vote_up: number;
+}
+
+declare interface HandlerResponsePageFetchStatus {
+    /** The number of pages that have been fetched */
+    done: number;
+    /** If the task is in progress */
+    is_progress: boolean;
+    /** The message of the task status */
+    msg: string;
+    /** The total number of pages */
+    total: number;
+}
+
+declare interface HandlerResponsePageList {
+    count: number;
+    pages: EntityCookedPage[];
+}
+
+declare interface HandlerResponsePagePV {
+    pv: number;
+}
+
+declare interface HandlerResponsePageUpdate {
+    admin_only: boolean;
+    id: number;
+    key: string;
+    pv: number;
+    site_name: string;
+    title: string;
+    url: string;
+    vote_down: number;
+    vote_up: number;
+}
+
+declare interface HandlerResponseSettingGet {
+    yaml: string;
+}
+
+declare interface HandlerResponseSettingTemplate {
+    yaml: string;
+}
+
+declare interface HandlerResponseSiteCreate {
+    first_url: string;
+    id: number;
+    name: string;
+    urls: string[];
+    urls_raw: string;
+}
+
+declare interface HandlerResponseSiteList {
+    count: number;
+    sites: EntityCookedSite[];
+}
+
+declare interface HandlerResponseSiteUpdate {
+    first_url: string;
+    id: number;
+    name: string;
+    urls: string[];
+    urls_raw: string;
+}
+
+declare interface HandlerResponseTransferExport {
+    /** The exported data which is a JSON string */
+    artrans: string;
+}
+
+declare interface HandlerResponseTransferUpload {
+    /** The uploaded file name which can be used to import */
+    filename: string;
+}
+
+declare interface HandlerResponseUpload {
+    file_name: string;
+    file_type: string;
+    public_url: string;
+}
+
+declare interface HandlerResponseUserCreate {
+    badge_color: string;
+    badge_name: string;
+    comment_count: number;
+    email: string;
+    id: number;
+    is_admin: boolean;
+    is_in_conf: boolean;
+    last_ip: string;
+    last_ua: string;
+    link: string;
+    name: string;
+    receive_email: boolean;
+}
+
+declare interface HandlerResponseUserInfo {
+    is_login: boolean;
+    notifies: EntityCookedNotify[];
+    notifies_count: number;
+    user: EntityCookedUser;
+}
+
+declare interface HandlerResponseUserLogin {
+    token: string;
+    user: EntityCookedUser;
+}
+
+declare interface HandlerResponseUserStatus {
+    is_admin: boolean;
+    is_login: boolean;
+}
+
+declare interface HandlerResponseUserUpdate {
+    badge_color: string;
+    badge_name: string;
+    comment_count: number;
+    email: string;
+    id: number;
+    is_admin: boolean;
+    is_in_conf: boolean;
+    last_ip: string;
+    last_ua: string;
+    link: string;
+    name: string;
+    receive_email: boolean;
+}
+
+declare interface HandlerResponseVote {
+    down: number;
+    up: number;
+}
+
+declare class HttpClient<SecurityDataType = unknown> {
+    baseUrl: string;
+    private securityData;
+    private securityWorker?;
+    private abortControllers;
+    private customFetch;
+    private baseApiParams;
+    constructor(apiConfig?: ApiConfig<SecurityDataType>);
+    setSecurityData: (data: SecurityDataType | null) => void;
+    protected encodeQueryParam(key: string, value: any): string;
+    protected addQueryParam(query: QueryParamsType, key: string): string;
+    protected addArrayQueryParam(query: QueryParamsType, key: string): any;
+    protected toQueryString(rawQuery?: QueryParamsType): string;
+    protected addQueryParams(rawQuery?: QueryParamsType): string;
+    private contentFormatters;
+    protected mergeRequestParams(params1: RequestParams, params2?: RequestParams): RequestParams;
+    protected createAbortSignal: (cancelToken: CancelToken) => AbortSignal | undefined;
+    abortRequest: (cancelToken: CancelToken) => void;
+    request: <T = any, E = any>({ body, secure, path, type, query, format, baseUrl, cancelToken, ...params }: FullRequestParams) => Promise<HttpResponse<T, E>>;
+}
+
+declare interface HttpResponse<D extends unknown, E extends unknown = unknown> extends Response {
+    data: D;
+    error: E;
+}
+
 export declare type I18n = typeof en;
 
 export declare type I18nKeys = keyof I18n;
@@ -940,36 +2401,29 @@ export declare const init: typeof Artalk.init;
 
 declare class Layer {
     private $el;
-    private wrap;
+    private opts;
+    private allowMaskClose;
     private onAfterHide?;
-    constructor(wrap: LayerWrap, name: string, el?: HTMLElement);
+    constructor($el: HTMLElement, opts: LayerOptions);
     setOnAfterHide(func: () => void): void;
+    setAllowMaskClose(allow: boolean): void;
+    getAllowMaskClose(): boolean;
     getEl(): HTMLElement;
     show(): void;
-    hide(): void;
-    destroy(): void;
+    hide(): Promise<void>;
+    destroy(): Promise<void>;
 }
 
 declare class LayerManager {
     private wrap;
-    private ctx;
     constructor(ctx: ContextApi);
     getEl(): HTMLElement;
-    create(name: string, el?: HTMLElement | undefined): Layer;
+    create(name: string, el?: HTMLElement): Layer;
 }
 
-declare class LayerWrap {
-    private $wrap;
-    private $mask;
-    private allowMaskClose;
-    private items;
-    constructor();
-    createItem(name: string, el?: HTMLElement): HTMLElement;
-    getWrap(): HTMLElement;
-    getMask(): HTMLElement;
-    setMaskClose(enabled: boolean): void;
-    show(): void;
-    hide(callback?: () => void): void;
+declare interface LayerOptions {
+    onShow: () => void;
+    onHide: () => void;
 }
 
 declare interface LayoutOptions {
@@ -977,8 +2431,8 @@ declare interface LayoutOptions {
     nestSortBy: ListNest.SortByType;
     nestMax: number;
     flatMode: boolean;
-    createCommentNode(comment: CommentData, ctxComments: CommentData[]): Comment_2;
-    findCommentNode(id: number): Comment_2 | undefined;
+    createCommentNode(comment: CommentData, ctxComments: CommentData[]): CommentNode;
+    findCommentNode(id: number): CommentNode | undefined;
     getCommentDataList(): CommentData[];
 }
 
@@ -986,8 +2440,8 @@ declare class List extends Component {
     /** 列表评论集区域元素 */
     $commentsWrap: HTMLElement;
     getCommentsWrapEl(): HTMLElement;
-    protected commentNodes: Comment_2[];
-    getCommentNodes(): Comment_2[];
+    protected commentNodes: CommentNode[];
+    getCommentNodes(): CommentNode[];
     constructor(ctx: ContextApi);
     getListLayout(): ListLayout;
     private initCrudEvents;
@@ -997,21 +2451,11 @@ export declare interface ListData {
     /** 评论数据 */
     comments: CommentData[];
     /** 根评论总数 */
-    total_roots: number;
+    roots_count: number;
     /** 评论总数（包括所有子评论） */
-    total: number;
+    count: number;
     /** 页面信息 */
     page: PageData;
-    /** 站点信息 */
-    site: SiteData;
-    /** 未读的 Notifies */
-    unread: NotifyData[];
-    /** 未读计数 */
-    unread_count: number;
-    /** API 版本 */
-    api_version: ApiVersionData;
-    /** 后端配置 */
-    conf: any;
 }
 
 declare interface ListFetchedArgs {
@@ -1049,7 +2493,7 @@ declare class ListLayout {
 declare namespace ListNest {
     export {
         makeNestCommentNodeList,
-        CommentNode,
+        CommentNode_2 as CommentNode,
         SortByType
     }
 }
@@ -1073,7 +2517,7 @@ export declare interface LocalUser {
     isAdmin: boolean;
 }
 
-declare function makeNestCommentNodeList(srcData: CommentData[], sortBy?: SortByType, nestMax?: number): CommentNode[];
+declare function makeNestCommentNodeList(srcData: CommentData[], sortBy?: SortByType, nestMax?: number): CommentNode_2[];
 
 export declare interface NotifyData {
     /** 通知 ID */
@@ -1092,27 +2536,6 @@ export declare interface NotifyData {
 
 export declare type NotifyLevel = "i" | "s" | "w" | "e";
 
-/**
- * 页面 API
- */
-declare class PageApi extends ApiBase {
-    /** 页面 · 获取 */
-    pageGet(siteName?: string, offset?: number, limit?: number): Promise<{
-        pages: PageData[];
-        total: number;
-    }>;
-    /** 页面 · 修改 */
-    pageEdit(data: PageData): Promise<PageData>;
-    /** 页面 · 删除 */
-    pageDel(pageKey: string, siteName?: string): Promise<unknown>;
-    /** 页面 · 数据更新 */
-    pageFetch(id?: number, siteName?: string, getStatus?: boolean): Promise<any>;
-    /** PV */
-    pv(): Promise<number>;
-    /** 统计 */
-    stat(type: 'latest_comments' | 'latest_pages' | 'pv_most_pages' | 'comment_most_pages' | 'page_pv' | 'site_pv' | 'page_comment' | 'site_comment', pageKeys?: string | string[], limit?: number): Promise<number | object | CommentData[] | PageData[]>;
-}
-
 export declare interface PageData {
     /** 页面 ID */
     id: number;
@@ -1185,8 +2608,10 @@ declare class PlugManager {
     getTransformedContent(rawContent: string): string;
 }
 
+declare type QueryParamsType = Record<string | number, any>;
+
 declare class Render {
-    comment: Comment_2;
+    comment: CommentNode;
     get ctx(): ContextApi;
     get data(): CommentData;
     get conf(): ArtalkConfig;
@@ -1204,7 +2629,7 @@ declare class Render {
     voteBtnDown?: ActionBtn;
     $replyTo?: HTMLElement;
     $replyAt?: HTMLElement;
-    constructor(comment: Comment_2);
+    constructor(comment: CommentNode);
     render(): HTMLElement;
     /** 内容限高检测 */
     checkHeightLimit(): void;
@@ -1230,6 +2655,10 @@ declare class Render {
     setOpenAction(action: () => void): void;
 }
 
+declare type RequestParams = Omit<FullRequestParams, 'body' | 'method' | 'query' | 'path'>;
+
+declare type ResponseFormat = keyof Omit<Body, 'body' | 'bodyUsed'>;
+
 declare const Sel: {
     $header: string;
     $nick: string;
@@ -1267,7 +2696,10 @@ declare class SidebarLayer extends Component {
     $iframeWrap: HTMLElement;
     $iframe?: HTMLIFrameElement;
     constructor(ctx: ContextApi);
-    private firstShow;
+    /** Refresh iFrame on show */
+    private refreshOnShow;
+    /** Animation timer */
+    private animTimer?;
     /** 显示 */
     show(conf?: SidebarShowPayload): Promise<void>;
     /** 隐藏 */
@@ -1282,22 +2714,6 @@ export declare interface SidebarShowPayload {
     view?: 'comments' | 'sites' | 'pages' | 'transfer';
 }
 
-/**
- * 站点 API
- */
-declare class SiteApi extends ApiBase {
-    /** 站点 · 获取 */
-    siteGet(): Promise<SiteData[]>;
-    /** 站点 · 创建 */
-    siteAdd(name: string, urls: string): Promise<SiteData>;
-    /** 站点 · 修改 */
-    siteEdit(data: SiteData): Promise<SiteData>;
-    /** 站点 · 删除 */
-    siteDel(id: number, delContent?: boolean): Promise<unknown>;
-    /** 导出 */
-    export(): Promise<any>;
-}
-
 export declare interface SiteData {
     /** 站点 ID */
     id: number;
@@ -1313,35 +2729,6 @@ export declare interface SiteData {
 
 declare type SortByType = 'DATE_DESC' | 'DATE_ASC' | 'SRC_INDEX' | 'VOTE_UP_DESC';
 
-/**
- * 系统 API
- */
-declare class SystemApi extends ApiBase {
-    /** 获取配置 */
-    conf(): Promise<SystemConfResp>;
-    /** 获取配置数据 */
-    getSettings(): Promise<{
-        custom: string;
-        template: string;
-    }>;
-    /** 保存配置数据 */
-    saveSettings(yamlStr: string): Promise<boolean>;
-    /** 获取 API 版本信息 */
-    version(): Promise<{
-        app: string;
-        version: string;
-        commit_hash: string;
-        fe_min_version: string;
-    }>;
-}
-
-declare interface SystemConfResp {
-    frontend_conf: Partial<ArtalkConfig>;
-    version: ApiVersionInfo;
-}
-
-declare type TC = typeof ApiComponents;
-
 declare type TInjectedServices = {
     [K in keyof TServiceInjectors]: ReturnType<TServiceInjectors[K]>;
 };
@@ -1362,17 +2749,6 @@ declare type TServiceImps = typeof services;
 
 declare type TServiceInjectors = Omit<TServiceImps, TOmitConditions>;
 
-/**
- * 上传 API
- */
-declare class UploadApi extends ApiBase {
-    /** 图片上传 */
-    imgUpload(file: File): Promise<{
-        img_file: string;
-        img_url: string;
-    }>;
-}
-
 export declare const use: typeof Artalk.use;
 
 declare class User {
@@ -1380,7 +2756,7 @@ declare class User {
     private data;
     constructor(opts: UserOpts);
     getData(): LocalUser;
-    /** 保存用户到 localStorage 中 */
+    /** Update user data and save to localStorage */
     update(obj?: Partial<LocalUser>): void;
     /**
      * Logout
@@ -1388,51 +2764,10 @@ declare class User {
      * @description Logout will clear login status, but not clear user data (nick, email, link)
      */
     logout(): void;
-    /** 是否已填写基本用户信息 */
+    /** Check if user has filled basic data */
     checkHasBasicUserInfo(): boolean;
 }
 
-/**
- * 用户 API
- */
-declare class UserApi extends ApiBase {
-    /** 用户 · 登录 */
-    login(name: string, email: string, password: string): Promise<{
-        token: string;
-        user: UserData;
-    }>;
-    /** 用户 · 获取  */
-    userGet(name: string, email: string): {
-        req: Promise<{
-            user: UserData | null;
-            is_login: boolean;
-            unread: NotifyData[];
-            unread_count: any;
-        }>;
-        abort: () => void;
-    };
-    /** 用户 · 登录状态 */
-    loginStatus(): Promise<{
-        is_login: boolean;
-        is_admin: boolean;
-    }>;
-    /** 用户 · 注销 */
-    logout(): Promise<unknown>;
-    /** 已读标记 */
-    markRead(commentID: number, notifyKey: string, readAll?: boolean): Promise<unknown>;
-    /** 用户 · 列表 */
-    userList(offset?: number, limit?: number, type?: 'all' | 'admin' | 'in_conf'): Promise<{
-        users: UserDataForAdmin[];
-        total: number;
-    }>;
-    /** 用户 · 新增 */
-    userAdd(user: Partial<UserDataForAdmin>, password?: string): Promise<UserDataForAdmin>;
-    /** 用户 · 修改 */
-    userEdit(user: Partial<UserDataForAdmin>, password?: string): Promise<UserDataForAdmin>;
-    /** 用户 · 删除 */
-    userDel(userID: number): Promise<unknown>;
-}
-
 export declare interface UserData {
     /** 用户 ID */
     id: number;
@@ -1448,10 +2783,6 @@ export declare interface UserData {
     badge_color: string;
     /** 是否属于管理员 */
     is_admin: boolean;
-    /** 所属站点名 */
-    site_names: string[];
-    /** 所属站点名 (字符串) */
-    site_names_raw: string;
     /** 是否允许接收邮件通知 */
     receive_email: boolean;
 }
@@ -1465,8 +2796,13 @@ export declare interface UserDataForAdmin extends UserData {
     is_in_conf: boolean;
     /** 评论数 */
     comment_count: number;
-    /** 密码 */
-    password: string;
+}
+
+export declare interface UserInfoApiResponseData {
+    user?: UserData;
+    is_login: boolean;
+    notifies: NotifyData[];
+    notifies_count: number;
 }
 
 declare interface UserOpts {