@mx-space/api-client 2.1.1 → 2.2.0

package/dist/adaptors/axios.cjs

@@ -56,9 +56,8 @@ const axiosAdaptor = Object.preventExtensions({
 		return $http.patch(url, data, config);
 	}
 });
-var axios_default = axiosAdaptor;
 
 //#endregion
 exports.__toESM = __toESM;
 exports.axiosAdaptor = axiosAdaptor;
-exports.default = axios_default;
+exports.default = axiosAdaptor;

package/dist/adaptors/axios.mjs

@@ -27,7 +27,6 @@ const axiosAdaptor = Object.preventExtensions({
 		return $http.patch(url, data, config);
 	}
 });
-var axios_default = axiosAdaptor;
 
 //#endregion
-export { axiosAdaptor, axios_default as default };
+export { axiosAdaptor, axiosAdaptor as default };

package/dist/adaptors/umi-request.cjs

@@ -29,8 +29,7 @@ const umiAdaptor = Object.preventExtensions({
 		return $http.patch(url, options);
 	}
 });
-var umi_request_default = umiAdaptor;
 
 //#endregion
-exports.default = umi_request_default;
+exports.default = umiAdaptor;
 exports.umiAdaptor = umiAdaptor;

package/dist/adaptors/umi-request.mjs

@@ -27,7 +27,6 @@ const umiAdaptor = Object.preventExtensions({
 		return $http.patch(url, options);
 	}
 });
-var umi_request_default = umiAdaptor;
 
 //#endregion
-export { umi_request_default as default, umiAdaptor };
+export { umiAdaptor as default, umiAdaptor };

package/dist/index.cjs

@@ -201,6 +201,14 @@ var AggregateController = class {
 			year
 		} });
 	}
+	getLatest(options) {
+		const { limit, types, combined } = options || {};
+		return this.proxy.latest.get({ params: {
+			limit,
+			types: types?.join(","),
+			combined
+		} });
+	}
 	/**
 	* 获取聚合数据统计
 	*/
@@ -414,6 +422,9 @@ var CommentController = class {
 			size: size || 10
 		} });
 	}
+	getThreadReplies(rootCommentId, params = {}) {
+		return this.proxy.thread(rootCommentId).get({ params });
+	}
 	/**
 	* 评论
 	*/
@@ -517,18 +528,29 @@ var NoteController = class {
 			prefer
 		} });
 	}
