@mx-space/api-client 1.20.0 → 1.21.1

package/LICENSE

@@ -0,0 +1,33 @@
+** Mix Space Open Source License**
+
+This project is dual-licensed under different terms for different parts of the project. It is important for users and contributors to understand the licensing terms applicable to each part of the project.
+
+### For the `apps/` Directory
+
+**License:** GNU Affero General Public License v3.0 (AGPLv3) with Additional Terms (ADDITIONAL_TERMS).
+
+**Scope:** This license applies exclusively to all files within the `apps/` directory of this project.
+
+**Summary:**
+- The AGPLv3 is a free, copyleft license suitable for software that will be distributed over a network. It allows users to use, modify, and distribute the software and any modifications under the same terms.
+- The "Additional Terms" (ADDITIONAL_TERMS) are specific conditions that are added to the AGPLv3 license. These terms must be reviewed in the accompanying LICENSE file or documentation to understand any additional restrictions or permissions that apply to the software.
+
+### For Other Parts of the Project
+
+**License:** MIT License.
+
+**Scope:** This license applies to all parts of the project that are not included within the `apps/` directory.
+
+**Summary:**
+- The MIT License is a permissive open-source license that allows users considerable freedom. It permits use, copying, modification, merging, publishing, distribution, sublicensing, and/or selling copies of the software.
+- It also protects the authors by including a limitation of liability and a disclaimer of warranty.
+
+**General Conditions:**
+- Redistribution and use in source and binary forms, with or without modification, are permitted provided that the above license notices and this permission notice appear in all copies of the software.
+- The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement.
+
+**Contribution:**
+- Contributions to this project are accepted under the terms of the same license as the part of the project to which the contribution is made.
+
+**Notice:**
+- This summary is not the license itself and is not a substitute for reading the licenses in their entirety. All users and contributors are encouraged to read the full text of the licenses for a comprehensive understanding.

package/dist/adaptors/axios.cjs

@@ -1,5 +1,5 @@
-Object.defineProperty(exports, '__esModule', { value: true });
-//#region rolldown:runtime
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/adaptors/fetch.cjs

@@ -1,3 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 //#region adaptors/fetch.ts
 const jsonDataAttachResponse = async (response) => {

package/dist/adaptors/umi-request.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports, '__esModule', { value: true });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 const require_adaptors_axios = require('./axios.cjs');
 let umi_request = require("umi-request");
 

package/dist/index.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports, '__esModule', { value: true });
+Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
 //#region utils/index.ts
 const isPlainObject = (obj) => isObject(obj) && Object.prototype.toString.call(obj) === "[object Object]" && Object.getPrototypeOf(obj) === Object.prototype;
@@ -455,17 +455,30 @@ var NoteController = class {
 	}
 	/**
 	* 获取当前日记的上下各 n / 2 篇日记
+	* @param id 当前日记 ID
+	* @param size 返回数量，默认 5
+	* @param options 可选参数，包含 lang 用于获取翻译版本
 	*/
