@mx-space/api-client 1.19.1 → 1.21.0

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/axios.d.cts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter } from "../adapter-B1dtiutp.cjs";
+import { n as IRequestAdapter } from "../adapter-DLzJOGbI.cjs";
 import { AxiosInstance, AxiosResponse } from "axios";
 
 //#region adaptors/axios.d.ts

package/dist/adaptors/axios.d.mts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter } from "../adapter-CRsPadpS.mjs";
+import { n as IRequestAdapter } from "../adapter-D1g1obyM.mjs";
 import { AxiosInstance, AxiosResponse } from "axios";
 
 //#region adaptors/axios.d.ts

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/fetch.d.cts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter } from "../adapter-B1dtiutp.cjs";
+import { n as IRequestAdapter } from "../adapter-DLzJOGbI.cjs";
 
 //#region adaptors/fetch.d.ts
 declare const fetchAdaptor: IRequestAdapter<typeof fetch>;

package/dist/adaptors/fetch.d.mts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter } from "../adapter-CRsPadpS.mjs";
+import { n as IRequestAdapter } from "../adapter-D1g1obyM.mjs";
 
 //#region adaptors/fetch.d.ts
 declare const fetchAdaptor: IRequestAdapter<typeof fetch>;

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/adaptors/umi-request.d.cts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter } from "../adapter-B1dtiutp.cjs";
+import { n as IRequestAdapter } from "../adapter-DLzJOGbI.cjs";
 import { RequestMethod, RequestResponse } from "umi-request";
 
 //#region adaptors/umi-request.d.ts

package/dist/adaptors/umi-request.d.mts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter } from "../adapter-CRsPadpS.mjs";
+import { n as IRequestAdapter } from "../adapter-D1g1obyM.mjs";
 import { RequestMethod, RequestResponse } from "umi-request";
 
 //#region adaptors/umi-request.d.ts

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;
@@ -427,6 +427,19 @@ var NoteController = class {
 		else return this.proxy(id).get();
 	}
 	/**
+	* 根据 nid 获取日记，支持翻译参数
+	* @param nid 日记编号
+	* @param options 可选参数：password, single, lang
+	*/
+	getNoteByNid(nid, options) {
+		const { password, single, lang } = options || {};
+		return this.proxy.nid(nid.toString()).get({ params: {
+			password,
+			single: single ? "1" : void 0,
+			lang
+		} });
+	}
+	/**
 	* 日记列表分页
 	*/
 	getList(page = 1, perPage = 10, options = {}) {
@@ -515,10 +528,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,
@@ -526,12 +540,13 @@ var PostController = class {
 			sortBy,
 			sortOrder,
 			year,
-			truncate
+			truncate,
+			lang
 		} });
 	}
-	getPost(idOrCategoryName, slug) {
+	getPost(idOrCategoryName, slug, options) {
 		if (arguments.length == 1) return this.proxy(idOrCategoryName).get();
-		else return this.proxy(idOrCategoryName)(slug).get();
+		else return this.proxy(idOrCategoryName)(slug).get({ params: options?.lang ? { lang: options.lang } : void 0 });
 	}
 	/**
 	* 获取最新的文章

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-B1dtiutp.cjs";
+import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DLzJOGbI.cjs";
 
 //#region interfaces/controller.d.ts
 interface IController {
@@ -174,6 +174,16 @@ interface TextBaseModel extends BaseCommentIndexModel {
 type ModelWithLiked<T> = T & {
   liked: boolean;
 };
+interface TranslationMeta {
+  sourceLang: string;
+  targetLang: string;
+  translatedAt: string;
+}
+type ModelWithTranslation<T> = T & {
+  isTranslated: boolean;
+  translationMeta?: TranslationMeta;
+  availableTranslations?: string[];
+};
 //#endregion
 //#region models/post.d.ts
 interface PostModel extends TextBaseModel {
@@ -374,6 +384,11 @@ interface NoteWrappedWithLikedPayload {
   next?: Partial<NoteModel>;
   prev?: Partial<NoteModel>;
 }
+interface NoteWrappedWithLikedAndTranslationPayload {
+  data: ModelWithLiked<ModelWithTranslation<NoteModel>>;
+  next?: Partial<NoteModel>;
+  prev?: Partial<NoteModel>;
+}
 //#endregion
 //#region models/page.d.ts
 declare enum EnumPageType {
@@ -1357,6 +1372,11 @@ type NoteListOptions = {
   sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified';
   sortOrder?: 1 | -1;
 };
+type NoteByNidOptions = {
+  password?: string;
+  single?: boolean;
+  lang?: string;
+};
 declare class NoteController<ResponseWrapper> implements IController {
   private client;
   base: string;
@@ -1384,6 +1404,12 @@ declare class NoteController<ResponseWrapper> implements IController {
   getNoteById(id: number, password: string): Promise<NoteWrappedPayload>;
   getNoteById(id: number, password: undefined, singleResult: true): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
   getNoteById(id: number, password: string, singleResult: true): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
+  /**
+   * 根据 nid 获取日记，支持翻译参数
+   * @param nid 日记编号
+   * @param options 可选参数：password, single, lang
+   */
+  getNoteByNid(nid: number, options?: NoteByNidOptions): RequestProxyResult<NoteWrappedWithLikedAndTranslationPayload, ResponseWrapper>;
   /**
    * 日记列表分页
    */
@@ -1496,7 +1522,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;
@@ -1508,22 +1540,26 @@ 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>;
   }>;
   /**
    * 根据分类和路径查找文章
    * @param categoryName
    * @param slug
+   * @param options 可选参数，包含 lang 用于获取翻译版本
    */