+	getNoteBySlugDate(year, month, day, slug, options) {
+		const { password, single, lang, prefer } = options || {};
+		return this.proxy(year.toString())(month.toString())(day.toString())(slug).get({ params: {
+			password,
+			single: single ? "1" : void 0,
+			lang,
+			prefer
+		} });
+	}
 	/**
 	* 日记列表分页
 	*/
 	getList(page = 1, perPage = 10, options = {}) {
-		const { select, sortBy, sortOrder, year } = options;
+		const { select, sortBy, sortOrder, year, lang, withSummary } = options;
 		return this.proxy.get({ params: {
 			page,
 			size: perPage,
 			select: select?.join(" "),
 			sortBy,
 			sortOrder,
-			year
+			year,
+			lang,
+			withSummary: withSummary ? "1" : void 0
 		} });
 	}
 	/**

package/dist/index.d.cts

@@ -376,6 +376,7 @@ type NoteModel = TextBaseModel & {
   publicAt?: Date;
   password?: string | null;
   nid: number;
+  slug?: string;
   location?: string;
   coordinates?: Coordinate;
   topic?: TopicModel;
@@ -622,6 +623,19 @@ interface TimelineData {
     url: string;
   })[];
 }
+interface LatestPostItem extends Pick<PostModel, 'id' | 'title' | 'slug' | 'created' | 'modified' | 'tags'> {
+  category: Pick<CategoryModel, 'name' | 'slug'> | null;
+}
+interface LatestNoteItem extends Pick<NoteModel, 'id' | 'title' | 'nid' | 'created' | 'modified' | 'mood' | 'weather' | 'bookmark'> {}
+interface LatestData {
+  posts?: LatestPostItem[];
+  notes?: LatestNoteItem[];
+}
+type LatestCombinedItem = (LatestPostItem & {
+  type: 'post';
+}) | (LatestNoteItem & {
+  type: 'note';
+});
 interface AggregateStat {
   allComments: number;
   categories: number;
@@ -717,24 +731,44 @@ interface CommentModel extends BaseModel {
   refType: CollectionRefTypes;
   ref: string;
   state: number;
-  commentsIndex: number;
   author: string;
   text: string;
   mail?: string;
   url?: string;
   ip?: string;
   agent?: string;
-  key: string;
   pin?: boolean;
   avatar: string;
-  parent?: CommentModel | string;
-  children: CommentModel[];
+  parentCommentId?: string | null;
+  rootCommentId?: string | null;
+  replyCount?: number;
+  latestReplyAt?: string | null;
+  isDeleted?: boolean;
+  deletedAt?: string;
   isWhispers?: boolean;
   location?: string;
   source?: string;
   readerId?: string;
   editedAt?: string;
 }
+interface CommentReplyWindow {
+  total: number;
+  returned: number;
+  threshold: number;
+  hasHidden: boolean;
+  hiddenCount: number;
+  nextCursor?: string;
+}
+interface CommentThreadItem extends CommentModel {
+  replies: CommentModel[];
+  replyWindow: CommentReplyWindow;
+}
+interface CommentThreadReplies {
+  replies: CommentModel[];
+  nextCursor?: string;
+  remaining: number;
+  done: boolean;
+}
 interface CommentRef {
   id: string;
   categoryId?: string;
@@ -1050,6 +1084,16 @@ declare class AggregateController<ResponseWrapper> implements IController {
       data: TimelineData;
     };
   }>;
+  getLatest(options: {
+    limit?: number;
+    types?: TimelineType[];
+    combined: true;
+  }): RequestProxyResult<LatestCombinedItem[], ResponseWrapper>;
+  getLatest(options?: {
+    limit?: number;
+    types?: TimelineType[];
+    combined?: false;
+  }): RequestProxyResult<LatestData, ResponseWrapper>;
   /**
    * 获取聚合数据统计
    */