-	getMiddleList(id, size = 5) {
-		return this.proxy.list(id).get({ params: { size } });
+	getMiddleList(id, size = 5, options) {
+		const { lang } = options || {};
+		return this.proxy.list(id).get({ params: {
+			size,
+			lang
+		} });
 	}
 	/**
 	* 获取专栏内的所有日记
+	* @param topicId 专栏 ID
+	* @param page 页码，默认 1
+	* @param size 每页数量，默认 10
+	* @param options 可选参数，包含排序选项和 lang 用于获取翻译版本
 	*/
-	getNoteByTopicId(topicId, page = 1, size = 10, sortOptions = {}) {
+	getNoteByTopicId(topicId, page = 1, size = 10, options = {}) {
+		const { lang, ...sortOptions } = options;
 		return this.proxy.topics(topicId).get({ params: {
 			page,
 			size,
+			lang,
 			...sortOptions
 		} });
 	}
@@ -528,10 +541,11 @@ var PostController = class {
 	* 获取文章列表分页
 	* @param page
 	* @param perPage
-	* @returns
+	* @param options 可选参数，包含 lang 用于获取翻译版本
+	* @returns 当传入 lang 时，返回的文章可能包含 isTranslated 和 translationMeta 字段
 	*/
 	getList(page = 1, perPage = 10, options = {}) {
-		const { select, sortBy, sortOrder, year, truncate } = options;
+		const { select, sortBy, sortOrder, year, truncate, lang } = options;
 		return this.proxy.get({ params: {
 			page,
 			size: perPage,
@@ -539,7 +553,8 @@ var PostController = class {
 			sortBy,
 			sortOrder,
 			year,
-			truncate
+			truncate,
+			lang
 		} });
 	}
 	getPost(idOrCategoryName, slug, options) {

package/dist/index.d.cts

@@ -100,7 +100,7 @@ declare class RequestError extends Error {
 }
 //#endregion
 //#region controllers/ack.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     ack: AckController<ResponseWrapper>;
   }
@@ -182,6 +182,7 @@ interface TranslationMeta {
 type ModelWithTranslation<T> = T & {
   isTranslated: boolean;
   translationMeta?: TranslationMeta;
+  availableTranslations?: string[];
 };
 //#endregion
 //#region models/post.d.ts
@@ -739,7 +740,7 @@ declare const SubscribeTypeToBitMap: {
 type SubscribeType = keyof typeof SubscribeTypeToBitMap;
 //#endregion
 //#region controllers/activity.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     activity: ActivityController<ResponseWrapper>;
   }
@@ -892,7 +893,7 @@ declare class ActivityController<ResponseWrapper> implements IController {
 type SortOrder = 'asc' | 'desc';
 //#endregion
 //#region controllers/aggregate.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     aggregate: AggregateController<ResponseWrapper>;
   }
@@ -952,7 +953,7 @@ declare class AggregateController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/ai.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     ai: AIController<ResponseWrapper>;
   }
@@ -1086,7 +1087,7 @@ declare class AIController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/category.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     category: CategoryController<ResponseWrapper>;
   }
@@ -1133,7 +1134,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         name: string;
         created: string;
         id: string;
-        children: Pick<PostModel, "id" | "title" | "slug" | "modified" | "created">[];
+        children: Pick<PostModel, "id" | "created" | "title" | "slug" | "modified">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1185,7 +1186,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         };
       }) ? T_1 extends unknown ? {
         tag: string;
-        data: Pick<PostModel, "category" | "id" | "title" | "slug" | "created">[];
+        data: Pick<PostModel, "category" | "id" | "created" | "title" | "slug">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1217,7 +1218,7 @@ interface CommentDto {
 }
 //#endregion
 //#region controllers/comment.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     comment: CommentController<ResponseWrapper>;
   }
@@ -1342,7 +1343,7 @@ declare abstract class BaseCrudController<T, ResponseWrapper> {
 }
 //#endregion
 //#region controllers/link.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     link: LinkController<ResponseWrapper>;
     friend: LinkController<ResponseWrapper>;
@@ -1360,7 +1361,7 @@ declare class LinkController<ResponseWrapper> extends BaseCrudController<LinkMod
 }
 //#endregion
 //#region controllers/note.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     note: NoteController<ResponseWrapper>;
   }
@@ -1376,6 +1377,20 @@ type NoteByNidOptions = {
   single?: boolean;
   lang?: string;
 };