-  getPost(categoryName: string, slug: string): RequestProxyResult<ModelWithLiked<PostModel>, ResponseWrapper>;
+  getPost(categoryName: string, slug: string, options?: {
+    lang?: string;
+  }): RequestProxyResult<ModelWithLiked<ModelWithTranslation<PostModel>>, ResponseWrapper>;
   /**
    * 根据 ID 查找文章
    * @param id
@@ -2020,4 +2056,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, NoteController, NoteModel, NoteWrappedPayload, 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, 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, NoteModel, 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-B1dtiutp.cjs";
+import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DLzJOGbI.cjs";
 
 //#region interfaces/controller.d.ts
 interface IController {
@@ -174,6 +174,16 @@ interface TextBaseModel extends BaseCommentIndexModel {
 type ModelWithLiked<T> = T & {
   liked: boolean;
 };
+interface TranslationMeta {
+  sourceLang: string;
+  targetLang: string;
+  translatedAt: string;
+}
+type ModelWithTranslation<T> = T & {
+  isTranslated: boolean;
+  translationMeta?: TranslationMeta;
+  availableTranslations?: string[];
+};
 //#endregion
 //#region models/post.d.ts
 interface PostModel extends TextBaseModel {
@@ -374,6 +384,11 @@ interface NoteWrappedWithLikedPayload {
   next?: Partial<NoteModel>;
   prev?: Partial<NoteModel>;
 }
+interface NoteWrappedWithLikedAndTranslationPayload {
+  data: ModelWithLiked<ModelWithTranslation<NoteModel>>;
+  next?: Partial<NoteModel>;
+  prev?: Partial<NoteModel>;
+}
 //#endregion
 //#region models/page.d.ts
 declare enum EnumPageType {
@@ -1357,6 +1372,11 @@ type NoteListOptions = {
   sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified';
   sortOrder?: 1 | -1;
 };
+type NoteByNidOptions = {
+  password?: string;
+  single?: boolean;
+  lang?: string;
+};
 declare class NoteController<ResponseWrapper> implements IController {
   private client;
   base: string;
@@ -1384,6 +1404,12 @@ declare class NoteController<ResponseWrapper> implements IController {
   getNoteById(id: number, password: string): Promise<NoteWrappedPayload>;
   getNoteById(id: number, password: undefined, singleResult: true): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
   getNoteById(id: number, password: string, singleResult: true): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
+  /**
+   * 根据 nid 获取日记，支持翻译参数
+   * @param nid 日记编号
+   * @param options 可选参数：password, single, lang
+   */
+  getNoteByNid(nid: number, options?: NoteByNidOptions): RequestProxyResult<NoteWrappedWithLikedAndTranslationPayload, ResponseWrapper>;
   /**
    * 日记列表分页
    */
@@ -1496,7 +1522,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;
@@ -1508,22 +1540,26 @@ 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>;
   }>;
   /**
    * 根据分类和路径查找文章
    * @param categoryName
    * @param slug
+   * @param options 可选参数，包含 lang 用于获取翻译版本
    */
-  getPost(categoryName: string, slug: string): RequestProxyResult<ModelWithLiked<PostModel>, ResponseWrapper>;
+  getPost(categoryName: string, slug: string, options?: {
+    lang?: string;
+  }): RequestProxyResult<ModelWithLiked<ModelWithTranslation<PostModel>>, ResponseWrapper>;
   /**
    * 根据 ID 查找文章
    * @param id
@@ -2020,4 +2056,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, NoteController, NoteModel, NoteWrappedPayload, 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, 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, NoteModel, 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

@@ -425,6 +425,19 @@ var NoteController = class {
 		else return this.proxy(id).get();
 	}
 	/**
+	* 根据 nid 获取日记，支持翻译参数
+	* @param nid 日记编号
+	* @param options 可选参数：password, single, lang
+	*/
+	getNoteByNid(nid, options) {
+		const { password, single, lang } = options || {};
+		return this.proxy.nid(nid.toString()).get({ params: {
+			password,
+			single: single ? "1" : void 0,
+			lang
+		} });
+	}
+	/**
 	* 日记列表分页
 	*/
 	getList(page = 1, perPage = 10, options = {}) {
@@ -513,10 +526,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,
@@ -524,12 +538,13 @@ var PostController = class {
 			sortBy,
 			sortOrder,
 			year,
-			truncate
+			truncate,
+			lang
 		} });
 	}
-	getPost(idOrCategoryName, slug) {
+	getPost(idOrCategoryName, slug, options) {
 		if (arguments.length == 1) return this.proxy(idOrCategoryName).get();
-		else return this.proxy(idOrCategoryName)(slug).get();
+		else return this.proxy(idOrCategoryName)(slug).get({ params: options?.lang ? { lang: options.lang } : void 0 });
 	}
 	/**
 	* 获取最新的文章

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/api-client",
-  "version": "1.19.1",
+  "version": "1.21.0",
   "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"
   }
-}
+}