@@ -1571,30 +1615,40 @@ declare class CommentController<ResponseWrapper> implements IController {
    * 获取文章的评论列表
    * @param refId 文章 Id
    */
-  getByRefId(refId: string, pagination?: PaginationParams): RequestProxyResult<PaginateResult<CommentModel & {
+  getByRefId(refId: string, pagination?: PaginationParams): RequestProxyResult<PaginateResult<CommentThreadItem & {
     ref: string;
   }> & {
     readers: Record<string, ReaderModel>;
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: PaginateResult<CommentModel & {
+    data: PaginateResult<CommentThreadItem & {
       ref: string;
     }> & {
       readers: Record<string, ReaderModel>;
     };
   } : ResponseWrapper extends {
-    data: PaginateResult<CommentModel & {
+    data: PaginateResult<CommentThreadItem & {
       ref: string;
     }> & {
       readers: Record<string, ReaderModel>;
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: PaginateResult<CommentModel & {
+    data: PaginateResult<CommentThreadItem & {
       ref: string;
     }> & {
       readers: Record<string, ReaderModel>;
     };
   }>;
+  getThreadReplies(rootCommentId: string, params?: PaginationParams & {
+    cursor?: string;
+  }): RequestProxyResult<CommentThreadReplies, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentThreadReplies;
+  } : ResponseWrapper extends {
+    data: CommentThreadReplies;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentThreadReplies;
+  }>;
   /**
    * 评论
    */
@@ -1690,6 +1744,8 @@ type NoteListOptions = {
   year?: number;
   sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified';
   sortOrder?: 1 | -1;
+  lang?: string;
+  withSummary?: boolean;
 };
 type NoteByNidOptions = {
   password?: string;
@@ -1697,13 +1753,14 @@ type NoteByNidOptions = {
   lang?: string;
   prefer?: 'lexical';
 };
+type NoteBySlugDateOptions = NoteByNidOptions;
 type NoteMiddleListOptions = {
   lang?: string;
 };
 type NoteTopicListOptions = SortOptions & {
   lang?: string;
 };
-type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'created' | 'isPublished'> & {
+type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'slug' | 'created' | 'isPublished'> & {
   isTranslated?: boolean;
   translationMeta?: TranslationMeta;
 };
@@ -1744,6 +1801,7 @@ declare class NoteController<ResponseWrapper> implements IController {
    * @param options 可选参数：password, single, lang
    */
   getNoteByNid(nid: number, options?: NoteByNidOptions): RequestProxyResult<NoteWrappedWithLikedAndTranslationPayload, ResponseWrapper>;
+  getNoteBySlugDate(year: number, month: number, day: number, slug: string, options?: NoteBySlugDateOptions): RequestProxyResult<NoteWrappedWithLikedAndTranslationPayload, ResponseWrapper>;
   /**
    * 日记列表分页
    */
@@ -2500,4 +2558,4 @@ declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate"
  */
 declare const camelcaseKeys: <T = any>(obj: any) => T;
 //#endregion
-export { AIController, AIDeepReadingModel, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CheckLoggedResult, 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, OwnerAllowLoginResult, OwnerSessionResult, 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, TextBaseModelLexical, TextBaseModelMarkdown, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };
+export { AIController, AIDeepReadingModel, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CheckLoggedResult, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentRef, CommentReplyWindow, CommentState, CommentThreadItem, CommentThreadReplies, Coordinate, Count, EnumPageType, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LatestCombinedItem, LatestData, LatestNoteItem, LatestPostItem, LinkController, LinkModel, LinkState, LinkType, MailOptionsModel, ModelWithLiked, ModelWithTranslation, NoteController, type NoteMiddleListOptions, NoteModel, type NoteTimelineItem, type NoteTopicListItem, type NoteTopicListOptions, NoteWrappedPayload, NoteWrappedWithLikedAndTranslationPayload, NoteWrappedWithLikedPayload, OwnerAllowLoginResult, OwnerSessionResult, 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, TextBaseModelLexical, TextBaseModelMarkdown, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };

package/dist/index.d.mts

@@ -376,6 +376,7 @@ type NoteModel = TextBaseModel & {
   publicAt?: Date;
   password?: string | null;
   nid: number;
+  slug?: string;
   location?: string;
   coordinates?: Coordinate;
   topic?: TopicModel;
@@ -622,6 +623,19 @@ interface TimelineData {
     url: string;
   })[];
 }
+interface LatestPostItem extends Pick<PostModel, 'id' | 'title' | 'slug' | 'created' | 'modified' | 'tags'> {
+  category: Pick<CategoryModel, 'name' | 'slug'> | null;
+}
+interface LatestNoteItem extends Pick<NoteModel, 'id' | 'title' | 'nid' | 'created' | 'modified' | 'mood' | 'weather' | 'bookmark'> {}
+interface LatestData {
+  posts?: LatestPostItem[];
+  notes?: LatestNoteItem[];
+}
+type LatestCombinedItem = (LatestPostItem & {
+  type: 'post';
+}) | (LatestNoteItem & {
+  type: 'note';
+});
 interface AggregateStat {
   allComments: number;
   categories: number;
@@ -717,24 +731,44 @@ interface CommentModel extends BaseModel {
   refType: CollectionRefTypes;
   ref: string;
   state: number;
-  commentsIndex: number;
   author: string;
   text: string;
   mail?: string;
   url?: string;
   ip?: string;
   agent?: string;
-  key: string;
   pin?: boolean;
   avatar: string;
-  parent?: CommentModel | string;
-  children: CommentModel[];
+  parentCommentId?: string | null;
+  rootCommentId?: string | null;
+  replyCount?: number;
+  latestReplyAt?: string | null;
+  isDeleted?: boolean;
+  deletedAt?: string;
   isWhispers?: boolean;
   location?: string;
   source?: string;
   readerId?: string;
   editedAt?: string;
 }
+interface CommentReplyWindow {
+  total: number;
+  returned: number;
+  threshold: number;
+  hasHidden: boolean;
+  hiddenCount: number;
+  nextCursor?: string;
+}
+interface CommentThreadItem extends CommentModel {
+  replies: CommentModel[];
+  replyWindow: CommentReplyWindow;
+}
+interface CommentThreadReplies {
+  replies: CommentModel[];
+  nextCursor?: string;
+  remaining: number;
+  done: boolean;
+}
 interface CommentRef {
   id: string;
   categoryId?: string;
@@ -1050,6 +1084,16 @@ declare class AggregateController<ResponseWrapper> implements IController {
       data: TimelineData;
     };
   }>;
+  getLatest(options: {
+    limit?: number;
+    types?: TimelineType[];
+    combined: true;
+  }): RequestProxyResult<LatestCombinedItem[], ResponseWrapper>;
+  getLatest(options?: {
+    limit?: number;
+    types?: TimelineType[];
+    combined?: false;
+  }): RequestProxyResult<LatestData, ResponseWrapper>;
   /**
    * 获取聚合数据统计
    */
@@ -1571,30 +1615,40 @@ declare class CommentController<ResponseWrapper> implements IController {
    * 获取文章的评论列表
    * @param refId 文章 Id
    */
-  getByRefId(refId: string, pagination?: PaginationParams): RequestProxyResult<PaginateResult<CommentModel & {
+  getByRefId(refId: string, pagination?: PaginationParams): RequestProxyResult<PaginateResult<CommentThreadItem & {
     ref: string;
   }> & {
     readers: Record<string, ReaderModel>;
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: PaginateResult<CommentModel & {
+    data: PaginateResult<CommentThreadItem & {
       ref: string;
     }> & {
       readers: Record<string, ReaderModel>;
     };
   } : ResponseWrapper extends {
-    data: PaginateResult<CommentModel & {
+    data: PaginateResult<CommentThreadItem & {
       ref: string;
     }> & {
       readers: Record<string, ReaderModel>;
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: PaginateResult<CommentModel & {
+    data: PaginateResult<CommentThreadItem & {
       ref: string;
     }> & {
       readers: Record<string, ReaderModel>;
     };
   }>;
+  getThreadReplies(rootCommentId: string, params?: PaginationParams & {
+    cursor?: string;
+  }): RequestProxyResult<CommentThreadReplies, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentThreadReplies;
+  } : ResponseWrapper extends {
+    data: CommentThreadReplies;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentThreadReplies;
+  }>;
   /**
    * 评论
    */
@@ -1690,6 +1744,8 @@ type NoteListOptions = {
   year?: number;
   sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified';
   sortOrder?: 1 | -1;
+  lang?: string;
+  withSummary?: boolean;
 };
 type NoteByNidOptions = {
   password?: string;
@@ -1697,13 +1753,14 @@ type NoteByNidOptions = {
   lang?: string;
   prefer?: 'lexical';
 };
+type NoteBySlugDateOptions = NoteByNidOptions;
 type NoteMiddleListOptions = {
   lang?: string;
 };
 type NoteTopicListOptions = SortOptions & {
   lang?: string;
 };
-type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'created' | 'isPublished'> & {
+type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'slug' | 'created' | 'isPublished'> & {
   isTranslated?: boolean;
   translationMeta?: TranslationMeta;
 };
@@ -1744,6 +1801,7 @@ declare class NoteController<ResponseWrapper> implements IController {
    * @param options 可选参数：password, single, lang
    */
   getNoteByNid(nid: number, options?: NoteByNidOptions): RequestProxyResult<NoteWrappedWithLikedAndTranslationPayload, ResponseWrapper>;
+  getNoteBySlugDate(year: number, month: number, day: number, slug: string, options?: NoteBySlugDateOptions): RequestProxyResult<NoteWrappedWithLikedAndTranslationPayload, ResponseWrapper>;
   /**
    * 日记列表分页
    */
@@ -2500,4 +2558,4 @@ declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate"
  */
 declare const camelcaseKeys: <T = any>(obj: any) => T;
 //#endregion
-export { AIController, AIDeepReadingModel, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CheckLoggedResult, 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, OwnerAllowLoginResult, OwnerSessionResult, 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, TextBaseModelLexical, TextBaseModelMarkdown, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };
+export { AIController, AIDeepReadingModel, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CheckLoggedResult, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentRef, CommentReplyWindow, CommentState, CommentThreadItem, CommentThreadReplies, Coordinate, Count, EnumPageType, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LatestCombinedItem, LatestData, LatestNoteItem, LatestPostItem, LinkController, LinkModel, LinkState, LinkType, MailOptionsModel, ModelWithLiked, ModelWithTranslation, NoteController, type NoteMiddleListOptions, NoteModel, type NoteTimelineItem, type NoteTopicListItem, type NoteTopicListOptions, NoteWrappedPayload, NoteWrappedWithLikedAndTranslationPayload, NoteWrappedWithLikedPayload, OwnerAllowLoginResult, OwnerSessionResult, 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, TextBaseModelLexical, TextBaseModelMarkdown, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };

package/dist/index.mjs

@@ -199,6 +199,14 @@ var AggregateController = class {
 			year
 		} });
 	}
+	getLatest(options) {
+		const { limit, types, combined } = options || {};
+		return this.proxy.latest.get({ params: {
+			limit,
+			types: types?.join(","),
+			combined
+		} });
+	}
 	/**
 	* 获取聚合数据统计
 	*/
@@ -412,6 +420,9 @@ var CommentController = class {
 			size: size || 10
 		} });
 	}
+	getThreadReplies(rootCommentId, params = {}) {
+		return this.proxy.thread(rootCommentId).get({ params });
+	}
 	/**
 	* 评论
 	*/
@@ -515,18 +526,29 @@ var NoteController = class {
 			prefer
 		} });
 	}
+	getNoteBySlugDate(year, month, day, slug, options) {
+		const { password, single, lang, prefer } = options || {};
+		return this.proxy(year.toString())(month.toString())(day.toString())(slug).get({ params: {
+			password,
+			single: single ? "1" : void 0,
+			lang,
+			prefer
+		} });
+	}
 	/**
 	* 日记列表分页
 	*/
 	getList(page = 1, perPage = 10, options = {}) {
-		const { select, sortBy, sortOrder, year } = options;
+		const { select, sortBy, sortOrder, year, lang, withSummary } = options;
 		return this.proxy.get({ params: {
 			page,
 			size: perPage,
 			select: select?.join(" "),
 			sortBy,
 			sortOrder,
-			year
+			year,
+			lang,
+			withSummary: withSummary ? "1" : void 0
 		} });
 	}
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/api-client",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "A api client for mx-space server@next",
   "type": "module",
   "engines": {
@@ -56,10 +56,10 @@
     "axios": "^1.13.3",
     "camelcase-keys": "^10.0.2",
     "cors": "2.8.6",
-    "es-toolkit": "1.44.0",
+    "es-toolkit": "1.45.0",
     "express": "4.21.2",
     "form-data": "4.0.5",
-    "tsdown": "0.20.1",
+    "tsdown": "0.21.0-beta.2",
     "umi-request": "1.4.0",
     "vite": "^7.3.1",
     "vitest": "4.0.18"

package/readme.md

@@ -1,133 +1,74 @@
-# MApi Client
+# @mx-space/api-client
 
-这是一个适用于 MServer v3 的 JS SDK，封装了常用接口请求方法以及返回类型的声明，以快速开发前端应用。
+A framework-agnostic TypeScript/JavaScript SDK for the MX Space server (MServer v3). It wraps common API endpoints with typed request methods and response types for fast frontend and server-side integration.
 
-## 版本兼容性
+---
 
-| api-client 版本 | 支持的 Server 版本 | 说明                          |
-| --------------- | ------------------ | ----------------------------- |
-| v2.x            | >= 10              | 基于 Better Auth 的新认证系统 |
-| v1.x            | <= 9               | 旧版认证系统                  |
+## Table of Contents
 
-**注意**: v2 版本与 v1 版本存在 Breaking Changes，升级时请参考下方迁移指南。
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Architecture](#architecture)
+- [Adapters](#adapters)
+- [Controllers](#controllers)
+- [Client Options](#client-options)
+- [Proxy API](#proxy-api)
+- [Version Compatibility & Migration](#version-compatibility--migration)
+- [Development](#development)
+- [License](#license)
 
-## 迁移到 v2
+---
 
-### Breaking Changes
+## Requirements
 
-#### 1. 控制器重命名
+- **Node.js** ≥ 22 (see `engines` in `package.json`)
+- **MX Space server** v10+ for api-client v2.x (Better Auth); v9 or below use api-client v1.x
 
-`user` 控制器已重命名为 `owner`，`master` 别名已被移除：
+---
 
-```diff
-- client.user.getMasterInfo()
-+ client.owner.getOwnerInfo()
-
-- client.master.getMasterInfo()
-+ client.owner.getOwnerInfo()
-```
+## Installation
 
-#### 2. 登录接口变更
+From the monorepo root (recommended):
 
-登录接口从 `POST /master/login` 变更为 `POST /auth/sign-in`：
-
-```diff
-- client.user.login(username, password)
-+ client.owner.login(username, password, { rememberMe: boolean })
+```bash
+pnpm add @mx-space/api-client
 ```
 
-v2 版本的 `login` 方法返回的数据结构也发生了变化，现在返回 `{ token, user }` 格式。
-
-#### 3. 新增 Better Auth 相关接口
-
-v2 版本新增了 Better Auth 认证相关的接口：
+Or with npm:
 
-```ts
-// 获取当前会话
-client.owner.getSession()
-
-// 获取 Better Auth 原生会话
-client.owner.getAuthSession()
-
-// 登出
-client.owner.logout()
-
-// 获取支持的登录方式
-client.owner.getAllowLoginMethods()
-
-// 获取 OAuth 提供商列表
-client.owner.getProviders()
-
-// 列出所有会话
-client.owner.listSessions()
-
-// 撤销指定会话
-client.owner.revokeSession(token)
-
-// 撤销所有会话
-client.owner.revokeSessions()
-
-// 撤销其他会话
-client.owner.revokeOtherSessions()
+```bash
+npm install @mx-space/api-client
 ```
 
-## 迁移到 v1
-
-不再提供 camelcase-keys 的 re-export，此库不再依赖 camelcase-keys 库，如有需要可自行安装。
+The package is **framework-agnostic** and does not bundle a specific HTTP client. You must provide an adapter (e.g. Axios or fetch). Install the HTTP library you use:
 
-```diff
-- import { camelcaseKeysDeep, camelcaseKeys } from '@mx-space/api-client'
-+ import { simpleCamelcaseKeys as camelcaseKeysDeep } from '@mx-space/api-client'
+```bash
+pnpm add axios
+# or use the built-in fetch adapter (no extra install)
 ```
 
-## 如何使用
+---
 
-此 SDK 框架无关，不捆绑任何一个网络请求库，只需要提供适配器。你需要手动传入符合接口标准的适配器。
+## Quick Start
 
-此项目提供 `axios` 和 `umi-request` 两个适配器。
-
-以 `axios` 为例。
+1. **Create a client** with an endpoint and an adapter.
+2. **Inject controllers** you need (tree-shakeable).
+3. **Call methods** on the client (e.g. `client.post`, `client.note`).
 
 ```ts
 import {
-  AggregateController,
-  allControllers, // ...
-  CategoryController,
   createClient,
-  NoteController,
   PostController,
+  NoteController,
+  AggregateController,
+  CategoryController,
 } from '@mx-space/api-client'
 import { axiosAdaptor } from '@mx-space/api-client/adaptors/axios'
 
-const endpoint = 'https://api.innei.dev/v2'
+const endpoint = 'https://api.example.com/v2'
 const client = createClient(axiosAdaptor)(endpoint)
 
-// `default` is AxiosInstance
-// you can do anything else on this
-// interceptor or re-configure
-const $axios = axiosAdaptor.default
-// re-config (optional)
-$axios.defaults.timeout = 10000
-// set interceptors (optional)
-$axios.interceptors.request.use(
-  (config) => {
-    const token = getToken()
-    if (token) {
-      config.headers!.Authorization = `bearer ${getToken()}`
-    }
-
-    return config
-  },
-  (error) => {
-    if (__DEV__) {
-      console.log(error.message)
-    }
-
-    return Promise.reject(error)
-  },
-)
-
-// inject controller first.
 client.injectControllers([
   PostController,
   NoteController,
@@ -135,40 +76,206 @@ client.injectControllers([
   CategoryController,
 ])
 
-// or you can inject allControllers
-client.injectControllers(allControllers)
+// Typed API calls
+const posts = await client.post.post.getList(1, 10, { year: 2024 })
+const aggregate = await client.aggregate.getAggregateData()
+```
 
-// then you can request `post` `note` and `aggregate` controller
+**Optional: set token and interceptors** (example with Axios):
 
-client.post.post.getList(page, 10, { year }).then((data) => {
-  // do anything
+```ts
+const $axios = axiosAdaptor.default
+$axios.defaults.timeout = 10000
+$axios.interceptors.request.use((config) => {
+  const token = getToken()
+  if (token) config.headers!.Authorization = `bearer ${token}`
+  return config
 })
 ```
 
-**为什么要手动注入控制器**
+---
+
+## Architecture
+
+- **Core**: `HTTPClient` in `core/client.ts` — builds a route proxy and delegates HTTP calls to an adapter.
+- **Adapters**: Implement `IRequestAdapter` (get/post/put/patch/delete + optional `default` client). Responses are normalized to `{ data }`; optional `transformResponse` (e.g. camelCase) runs on `data`.
+- **Controllers**: Classes that receive the client and attach methods under a name (e.g. `post`, `note`). Controllers are **injected at runtime** so you only bundle what you use.
+- **Proxy**: `client.proxy` allows arbitrary path chains and HTTP methods for endpoints not modeled by a controller (e.g. `client.note.proxy.something.other('123').info.get()`).
+
+**Response shape**: The adapter is expected to return a value with a `data` property. By default, `getDataFromResponse` uses `(res) => res.data`, and `transformResponse` converts keys to camelCase. Each returned object gets attached `$raw` (adapter response), `$request` (url, method, options), and `$serialized` (transformed data).
+
+---
+
+## Adapters
 
-按需加载，可以减少打包体积 (Tree Shake)
+Official adapters live under `@mx-space/api-client/adaptors/`:
 
-**为什么不依赖请求库**
+| Adapter        | Import path                              | Notes                    |
+|----------------|------------------------------------------|--------------------------|
+| **Axios**      | `@mx-space/api-client/adaptors/axios`   | Exposes `axiosAdaptor.default` (AxiosInstance). |
+| **umi-request**| `@mx-space/api-client/adaptors/umi-request` | For umi-request users.  |
+| **Fetch**      | `@mx-space/api-client/adaptors/fetch`   | Uses global `fetch`; no extra dependency. |
 
-可以防止项目中出现两个请求库，减少打包体积
+**Custom adapter**: Implement `IRequestAdapter` from `@mx-space/api-client` (methods: `get`, `post`, `put`, `patch`, `delete`; optional `default`). See `src/adaptors/axios.ts` and `src/adaptors/umi-request.ts` for reference.
 
-**如果不使用 axios，应该如何编写适配器**
+---
 
-参考 `src/adaptors/axios.ts` 和 `src/adaptors/umi-request.ts`
+## Controllers
 
-**如何使用 proxy 来访问 sdk 内未包含的请求**
+Inject one or more controllers so the client exposes them (e.g. `client.post`, `client.note`). Use `allControllers` to inject everything, or list only what you need for smaller bundles.
 
-如请求 `GET /notes/something/other/123456/info`，可以使用
+| Controller   | Client name   | Purpose (high level)        |
+|-------------|---------------|-----------------------------|
+| PostController   | `post`    | Blog posts                  |
+| NoteController   | `note`    | Notes / private posts       |
+| PageController   | `page`    | Pages                       |
+| CategoryController | `category` | Categories                |
+| AggregateController | `aggregate` | Site aggregate data     |
+| CommentController | `comment`  | Comments                    |
+| UserController (owner) | `owner` | Auth, session, login, OAuth |
+| SayController    | `say`     | Says / short notes          |
+| LinkController   | `link`    | Links                       |
+| SnippetController| `snippet` | Snippets                    |
+| ProjectController | `project` | Projects                    |
+| TopicController  | `topic`   | Topics                      |
+| RecentlyController | `recently` | Recently items           |
+| SearchController | `search`  | Search                      |
+| ActivityController| `activity`| Activity                    |
+| AIController     | `ai`      | AI-related endpoints        |
+| SubscribeController | `subscribe` | Subscriptions            |
+| ServerlessController | `serverless` | Serverless functions   |
+| AckController    | `ack`     | Ack                         |
+
+**Example — inject all controllers:**
 
 ```ts
-client.note.proxy.something.other('123456').info.get()
+import { createClient, allControllers } from '@mx-space/api-client'
+import { axiosAdaptor } from '@mx-space/api-client/adaptors/axios'
+
+const client = createClient(axiosAdaptor)('https://api.example.com/v2')
+client.injectControllers(allControllers)
 ```
 
-**从 proxy 获取请求地址但不发出**
+**Why inject manually?** To keep bundle size small (tree-shaking) and to avoid pulling in a specific HTTP library by default.
+
+---
+
+## Client Options
+
+`createClient(adapter)(endpoint, options)` accepts optional second argument:
+
+| Option                     | Description |
+|----------------------------|-------------|
+| `controllers`              | Array of controller classes to inject immediately. |
+| `transformResponse`       | `(data) => transformed`. Default: camelCase keys. |
+| `getDataFromResponse`     | `(response) => data`. Default: `(res) => res.data`. |
+| `getCodeMessageFromException` | `(error) => { message?, code? }` for custom error parsing. |
+| `customThrowResponseError` | `(error) => Error` to throw a custom error type. |
+
+---
+
+## Proxy API
+
+For paths not covered by a controller, use the **proxy** to build URLs and perform requests:
 
 ```ts
-client.note.proxy.something.other('123456').info.toString() // /notes/something/other/123456/info
+// GET /notes/something/other/123456/info
+const data = await client.note.proxy.something.other('123456').info.get()
+
+// Get path only (no request)
+client.note.proxy.something.other('123456').info.toString()
+// => '/notes/something/other/123456/info'
+
+// Full URL (with base endpoint)
+client.note.proxy.something.other('123456').info.toString(true)
+// => 'https://api.example.com/v2/notes/something/other/123456/info'
+```
+
+---
+
+## Version Compatibility & Migration
+
+### Compatibility
+
+| api-client version | Server version | Notes |
+|--------------------|----------------|-------|
+| v2.x               | ≥ 10           | Better Auth; owner API; new auth endpoints. |
+| v1.x               | ≤ 9            | Legacy auth. |
+
+v2 introduces breaking changes; see migration below.
+
+### Migrating to v2
+
+**1. Controller renames**
+
+- `user` / `master` → `owner`. Use `client.owner` for auth and owner info.
+
+```diff
+- client.user.getMasterInfo()
+- client.master.getMasterInfo()
++ client.owner.getOwnerInfo()
+```
+
+**2. Login**
+
+- Endpoint: `POST /master/login` → `POST /auth/sign-in`.
+- v2 `login` returns `{ token, user }`.
+
+```diff
+- client.user.login(username, password)
++ client.owner.login(username, password, { rememberMe: boolean })
+```
+
+**3. New auth-related APIs (v2)**
+
+- `client.owner.getSession()`
+- `client.owner.getAuthSession()`
+- `client.owner.logout()`
+- `client.owner.getAllowLoginMethods()`
+- `client.owner.getProviders()`
+- `client.owner.listSessions()`
+- `client.owner.revokeSession(token)` / `revokeSessions()` / `revokeOtherSessions()`
+
+### Migrating from v2 to v1 (downgrade)
 
-client.note.proxy.something.other('123456').info.toString(true) // http://localhost:2333/notes/something/other/123456/info
+- No re-export of `camelcase-keys`. Use the built-in helper or install yourself:
+
+```diff
+- import { camelcaseKeysDeep, camelcaseKeys } from '@mx-space/api-client'
++ import { simpleCamelcaseKeys as camelcaseKeysDeep } from '@mx-space/api-client'
 ```
+
+---
+
+## Development
+
+**From repo root:**
+
+```bash
+pnpm i
+```
+
+**From `packages/api-client`:**
+
+- **Build**: `pnpm run package` or `pnpm run build` (cleans `dist`, runs `tsdown`).
+- **Test**: `pnpm test` (Vitest).
+- **Dev (watch tests)**: `pnpm run dev`.
+
+**Project layout (high level):**
+
+- `core/` — client, request attachment, error type.
+- `controllers/` — one class per API area; names listed in `controllers/index.ts`.
+- `adaptors/` — axios, umi-request, fetch.
+- `models/`, `dtos/`, `interfaces/` — types and DTOs for requests/responses.
+- `utils/` — path resolution, camelCase, auto-bind.
+
+**Exports:**
+
+- Main: `createClient`, `RequestError`, controllers, models, DTOs, `simpleCamelcaseKeys`, `HTTPClient` type, `IRequestAdapter` type.
+- Adapters: `@mx-space/api-client/adaptors/axios`, `/adaptors/umi-request`, `/adaptors/fetch`.
+
+---
+
+## License
+
+MIT.