+type NoteMiddleListOptions = {
+  lang?: string;
+};
+type NoteTopicListOptions = SortOptions & {
+  lang?: string;
+};
+type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'created' | 'isPublished'> & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
+};
+type NoteTopicListItem = NoteModel & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
+};
 declare class NoteController<ResponseWrapper> implements IController {
   private client;
   base: string;
@@ -1422,42 +1437,49 @@ declare class NoteController<ResponseWrapper> implements IController {
   }>;
   /**
    * 获取当前日记的上下各 n / 2 篇日记
+   * @param id 当前日记 ID
+   * @param size 返回数量，默认 5
+   * @param options 可选参数，包含 lang 用于获取翻译版本
    */
-  getMiddleList(id: string, size?: number): RequestProxyResult<{
-    data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+  getMiddleList(id: string, size?: number, options?: NoteMiddleListOptions): RequestProxyResult<{
+    data: NoteTimelineItem[];
     size: number;
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
     data: {
-      data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+      data: NoteTimelineItem[];
       size: number;
     };
   } : ResponseWrapper extends {
     data: {
-      data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+      data: NoteTimelineItem[];
       size: number;
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
     data: {
-      data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+      data: NoteTimelineItem[];
       size: number;
     };
   }>;
   /**
    * 获取专栏内的所有日记
+   * @param topicId 专栏 ID
+   * @param page 页码，默认 1
+   * @param size 每页数量，默认 10
+   * @param options 可选参数，包含排序选项和 lang 用于获取翻译版本
    */
-  getNoteByTopicId(topicId: string, page?: number, size?: number, sortOptions?: SortOptions): RequestProxyResult<PaginateResult<NoteModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+  getNoteByTopicId(topicId: string, page?: number, size?: number, options?: NoteTopicListOptions): RequestProxyResult<PaginateResult<NoteTopicListItem>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: PaginateResult<NoteModel>;
+    data: PaginateResult<NoteTopicListItem>;
   } : ResponseWrapper extends {
-    data: PaginateResult<NoteModel>;
+    data: PaginateResult<NoteTopicListItem>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: PaginateResult<NoteModel>;
+    data: PaginateResult<NoteTopicListItem>;
   }>;
 }
 //#endregion
 //#region controllers/page.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     page: PageController<ResponseWrapper>;
   }
@@ -1511,7 +1533,7 @@ declare class PageController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/post.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     post: PostController<ResponseWrapper>;
   }
@@ -1521,7 +1543,13 @@ type PostListOptions = {
   year?: number;
   sortBy?: 'categoryId' | 'title' | 'created' | 'modified';
   sortOrder?: 1 | -1;
-  truncate?: number;
+  truncate?: number; /** 语言代码，用于获取翻译版本 */
+  lang?: string;
+};
+/** 文章列表项，可能包含翻译信息 */
+type PostListItem = PostModel & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
 };
 declare class PostController<ResponseWrapper> implements IController {
   private client;
@@ -1533,15 +1561,16 @@ declare class PostController<ResponseWrapper> implements IController {
    * 获取文章列表分页
    * @param page
    * @param perPage
-   * @returns
+   * @param options 可选参数，包含 lang 用于获取翻译版本
+   * @returns 当传入 lang 时，返回的文章可能包含 isTranslated 和 translationMeta 字段
    */
-  getList(page?: number, perPage?: number, options?: PostListOptions): RequestProxyResult<PaginateResult<PostModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+  getList(page?: number, perPage?: number, options?: PostListOptions): RequestProxyResult<PaginateResult<PostListItem>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: PaginateResult<PostModel>;
+    data: PaginateResult<PostListItem>;
   } : ResponseWrapper extends {
-    data: PaginateResult<PostModel>;
+    data: PaginateResult<PostListItem>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: PaginateResult<PostModel>;
+    data: PaginateResult<PostListItem>;
   }>;
   /**
    * 根据分类和路径查找文章
@@ -1587,7 +1616,7 @@ declare class PostController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/project.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     project: ProjectController<ResponseWrapper>;
   }
@@ -1600,7 +1629,7 @@ declare class ProjectController<ResponseWrapper> extends BaseCrudController<Proj
 }
 //#endregion
 //#region controllers/recently.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     recently: RecentlyController<ResponseWrapper>;
     shorthand: RecentlyController<ResponseWrapper>;
@@ -1731,7 +1760,7 @@ declare class RecentlyController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/say.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     say: SayController<ResponseWrapper>;
   }
@@ -1764,7 +1793,7 @@ declare class SayController<ResponseWrapper> extends BaseCrudController<SayModel
 }
 //#endregion
 //#region controllers/search.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     search: SearchController<ResponseWrapper>;
   }
@@ -1789,11 +1818,11 @@ declare class SearchController<ResponseWrapper> implements IController {
    * @param options
    * @returns
    */
-  searchByAlgolia(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+  searchByAlgolia(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
     type: "post";
-  }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+  }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
     type: "note";
-  }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+  }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
     type: "page";
   })> & {
     /**
@@ -1802,11 +1831,11 @@ declare class SearchController<ResponseWrapper> implements IController {
     raw?: any;
   }, ResponseWrapper>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
       type: "page";
     })> & {
       /**
@@ -1815,11 +1844,11 @@ declare class SearchController<ResponseWrapper> implements IController {
       raw?: any;
     }, ResponseWrapper>;
   } : ResponseWrapper extends {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
       type: "page";
     })> & {
       /**
@@ -1828,11 +1857,11 @@ declare class SearchController<ResponseWrapper> implements IController {
       raw?: any;
     }, ResponseWrapper>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
       type: "page";
     })> & {
       /**
@@ -1844,7 +1873,7 @@ declare class SearchController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/severless.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     serverless: ServerlessController<ResponseWrapper>;
   }
@@ -1866,7 +1895,7 @@ declare class ServerlessController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/snippet.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     snippet: SnippetController<ResponseWrapper>;
   }
@@ -1888,7 +1917,7 @@ declare class SnippetController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/subscribe.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     subscribe: SubscribeController<ResponseWrapper>;
   }
@@ -1949,7 +1978,7 @@ declare class SubscribeController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/topic.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     topic: TopicController<ResponseWrapper>;
   }
@@ -1971,7 +2000,7 @@ declare class TopicController<ResponseWrapper> extends BaseCrudController<TopicM
 }
 //#endregion
 //#region controllers/user.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     user: UserController<ResponseWrapper>;
     master: UserController<ResponseWrapper>;
@@ -2048,4 +2077,4 @@ declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate"
  */
 declare const camelcaseKeys: <T = any>(obj: any) => T;
 //#endregion
-export { AIController, AIDeepReadingModel, AISummaryModel, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentRef, CommentState, Coordinate, Count, EnumPageType, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LinkController, LinkModel, LinkState, LinkType, MailOptionsModel, ModelWithLiked, ModelWithTranslation, NoteController, NoteModel, NoteWrappedPayload, NoteWrappedWithLikedAndTranslationPayload, NoteWrappedWithLikedPayload, PageController, PageModel, Pager, PaginateResult, PostController, PostModel, ProjectController, ProjectModel, ReaderModel, RecentActivities, RecentComment, RecentLike, RecentNote, RecentPost, RecentRecent, RecentlyAttitudeEnum, RecentlyAttitudeResultEnum, RecentlyController, RecentlyModel, RecentlyRefType, RecentlyRefTypes, RequestError, RoomOmittedNote, RoomOmittedPage, RoomOmittedPost, RoomsData, SayController, SayModel, SearchController, SeoOptionModel, ServerlessController, SnippetController, SnippetModel, SnippetType, SubscribeAllBit, SubscribeController, SubscribeNoteCreateBit, SubscribePostCreateBit, SubscribeRecentCreateBit, SubscribeSayCreateBit, SubscribeType, SubscribeTypeToBitMap, TLogin, TagModel, TextBaseModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };
+export { AIController, AIDeepReadingModel, AISummaryModel, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentRef, CommentState, Coordinate, Count, EnumPageType, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LinkController, LinkModel, LinkState, LinkType, MailOptionsModel, ModelWithLiked, ModelWithTranslation, NoteController, type NoteMiddleListOptions, NoteModel, type NoteTimelineItem, type NoteTopicListItem, type NoteTopicListOptions, NoteWrappedPayload, NoteWrappedWithLikedAndTranslationPayload, NoteWrappedWithLikedPayload, PageController, PageModel, Pager, PaginateResult, PostController, type PostListItem, type PostListOptions, PostModel, ProjectController, ProjectModel, ReaderModel, RecentActivities, RecentComment, RecentLike, RecentNote, RecentPost, RecentRecent, RecentlyAttitudeEnum, RecentlyAttitudeResultEnum, RecentlyController, RecentlyModel, RecentlyRefType, RecentlyRefTypes, RequestError, RoomOmittedNote, RoomOmittedPage, RoomOmittedPost, RoomsData, SayController, SayModel, SearchController, SeoOptionModel, ServerlessController, SnippetController, SnippetModel, SnippetType, SubscribeAllBit, SubscribeController, SubscribeNoteCreateBit, SubscribePostCreateBit, SubscribeRecentCreateBit, SubscribeSayCreateBit, SubscribeType, SubscribeTypeToBitMap, TLogin, TagModel, TextBaseModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DLzJOGbI.cjs";
+import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-D1g1obyM.mjs";
 
 //#region interfaces/controller.d.ts
 interface IController {
@@ -100,7 +100,7 @@ declare class RequestError extends Error {
 }
 //#endregion
 //#region controllers/ack.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     ack: AckController<ResponseWrapper>;
   }
@@ -182,6 +182,7 @@ interface TranslationMeta {
 type ModelWithTranslation<T> = T & {
   isTranslated: boolean;
   translationMeta?: TranslationMeta;
+  availableTranslations?: string[];
 };
 //#endregion
 //#region models/post.d.ts
@@ -739,7 +740,7 @@ declare const SubscribeTypeToBitMap: {
 type SubscribeType = keyof typeof SubscribeTypeToBitMap;
 //#endregion
 //#region controllers/activity.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     activity: ActivityController<ResponseWrapper>;
   }
@@ -892,7 +893,7 @@ declare class ActivityController<ResponseWrapper> implements IController {
 type SortOrder = 'asc' | 'desc';
 //#endregion
 //#region controllers/aggregate.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     aggregate: AggregateController<ResponseWrapper>;
   }
@@ -952,7 +953,7 @@ declare class AggregateController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/ai.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     ai: AIController<ResponseWrapper>;
   }
@@ -1086,7 +1087,7 @@ declare class AIController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/category.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     category: CategoryController<ResponseWrapper>;
   }
@@ -1133,7 +1134,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         name: string;
         created: string;
         id: string;
-        children: Pick<PostModel, "id" | "title" | "slug" | "modified" | "created">[];
+        children: Pick<PostModel, "id" | "created" | "title" | "slug" | "modified">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1185,7 +1186,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         };
       }) ? T_1 extends unknown ? {
         tag: string;
-        data: Pick<PostModel, "category" | "id" | "title" | "slug" | "created">[];
+        data: Pick<PostModel, "category" | "id" | "created" | "title" | "slug">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1217,7 +1218,7 @@ interface CommentDto {
 }
 //#endregion
 //#region controllers/comment.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     comment: CommentController<ResponseWrapper>;
   }
@@ -1342,7 +1343,7 @@ declare abstract class BaseCrudController<T, ResponseWrapper> {
 }
 //#endregion
 //#region controllers/link.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     link: LinkController<ResponseWrapper>;
     friend: LinkController<ResponseWrapper>;
@@ -1360,7 +1361,7 @@ declare class LinkController<ResponseWrapper> extends BaseCrudController<LinkMod
 }
 //#endregion
 //#region controllers/note.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     note: NoteController<ResponseWrapper>;
   }
@@ -1376,6 +1377,20 @@ type NoteByNidOptions = {
   single?: boolean;
   lang?: string;
 };
+type NoteMiddleListOptions = {
+  lang?: string;
+};
+type NoteTopicListOptions = SortOptions & {
+  lang?: string;
+};
+type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'created' | 'isPublished'> & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
+};
+type NoteTopicListItem = NoteModel & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
+};
 declare class NoteController<ResponseWrapper> implements IController {
   private client;
   base: string;
@@ -1422,42 +1437,49 @@ declare class NoteController<ResponseWrapper> implements IController {
   }>;
   /**
    * 获取当前日记的上下各 n / 2 篇日记
+   * @param id 当前日记 ID
+   * @param size 返回数量，默认 5
+   * @param options 可选参数，包含 lang 用于获取翻译版本
    */
-  getMiddleList(id: string, size?: number): RequestProxyResult<{
-    data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+  getMiddleList(id: string, size?: number, options?: NoteMiddleListOptions): RequestProxyResult<{
+    data: NoteTimelineItem[];
     size: number;
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
     data: {
-      data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+      data: NoteTimelineItem[];
       size: number;
     };
   } : ResponseWrapper extends {
     data: {
-      data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+      data: NoteTimelineItem[];
       size: number;
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
     data: {
-      data: Pick<NoteModel, "id" | "title" | "nid" | "created" | "isPublished">[];
+      data: NoteTimelineItem[];
       size: number;
     };
   }>;
   /**
    * 获取专栏内的所有日记
+   * @param topicId 专栏 ID
+   * @param page 页码，默认 1
+   * @param size 每页数量，默认 10
+   * @param options 可选参数，包含排序选项和 lang 用于获取翻译版本
    */
-  getNoteByTopicId(topicId: string, page?: number, size?: number, sortOptions?: SortOptions): RequestProxyResult<PaginateResult<NoteModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+  getNoteByTopicId(topicId: string, page?: number, size?: number, options?: NoteTopicListOptions): RequestProxyResult<PaginateResult<NoteTopicListItem>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: PaginateResult<NoteModel>;
+    data: PaginateResult<NoteTopicListItem>;
   } : ResponseWrapper extends {
-    data: PaginateResult<NoteModel>;
+    data: PaginateResult<NoteTopicListItem>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: PaginateResult<NoteModel>;
+    data: PaginateResult<NoteTopicListItem>;
   }>;
 }
 //#endregion
 //#region controllers/page.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     page: PageController<ResponseWrapper>;
   }
@@ -1511,7 +1533,7 @@ declare class PageController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/post.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     post: PostController<ResponseWrapper>;
   }
@@ -1521,7 +1543,13 @@ type PostListOptions = {
   year?: number;
   sortBy?: 'categoryId' | 'title' | 'created' | 'modified';
   sortOrder?: 1 | -1;
-  truncate?: number;
+  truncate?: number; /** 语言代码，用于获取翻译版本 */
+  lang?: string;
+};
+/** 文章列表项，可能包含翻译信息 */
+type PostListItem = PostModel & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
 };
 declare class PostController<ResponseWrapper> implements IController {
   private client;
@@ -1533,15 +1561,16 @@ declare class PostController<ResponseWrapper> implements IController {
    * 获取文章列表分页
    * @param page
    * @param perPage
-   * @returns
+   * @param options 可选参数，包含 lang 用于获取翻译版本
+   * @returns 当传入 lang 时，返回的文章可能包含 isTranslated 和 translationMeta 字段
    */
-  getList(page?: number, perPage?: number, options?: PostListOptions): RequestProxyResult<PaginateResult<PostModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+  getList(page?: number, perPage?: number, options?: PostListOptions): RequestProxyResult<PaginateResult<PostListItem>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: PaginateResult<PostModel>;
+    data: PaginateResult<PostListItem>;
   } : ResponseWrapper extends {
-    data: PaginateResult<PostModel>;
+    data: PaginateResult<PostListItem>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: PaginateResult<PostModel>;
+    data: PaginateResult<PostListItem>;
   }>;
   /**
    * 根据分类和路径查找文章
@@ -1587,7 +1616,7 @@ declare class PostController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/project.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     project: ProjectController<ResponseWrapper>;
   }
@@ -1600,7 +1629,7 @@ declare class ProjectController<ResponseWrapper> extends BaseCrudController<Proj
 }
 //#endregion
 //#region controllers/recently.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     recently: RecentlyController<ResponseWrapper>;
     shorthand: RecentlyController<ResponseWrapper>;
@@ -1731,7 +1760,7 @@ declare class RecentlyController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/say.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     say: SayController<ResponseWrapper>;
   }
@@ -1764,7 +1793,7 @@ declare class SayController<ResponseWrapper> extends BaseCrudController<SayModel
 }
 //#endregion
 //#region controllers/search.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     search: SearchController<ResponseWrapper>;
   }
@@ -1789,11 +1818,11 @@ declare class SearchController<ResponseWrapper> implements IController {
    * @param options
    * @returns
    */
-  searchByAlgolia(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+  searchByAlgolia(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
     type: "post";
-  }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+  }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
     type: "note";
-  }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+  }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
     type: "page";
   })> & {
     /**
@@ -1802,11 +1831,11 @@ declare class SearchController<ResponseWrapper> implements IController {
     raw?: any;
   }, ResponseWrapper>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
       type: "page";
     })> & {
       /**
@@ -1815,11 +1844,11 @@ declare class SearchController<ResponseWrapper> implements IController {
       raw?: any;
     }, ResponseWrapper>;
   } : ResponseWrapper extends {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
       type: "page";
     })> & {
       /**
@@ -1828,11 +1857,11 @@ declare class SearchController<ResponseWrapper> implements IController {
       raw?: any;
     }, ResponseWrapper>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
       type: "page";
     })> & {
       /**
@@ -1844,7 +1873,7 @@ declare class SearchController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/severless.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     serverless: ServerlessController<ResponseWrapper>;
   }
@@ -1866,7 +1895,7 @@ declare class ServerlessController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/snippet.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     snippet: SnippetController<ResponseWrapper>;
   }
@@ -1888,7 +1917,7 @@ declare class SnippetController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/subscribe.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     subscribe: SubscribeController<ResponseWrapper>;
   }
@@ -1949,7 +1978,7 @@ declare class SubscribeController<ResponseWrapper> implements IController {
 }
 //#endregion
 //#region controllers/topic.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     topic: TopicController<ResponseWrapper>;
   }
@@ -1971,7 +2000,7 @@ declare class TopicController<ResponseWrapper> extends BaseCrudController<TopicM
 }
 //#endregion
 //#region controllers/user.d.ts
-declare module '@mx-space/api-client' {
+declare module '../core/client' {
   interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
     user: UserController<ResponseWrapper>;
     master: UserController<ResponseWrapper>;
@@ -2048,4 +2077,4 @@ declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate"
  */
 declare const camelcaseKeys: <T = any>(obj: any) => T;
 //#endregion
-export { AIController, AIDeepReadingModel, AISummaryModel, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentRef, CommentState, Coordinate, Count, EnumPageType, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LinkController, LinkModel, LinkState, LinkType, MailOptionsModel, ModelWithLiked, ModelWithTranslation, NoteController, NoteModel, NoteWrappedPayload, NoteWrappedWithLikedAndTranslationPayload, NoteWrappedWithLikedPayload, PageController, PageModel, Pager, PaginateResult, PostController, PostModel, ProjectController, ProjectModel, ReaderModel, RecentActivities, RecentComment, RecentLike, RecentNote, RecentPost, RecentRecent, RecentlyAttitudeEnum, RecentlyAttitudeResultEnum, RecentlyController, RecentlyModel, RecentlyRefType, RecentlyRefTypes, RequestError, RoomOmittedNote, RoomOmittedPage, RoomOmittedPost, RoomsData, SayController, SayModel, SearchController, SeoOptionModel, ServerlessController, SnippetController, SnippetModel, SnippetType, SubscribeAllBit, SubscribeController, SubscribeNoteCreateBit, SubscribePostCreateBit, SubscribeRecentCreateBit, SubscribeSayCreateBit, SubscribeType, SubscribeTypeToBitMap, TLogin, TagModel, TextBaseModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };
+export { AIController, AIDeepReadingModel, AISummaryModel, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentRef, CommentState, Coordinate, Count, EnumPageType, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LinkController, LinkModel, LinkState, LinkType, MailOptionsModel, ModelWithLiked, ModelWithTranslation, NoteController, type NoteMiddleListOptions, NoteModel, type NoteTimelineItem, type NoteTopicListItem, type NoteTopicListOptions, NoteWrappedPayload, NoteWrappedWithLikedAndTranslationPayload, NoteWrappedWithLikedPayload, PageController, PageModel, Pager, PaginateResult, PostController, type PostListItem, type PostListOptions, PostModel, ProjectController, ProjectModel, ReaderModel, RecentActivities, RecentComment, RecentLike, RecentNote, RecentPost, RecentRecent, RecentlyAttitudeEnum, RecentlyAttitudeResultEnum, RecentlyController, RecentlyModel, RecentlyRefType, RecentlyRefTypes, RequestError, RoomOmittedNote, RoomOmittedPage, RoomOmittedPost, RoomsData, SayController, SayModel, SearchController, SeoOptionModel, ServerlessController, SnippetController, SnippetModel, SnippetType, SubscribeAllBit, SubscribeController, SubscribeNoteCreateBit, SubscribePostCreateBit, SubscribeRecentCreateBit, SubscribeSayCreateBit, SubscribeType, SubscribeTypeToBitMap, TLogin, TagModel, TextBaseModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };

package/dist/index.mjs

@@ -453,17 +453,30 @@ var NoteController = class {
 	}
 	/**
 	* 获取当前日记的上下各 n / 2 篇日记
+	* @param id 当前日记 ID
+	* @param size 返回数量，默认 5
+	* @param options 可选参数，包含 lang 用于获取翻译版本
 	*/
-	getMiddleList(id, size = 5) {
-		return this.proxy.list(id).get({ params: { size } });
+	getMiddleList(id, size = 5, options) {
+		const { lang } = options || {};
+		return this.proxy.list(id).get({ params: {
+			size,
+			lang
+		} });
 	}
 	/**
 	* 获取专栏内的所有日记
+	* @param topicId 专栏 ID
+	* @param page 页码，默认 1
+	* @param size 每页数量，默认 10
+	* @param options 可选参数，包含排序选项和 lang 用于获取翻译版本
 	*/
-	getNoteByTopicId(topicId, page = 1, size = 10, sortOptions = {}) {
+	getNoteByTopicId(topicId, page = 1, size = 10, options = {}) {
+		const { lang, ...sortOptions } = options;
 		return this.proxy.topics(topicId).get({ params: {
 			page,
 			size,
+			lang,
 			...sortOptions
 		} });
 	}
@@ -526,10 +539,11 @@ var PostController = class {
 	* 获取文章列表分页
 	* @param page
 	* @param perPage
-	* @returns
+	* @param options 可选参数，包含 lang 用于获取翻译版本
+	* @returns 当传入 lang 时，返回的文章可能包含 isTranslated 和 translationMeta 字段
 	*/
 	getList(page = 1, perPage = 10, options = {}) {
-		const { select, sortBy, sortOrder, year, truncate } = options;
+		const { select, sortBy, sortOrder, year, truncate, lang } = options;
 		return this.proxy.get({ params: {
 			page,
 			size: perPage,
@@ -537,7 +551,8 @@ var PostController = class {
 			sortBy,
 			sortOrder,
 			year,
-			truncate
+			truncate,
+			lang
 		} });
 	}
 	getPost(idOrCategoryName, slug, options) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/api-client",
-  "version": "1.20.0",
+  "version": "1.21.1",
   "description": "A api client for mx-space server@next",
   "type": "module",
   "engines": {
@@ -42,13 +42,6 @@
     "tag": false,
     "commit_message": "chore(release): bump @mx-space/api-client to v${NEW_VERSION}"
   },
-  "scripts": {
-    "package": "rm -rf dist && tsdown && node mod-dts.mjs",
-    "build": "npm run package",
-    "prepackage": "rm -rf dist",
-    "test": "vitest",
-    "dev": "vitest"
-  },
   "devDependencies": {
     "@types/cors": "2.8.19",
     "@types/express": "5.0.6",
@@ -63,5 +56,12 @@
     "umi-request": "1.4.0",
     "vite": "^7.3.1",
     "vitest": "4.0.18"
+  },
+  "scripts": {
+    "package": "rm -rf dist && tsdown && node mod-dts.mjs",
+    "build": "npm run package",
+    "prepackage": "rm -rf dist",
+    "test": "vitest",
+    "dev": "vitest"
   }
-}
+}