@mx-space/api-client 3.7.1 → 4.0.0-next.0

package/dist/index.d.cts

@@ -126,17 +126,13 @@ declare class AckController<ResponseWrapper> implements IController {
 //#endregion
 //#region ../../apps/core/src/constants/db.constant.d.ts
 declare enum CollectionRefTypes {
-  Post = "posts",
-  Note = "notes",
-  Page = "pages",
-  Recently = "recentlies"
+  Post = "post",
+  Note = "note",
+  Page = "page",
+  Recently = "recently"
 }
 //#endregion
 //#region models/base.d.ts
-interface Count {
-  read: number;
-  like: number;
-}
 interface Image {
   height: number;
   width: number;
@@ -157,33 +153,6 @@ interface PaginateResult<T> {
   data: T[];
   pagination: Pager;
 }
-interface BaseModel {
-  created: string;
-  id: string;
-}
-interface BaseCommentIndexModel extends BaseModel {
-  commentsIndex?: number;
-  allowComment: boolean;
-}
-interface TextBaseModelMarkdown extends BaseCommentIndexModel {
-  title: string;
-  text: string;
-  contentFormat?: 'markdown';
-  content?: undefined;
-  images?: Image[];
-  modified: string | null;
-  meta?: Record<string, any> | null;
-}
-interface TextBaseModelLexical extends BaseCommentIndexModel {
-  title: string;
-  text?: string;
-  contentFormat: 'lexical';
-  content: string;
-  images?: Image[];
-  modified: string | null;
-  meta?: Record<string, any> | null;
-}
-type TextBaseModel = TextBaseModelMarkdown | TextBaseModelLexical;
 type ModelWithLiked<T> = T & {
   liked: boolean;
 };
@@ -206,33 +175,80 @@ type ModelWithTranslation<T> = T & {
 };
 //#endregion
 //#region models/post.d.ts
-type PostModel = TextBaseModel & {
+type PostContentFormat = 'markdown' | 'lexical';
+interface PostModelMarkdown {
+  id: string;
+  createdAt: string;
+  modifiedAt: string | null;
+  title: string;
+  text: string;
+  contentFormat?: 'markdown';
+  content?: undefined;
+  meta?: Record<string, any> | null;
   summary?: string | null;
   copyright: boolean;
   tags: string[];
-  count: Count;
   slug: string;
   categoryId: string;
-  images: Image[];
-  category: CategoryModel$1;
-  pin?: string | null;
-  pinOrder?: number;
-  related?: Pick<PostModel, 'id' | 'category' | 'categoryId' | 'created' | 'modified' | 'title' | 'slug' | 'summary'>[];
-};
+  category: CategoryModel;
+  images?: Image[];
+  isPublished: boolean;
+  readCount: number;
+  likeCount: number;
+  pinAt?: string | null;
+  pinOrder?: number | null;
+  related?: PostRelatedSummary[];
+}
+interface PostModelLexical {
+  id: string;
+  createdAt: string;
+  modifiedAt: string | null;
+  title: string;
+  text?: string;
+  contentFormat: 'lexical';
+  content: string;
+  meta?: Record<string, any> | null;
+  summary?: string | null;
+  copyright: boolean;
+  tags: string[];
+  slug: string;
+  categoryId: string;
+  category: CategoryModel;
+  images?: Image[];
+  isPublished: boolean;
+  readCount: number;
+  likeCount: number;
+  pinAt?: string | null;
+  pinOrder?: number | null;
+  related?: PostRelatedSummary[];
+}
+type PostModel = PostModelMarkdown | PostModelLexical;
+interface PostRelatedSummary {
+  id: string;
+  title: string;
+  slug: string;
+  summary: string | null;
+  categoryId: string;
+  category?: CategoryModel;
+  createdAt: string;
+  modifiedAt: string | null;
+}
 //#endregion
 //#region models/category.d.ts
 declare enum CategoryType {
   Category = 0,
   Tag = 1
 }
-interface CategoryModel$1 extends BaseModel {
+interface CategoryModel {
+  id: string;
+  createdAt: string;
   type: CategoryType;
-  count: number;
   slug: string;
   name: string;
+  count?: number;
 }
-type CategoryChildPost = Pick<PostModel, 'id' | 'title' | 'slug' | 'modified' | 'created' | 'summary' | 'tags' | 'pin' | 'count' | 'images'>;
-type CategoryWithChildrenModel = CategoryModel$1 & {
+type CategoryChildPost = Pick<PostModel, 'id' | 'title' | 'slug' | 'modifiedAt' | 'createdAt' | 'tags' | 'pinAt' | 'readCount' | 'likeCount'>;
+type CategoryWithChildrenModel = CategoryModel & {
   children: CategoryChildPost[]; /** Aggregated tag-name → post-count for posts under this category. */
   tagsSum?: Array<{
     name: string;
@@ -246,7 +262,7 @@ interface TagModel {
   count: number;
   name: string;
 }
-type TagDetailPost = Pick<PostModel, 'id' | 'title' | 'slug' | 'category' | 'created' | 'modified' | 'summary' | 'tags' | 'pin' | 'count'>;
+type TagDetailPost = Pick<PostModel, 'id' | 'title' | 'slug' | 'category' | 'createdAt' | 'modifiedAt' | 'summary' | 'tags' | 'pinAt' | 'readCount' | 'likeCount'>;
 //#endregion
 //#region models/activity.d.ts
 interface ActivityPresence {
@@ -264,21 +280,21 @@ interface RoomOmittedNote {
   title: string;
   nid: number;
   id: string;
-  created: string;
+  createdAt: string;
 }
 interface RoomOmittedPage {
   title: string;
   slug: string;
   id: string;
-  created: string;
+  createdAt: string;
 }
 interface RoomOmittedPost {
   slug: string;
   title: string;
   categoryId: string;
-  category: CategoryModel$1;
+  category: CategoryModel;
   id: string;
-  created: string;
+  createdAt: string;
 }
 interface RoomsData {
   rooms: string[];
@@ -299,7 +315,7 @@ interface RecentActivities {
   note: RecentNote[];
 }
 interface RecentComment {
-  created: string;
+  createdAt: string;
   author: string;
   text: string;
   id: string;
@@ -314,7 +330,7 @@ interface RecentComment {
   };
 }
 interface RecentLike {
-  created: string;
+  createdAt: string;
   id: string;
   type: CollectionRefTypes.Post | CollectionRefTypes.Note;
   nid?: number;
@@ -323,16 +339,16 @@ interface RecentLike {
 }
 interface RecentNote {
   id: string;
-  created: string;
+  createdAt: string;
   title: string;
-  modified: string;
+  modifiedAt: string | null;
   nid: number;
 }
 interface RecentPost {
   id: string;
-  created: string;
+  createdAt: string;
   title: string;
-  modified: string;
+  modifiedAt: string | null;
   slug: string;
   category?: {
     slug: string;
@@ -344,7 +360,7 @@ interface RecentRecent {
   content: string;
   up: number;
   down: number;
-  created: string;
+  createdAt: string;
 }
 interface LastYearPublication {
   posts: PostsItem[];
@@ -352,7 +368,7 @@ interface LastYearPublication {
 }
 interface PostsItem {
   id: string;
-  created: string;
+  createdAt: string;
   title: string;
   slug: string;
   categoryId: string;
@@ -363,11 +379,11 @@ interface Category {
   type: number;
   name: string;
   slug: string;
-  created: string;
+  createdAt: string;
 }
 interface NotesItem {
   id: string;
-  created: string;
+  createdAt: string;
   title: string;
   mood: string;
   weather: string;
@@ -376,33 +392,43 @@ interface NotesItem {
 }
 //#endregion
 //#region models/topic.d.ts
-interface TopicModel extends BaseModel {
-  description?: string;
-  introduce: string;
+interface TopicModel {
+  id: string;
+  createdAt: string;
   name: string;
   slug: string;
-  icon?: string;
+  description: string;
+  introduce: string | null;
+  icon: string | null;
 }
 //#endregion
 //#region models/note.d.ts
-type NoteModel = TextBaseModel & {
+interface NoteModel {
+  id: string;
+  nid: number;
+  title: string;
+  slug?: string | null;
+  text: string;
+  content?: string | null;
+  contentFormat: 'markdown' | 'lexical';
+  images?: Image[] | null;
+  meta?: Record<string, any> | null;
   isPublished: boolean;
-  count: {
-    read: number;
-    like: number;
-  };
-  mood?: string;
-  weather?: string;
-  bookmark?: boolean;
-  publicAt?: Date;
+  hasPassword: boolean;
   password?: string | null;
-  nid: number;
-  slug?: string;
-  location?: string;
-  coordinates?: Coordinate;
-  topic?: TopicModel;
-  topicId?: string;
-};
+  publicAt?: string | Date | null;
+  mood?: string | null;
+  weather?: string | null;
+  bookmark: boolean;
+  coordinates?: Coordinate | null;
+  location?: string | null;
+  readCount: number;
+  likeCount: number;
+  topicId?: string | null;
+  topic?: TopicModel | null;
+  createdAt: string;
+  modifiedAt: string | null;
+}
 interface Coordinate {
   latitude: number;
   longitude: number;
@@ -424,10 +450,12 @@ interface NoteWrappedWithLikedAndTranslationPayload {
 }
 //#endregion
 //#region models/say.d.ts
-interface SayModel extends BaseModel {
+interface SayModel {
+  id: string;
+  createdAt: string;
   text: string;
-  source?: string;
-  author?: string;
+  source: string | null;
+  author: string | null;
 }
 //#endregion
 //#region models/setting.d.ts
@@ -512,26 +540,30 @@ interface IConfig {
 declare type IConfigKeys = keyof IConfig;
 //#endregion
 //#region models/user.d.ts
-interface UserModel extends BaseModel {
-  introduce: string;
-  mail: string;
-  url: string;
-  name: string;
-  socialIds: Record<string, string>;
+interface UserModel {
+  id: string;
+  createdAt: string;
   username: string;
-  modified: string;
-  v: number;
-  lastLoginTime: string;
-  lastLoginIp?: string;
+  name: string;
   avatar: string;
-  postID: string;
+  mail: string;
+  introduce?: string;
+  url?: string;
+  socialIds?: Record<string, string>;
+  lastLoginTime?: string;
+  lastLoginIp?: string | null;
+  role?: 'owner' | 'reader';
+  email?: string;
+  image?: string;
+  handle?: string;
+  displayUsername?: string;
 }
 type TLogin = {
   token: string;
   expiresIn: number;
   lastLoginTime: null | string;
   lastLoginIp?: null | string;
-} & Pick<UserModel, 'name' | 'username' | 'created' | 'url' | 'mail' | 'avatar' | 'id'>;
+} & Pick<UserModel, 'name' | 'username' | 'createdAt' | 'url' | 'mail' | 'avatar' | 'id'>;
 type BetterAuthUserRole = 'owner' | 'reader';
 interface BetterAuthUser {
   id: string;
@@ -612,8 +644,8 @@ interface Url {
   serverUrl: string;
   webUrl: string;
 }
-interface AggregateTopNote extends Pick<NoteModel, 'id' | 'title' | 'created' | 'nid' | 'images' | 'mood' | 'weather'> {}
-interface AggregateTopPost extends Pick<PostModel, 'id' | 'slug' | 'created' | 'title' | 'category' | 'images' | 'summary'> {}
+interface AggregateTopNote extends Pick<NoteModel, 'id' | 'title' | 'createdAt' | 'nid' | 'images' | 'mood' | 'weather'> {}
+interface AggregateTopPost extends Pick<PostModel, 'id' | 'slug' | 'createdAt' | 'title' | 'category' | 'images' | 'summary'> {}
 interface AggregateTop {
   notes: AggregateTopNote[];
   posts: AggregateTopPost[];
@@ -624,15 +656,15 @@ declare enum TimelineType {
   Note = 1
 }
 interface TimelineData {
-  notes?: Pick<NoteModel, 'id' | 'nid' | 'title' | 'weather' | 'mood' | 'created' | 'modified' | 'bookmark'>[];
-  posts?: (Pick<PostModel, 'id' | 'title' | 'slug' | 'created' | 'modified' | 'category'> & {
+  notes?: Pick<NoteModel, 'id' | 'nid' | 'title' | 'weather' | 'mood' | 'createdAt' | 'modifiedAt' | 'bookmark'>[];
+  posts?: (Pick<PostModel, 'id' | 'title' | 'slug' | 'createdAt' | 'modifiedAt' | 'category'> & {
     url: string;
   })[];
 }
-interface LatestPostItem extends Pick<PostModel, 'id' | 'title' | 'slug' | 'created' | 'modified' | 'tags'> {
+interface LatestPostItem extends Pick<PostModel, 'id' | 'title' | 'slug' | 'createdAt' | 'modifiedAt' | 'tags'> {
   category: Pick<CategoryModel, 'name' | 'slug'> | null;
 }
-interface LatestNoteItem extends Pick<NoteModel, 'id' | 'title' | 'nid' | 'created' | 'modified' | 'mood' | 'weather' | 'bookmark'> {}
+interface LatestNoteItem extends Pick<NoteModel, 'id' | 'title' | 'nid' | 'createdAt' | 'modifiedAt' | 'mood' | 'weather' | 'bookmark'> {}
 interface LatestData {
   posts?: LatestPostItem[];
   notes?: LatestNoteItem[];
@@ -665,15 +697,15 @@ interface AggregateStat {
 //#region models/ai.d.ts
 interface AISummaryModel {
   id: string;
-  created: string;
+  createdAt: string;
   summary: string;
   hash: string;
   refId: string;
-  lang: string;
+  lang: string | null;
 }
 interface AITranslationModel {
   id: string;
-  created: string;
+  createdAt: string;
   hash: string;
   refId: string;
   refType: string;
@@ -681,11 +713,13 @@ interface AITranslationModel {
   sourceLang: string;
   title: string;
   text: string;
-  subtitle?: string;
-  summary?: string;
-  tags?: string[];
-  aiModel?: string;
-  aiProvider?: string;
+  subtitle: string | null;
+  summary: string | null;
+  tags: string[];
+  aiModel: string | null;
+  aiProvider: string | null;
+  contentFormat: string | null;
+  content: string | null;
 }
 interface AIDeepReadingModel {
   id: string;
@@ -723,19 +757,15 @@ type AITranslationStreamEvent = {
 };
 interface AIInsightsModel {
   id: string;
-  created: string;
-  updated?: string;
+  createdAt: string;
   hash: string;
   refId: string;
   lang: string;
   content: string;
   isTranslation: boolean;
-  sourceInsightsId?: string;
-  sourceLang?: string;
-  modelInfo?: {
-    provider: string;
-    model: string;
-  };
+  sourceInsightsId: string | null;
+  sourceLang: string | null;
+  modelInfo: Record<string, unknown> | null;
 }
 type AIInsightsStreamEvent = {
   type: 'token';
@@ -760,29 +790,44 @@ interface AuthUser {
 }
 //#endregion
 //#region models/comment.d.ts
-interface CommentModel extends BaseModel {
+/**
+ * 评论父级预览：仅暴露列表/详情中渲染父评论引用所需之最小字段。
+ * 服务端有意去 ip/mail/agent 等 PII，故不可与 CommentModel 通用。
+ */
+interface CommentParentPreview {
+  id: string;
+  author: string | null;
+  text: string;
+  isDeleted: boolean;
+}
+interface CommentModel {
+  id: string;
+  createdAt: string;
   refType: CollectionRefTypes;
-  ref: string;
+  refId: string;
   state: number;
-  author: string;
+  author: string | null;
   text: string;
-  mail?: string;
-  url?: string;
-  ip?: string;
-  agent?: string;
-  pin?: boolean;
-  avatar: string;
-  parentCommentId?: string | null;
-  rootCommentId?: string | null;
-  replyCount?: number;
-  latestReplyAt?: string | null;
-  isDeleted?: boolean;
-  deletedAt?: string;
-  isWhispers?: boolean;
-  location?: string;
-  authProvider?: string;
-  readerId?: string;
-  editedAt?: string;
+  mail: string | null;
+  url: string | null;
+  ip: string | null;
+  agent: string | null;
+  pin: boolean;
+  avatar: string | null;
+  parentCommentId: string | null;
+  rootCommentId: string | null;
+  replyCount: number;
+  latestReplyAt: string | null;
+  isDeleted: boolean;
+  deletedAt: string | null;
+  isWhispers: boolean;
+  location: string | null;
+  authProvider: string | null;
+  readerId: string | null;
+  editedAt: string | null;
+  anchor: Record<string, unknown> | null;
+  /** 仅 list/detail 端点附加（服务端 attachParentPreview 之结果）。 */
+  parent?: CommentParentPreview | null;
 }
 interface CommentReplyWindow {
   total: number;
@@ -807,7 +852,7 @@ interface CommentRef {
   categoryId?: string;
   slug: string;
   title: string;
-  category?: CategoryModel$1;
+  category?: CategoryModel;
 }
 declare enum CommentState {
   Unread = 0,
@@ -827,15 +872,17 @@ declare enum LinkState {
   Banned = 3,
   Reject = 4
 }
-interface LinkModel extends BaseModel {
+interface LinkModel {
+  id: string;
+  createdAt: string;
   name: string;
   url: string;
-  avatar: string;
-  description?: string;
+  avatar: string | null;
+  description: string | null;
   type: LinkType;
   state: LinkState;
   hide: boolean;
-  email: string;
+  email: string | null;
 }
 //#endregion
 //#region models/page.d.ts
@@ -844,25 +891,52 @@ declare enum EnumPageType {
   'html' = "html",
   'frame' = "frame"
 }
-type PageModel = TextBaseModel & {
-  created: string;
+interface PageModelMarkdown {
+  id: string;
+  createdAt: string;
+  modifiedAt: string | null;
+  title: string;
   slug: string;
-  subtitle?: string;
+  subtitle?: string | null;
+  text: string;
+  contentFormat?: 'markdown';
+  content?: undefined;
+  meta?: Record<string, any> | null;
+  images?: Image[];
   order?: number;
   type?: EnumPageType;
   options?: object;
-};
+}
+interface PageModelLexical {
+  id: string;
+  createdAt: string;
+  modifiedAt: string | null;
+  title: string;
+  slug: string;
+  subtitle?: string | null;
+  text?: string;
+  contentFormat: 'lexical';
+  content: string;
+  meta?: Record<string, any> | null;
+  images?: Image[];
+  order?: number;
+  type?: EnumPageType;
+  options?: object;
+}
+type PageModel = PageModelMarkdown | PageModelLexical;
 //#endregion
 //#region models/project.d.ts
-interface ProjectModel extends BaseModel {
+interface ProjectModel {
+  id: string;
+  createdAt: string;
   name: string;
-  previewUrl?: string;
-  docUrl?: string;
-  projectUrl?: string;
-  images?: string[];
   description: string;
-  avatar?: string;
-  text: string;
+  previewUrl: string | null;
+  docUrl: string | null;
+  projectUrl: string | null;
+  images: string[] | null;
+  avatar: string | null;
+  text: string | null;
 }
 //#endregion
 //#region models/reader.d.ts
@@ -876,9 +950,10 @@ interface ReaderModel {
 //#endregion
 //#region models/recently.d.ts
 declare enum RecentlyRefTypes {
-  Post = "Post",
-  Note = "Note",
-  Page = "Page"
+  Post = "post",
+  Note = "note",
+  Page = "page",
+  Recently = "recently"
 }
 type RecentlyRefType = {
   title: string;
@@ -948,37 +1023,49 @@ interface CodeMetadata {
   platform?: string;
 }
 type RecentlyMetadata = BookMetadata | MediaMetadata | MusicMetadata | GithubMetadata | LinkMetadata | AcademicMetadata | CodeMetadata;
-interface RecentlyModel extends BaseCommentIndexModel {
+interface RecentlyModel {
+  id: string;
+  createdAt: string;
+  modifiedAt: string | null;
   content: string;
   type: RecentlyTypeEnum;
-  metadata?: RecentlyMetadata;
-  ref?: RecentlyRefType & {
-    [key: string]: any;
-  };
-  refId?: string;
-  refType?: RecentlyRefTypes;
+  metadata: RecentlyMetadata | null;
+  refType: RecentlyRefTypes;
+  refId: string | null;
   up: number;
   down: number;
-  modified?: string;
+  commentsIndex: number;
+  allowComment: boolean;
 }
 //#endregion
 //#region models/snippet.d.ts
 declare enum SnippetType {
   JSON = "json",
+  JSON5 = "json5",
   Function = "function",
   Text = "text",
   YAML = "yaml"
 }
-interface SnippetModel<T = unknown> extends BaseModel {
+interface SnippetModel<T = unknown> {
+  id: string;
+  createdAt: string;
+  updatedAt: string | null;
   type: SnippetType;
   private: boolean;
   raw: string;
   name: string;
   reference: string;
-  comment?: string;
-  metatype?: string;
-  schema?: string;
-  data: T;
+  comment?: string | null;
+  metatype?: string | null;
+  schema?: string | null;
+  method?: string | null;
+  customPath?: string | null;
+  /** Encrypted on list endpoints; cleared key-value object on detail endpoints. */
+  secret?: string | Record<string, unknown> | null;
+  enable: boolean;
+  builtIn: boolean;
+  compiledCode?: string | null;
+  data?: T;
 }
 //#endregion
 //#region ../../apps/core/src/modules/subscribe/subscribe.constant.d.ts
@@ -1266,11 +1353,11 @@ declare class AIController<ResponseWrapper> implements IController {
         data: AISummaryModel;
       }) ? T_1 extends unknown ? {
         id: string;
-        created: string;
+        created_at: string;
         summary: string;
         hash: string;
         ref_id: string;
-        lang: string;
+        lang: string | null;
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1301,11 +1388,11 @@ declare class AIController<ResponseWrapper> implements IController {
         data: AISummaryModel;
       }) ? T_1 extends unknown ? {
         id: string;
-        created: string;
+        created_at: string;
         summary: string;
         hash: string;
         ref_id: string;
-        lang: string;
+        lang: string | null;
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1385,7 +1472,7 @@ declare class AIController<ResponseWrapper> implements IController {
         data: AITranslationModel;
       }) ? T_1 extends unknown ? {
         id: string;
-        created: string;
+        created_at: string;
         hash: string;
         ref_id: string;
         ref_type: string;
@@ -1393,11 +1480,13 @@ declare class AIController<ResponseWrapper> implements IController {
         source_lang: string;
         title: string;
         text: string;
-        subtitle?: string | undefined;
-        summary?: string | undefined;
-        tags?: string[] | undefined;
-        ai_model?: string | undefined;
-        ai_provider?: string | undefined;
+        subtitle: string | null;
+        summary: string | null;
+        tags: string[];
+        ai_model: string | null;
+        ai_provider: string | null;
+        content_format: string | null;
+        content: string | null;
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1596,19 +1685,15 @@ declare class AIController<ResponseWrapper> implements IController {
         data: AIInsightsModel | null;
       }) ? T_1 extends unknown ? {
         id: string;
-        created: string;
-        updated?: string | undefined;
+        created_at: string;
         hash: string;
         ref_id: string;
         lang: string;
         content: string;
         is_translation: boolean;
-        source_insights_id?: string | undefined;
-        source_lang?: string | undefined;
-        model_info?: {
-          provider: string;
-          model: string;
-        } | undefined;
+        source_insights_id: string | null;
+        source_lang: string | null;
+        model_info: Record<string, unknown> | null;
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1659,14 +1744,14 @@ declare class CategoryController<ResponseWrapper> implements IController {
   constructor(client: HTTPClient);
   get proxy(): IRequestHandler<ResponseWrapper>;
   getAllCategories(): RequestProxyResult<{
-    data: CategoryModel$1[];
+    data: CategoryModel[];
   }, ResponseWrapper>;
   getAllTags(): RequestProxyResult<{
     data: TagModel[];
   }, ResponseWrapper>;
   getCategoryDetail(id: string): Promise<ResponseProxyExtraRaw<CategoryWithChildrenModel>>;
   getCategoryDetail(ids: string[]): Promise<ResponseProxyExtraRaw<Map<string, CategoryWithChildrenModel>>>;
-  getCategoryByIdOrSlug(idOrSlug: string): Promise<CategoryModel$1 & {
+  getCategoryByIdOrSlug(idOrSlug: string): Promise<CategoryModel & {
     children: CategoryChildPost[];
     tagsSum?: Array<{
       name: string;
@@ -1692,12 +1777,12 @@ declare class CategoryController<ResponseWrapper> implements IController {
       } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
         data: CategoryWithChildrenModel;
       }) ? T_1 extends unknown ? {
+        id: string;
+        created_at: string;
         type: CategoryType;
-        count: number;
         slug: string;
         name: string;
-        created: string;
-        id: string;
+        count?: number | undefined;
         children: CategoryChildPost[];
         tags_sum?: {
           name: string;
@@ -1789,6 +1874,20 @@ interface ReaderCommentDto {
   isWhispers?: boolean;
 }
 type CommentDto = AnonymousCommentDto | ReaderCommentDto;
+interface CommentUploadConfigDto {
+  enable: boolean;
+  singleFileSizeMB: number;
+  commentImageMaxCount: number;
+  mimeWhitelist: string[];
+  pendingTtlMinutes: number;
+}
+interface CommentUploadResultDto {
+  url: string;
+  fileName: string;
+  byteSize: number;
+  mimeType: string;
+  expireAt: string;
+}
 //#endregion
 //#region controllers/comment.d.ts
 declare module '@mx-space/api-client' {
@@ -1806,19 +1905,27 @@ declare class CommentController<ResponseWrapper> implements IController {
    * 根据 comment id 获取评论，包括子评论
    */
   getById(id: string): RequestProxyResult<CommentModel & {
-    ref: string;
+    parent: CommentParentPreview | null;
+    children?: CommentModel[];
+    reader?: ReaderModel;
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
     data: CommentModel & {
-      ref: string;
+      parent: CommentParentPreview | null;
+      children?: CommentModel[];
+      reader?: ReaderModel;
     };
   } : ResponseWrapper extends {
     data: CommentModel & {
-      ref: string;
+      parent: CommentParentPreview | null;
+      children?: CommentModel[];
+      reader?: ReaderModel;
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
     data: CommentModel & {
-      ref: string;
+      parent: CommentParentPreview | null;
+      children?: CommentModel[];
+      reader?: ReaderModel;
     };
   }>;
   /**
@@ -1828,27 +1935,19 @@ declare class CommentController<ResponseWrapper> implements IController {
   getByRefId(refId: string, params?: PaginationParams & {
     sort?: 'pinned' | 'newest' | 'oldest';
     around?: string;
-  }): RequestProxyResult<PaginateResult<CommentThreadItem & {
-    ref: string;
-  }> & {
+  }): RequestProxyResult<PaginateResult<CommentThreadItem> & {
     readers: Record<string, ReaderModel>;
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: PaginateResult<CommentThreadItem & {
-      ref: string;
-    }> & {
+    data: PaginateResult<CommentThreadItem> & {
       readers: Record<string, ReaderModel>;
     };
   } : ResponseWrapper extends {
-    data: PaginateResult<CommentThreadItem & {
-      ref: string;
-    }> & {
+    data: PaginateResult<CommentThreadItem> & {
       readers: Record<string, ReaderModel>;
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: PaginateResult<CommentThreadItem & {
-      ref: string;
-    }> & {
+    data: PaginateResult<CommentThreadItem> & {
       readers: Record<string, ReaderModel>;
     };
   }>;
@@ -1900,6 +1999,29 @@ declare class CommentController<ResponseWrapper> implements IController {
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
     data: CommentModel;
   }>;
+  /**
+   * 取评论图片上传之公开配置（启用状态、限额、MIME 白名单等）
+   */
+  getUploadConfig(): RequestProxyResult<CommentUploadConfigDto, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentUploadConfigDto;
+  } : ResponseWrapper extends {
+    data: CommentUploadConfigDto;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentUploadConfigDto;
+  }>;
+  /**
+   * 已登录读者上传评论图片
+   * @param file - 浏览器 File / Blob 或 node 之 Buffer 包装
+   */
+  uploadImage(file: File | Blob): RequestProxyResult<CommentUploadResultDto, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentUploadResultDto;
+  } : ResponseWrapper extends {
+    data: CommentUploadResultDto;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentUploadResultDto;
+  }>;
 }
 //#endregion
 //#region controllers/base.d.ts
@@ -1971,7 +2093,7 @@ declare module '@mx-space/api-client' {
 type NoteListOptions = {
   select?: SelectFields<keyof NoteModel>;
   year?: number;
-  sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified';
+  sortBy?: 'weather' | 'mood' | 'title' | 'createdAt' | 'modifiedAt';
   sortOrder?: 1 | -1;
   lang?: string;
   withSummary?: boolean;
@@ -1989,7 +2111,7 @@ type NoteMiddleListOptions = {
 type NoteTopicListOptions = SortOptions & {
   lang?: string;
 };
-type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'slug' | 'created' | 'isPublished'> & {
+type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'slug' | 'createdAt' | 'isPublished'> & {
   isTranslated?: boolean;
   translationMeta?: TranslationMeta;
 };
@@ -2280,7 +2402,7 @@ declare module '@mx-space/api-client' {
 }
 type PageListOptions = {
   select?: SelectFields<keyof PageModel>;
-  sortBy?: 'order' | 'subtitle' | 'title' | 'created' | 'modified';
+  sortBy?: 'order' | 'subtitle' | 'title' | 'createdAt' | 'modifiedAt';
   sortOrder?: 1 | -1;
 };
 declare class PageController<ResponseWrapper> implements IController {
@@ -2337,7 +2459,7 @@ declare module '@mx-space/api-client' {
 type PostListOptions = {
   select?: SelectFields<keyof PostModel>;
   year?: number;
-  sortBy?: 'categoryId' | 'title' | 'created' | 'modified';
+  sortBy?: 'categoryId' | 'title' | 'createdAt' | 'modifiedAt' | 'pinAt';
   sortOrder?: 1 | -1;
   truncate?: number; /** 语言代码，用于获取翻译版本 */
   lang?: string;
@@ -2449,44 +2571,28 @@ declare class RecentlyController<ResponseWrapper> implements IController {
   /**
    * 获取最新一条
    */
-  getLatestOne(): RequestProxyResult<RecentlyModel & {
-    comments: number;
-  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+  getLatestOne(): RequestProxyResult<RecentlyModel | null, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: RecentlyModel & {
-      comments: number;
-    };
+    data: RecentlyModel | null;
   } : ResponseWrapper extends {
-    data: RecentlyModel & {
-      comments: number;
-    };
+    data: RecentlyModel | null;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: RecentlyModel & {
-      comments: number;
-    };
+    data: RecentlyModel | null;
   }>;
   getAll(): RequestProxyResult<{
-    data: RecentlyModel[] & {
-      comments: number;
-    };
+    data: RecentlyModel[];
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
     data: {
-      data: RecentlyModel[] & {
-        comments: number;
-      };
+      data: RecentlyModel[];
     };
   } : ResponseWrapper extends {
     data: {
-      data: RecentlyModel[] & {
-        comments: number;
-      };
+      data: RecentlyModel[];
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
     data: {
-      data: RecentlyModel[] & {
-        comments: number;
-      };
+      data: RecentlyModel[];
     };
   }>;
   getList({
@@ -2498,44 +2604,28 @@ declare class RecentlyController<ResponseWrapper> implements IController {
     after?: string | undefined;
     size?: number | number;
   }): RequestProxyResult<{
-    data: RecentlyModel[] & {
-      comments: number;
-    };
+    data: RecentlyModel[];
   }, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
     data: {
-      data: RecentlyModel[] & {
-        comments: number;
-      };
+      data: RecentlyModel[];
     };
   } : ResponseWrapper extends {
     data: {
-      data: RecentlyModel[] & {
-        comments: number;
-      };
+      data: RecentlyModel[];
     };
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
     data: {
-      data: RecentlyModel[] & {
-        comments: number;
-      };
+      data: RecentlyModel[];
     };
   }>;
-  getById(id: string): RequestProxyResult<RecentlyModel & {
-    comments: number;
-  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+  getById(id: string): RequestProxyResult<RecentlyModel, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: RecentlyModel & {
-      comments: number;
-    };
+    data: RecentlyModel;
   } : ResponseWrapper extends {
-    data: RecentlyModel & {
-      comments: number;
-    };
+    data: RecentlyModel;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: RecentlyModel & {
-      comments: number;
-    };
+    data: RecentlyModel;
   }>;
   /**  表态：点赞，点踩 */
   attitude(id: string, attitude: RecentlyAttitudeEnum): RequestProxyResult<{
@@ -2612,38 +2702,38 @@ declare class SearchController<ResponseWrapper> implements IController {
   name: string;
   constructor(client: HTTPClient);
   get proxy(): IRequestHandler<ResponseWrapper>;
-  search(type: 'note', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<NoteModel, 'modified' | 'id' | 'title' | 'created' | 'nid'> & SearchResultHighlight>, ResponseWrapper>>;
-  search(type: 'post', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PostModel, 'modified' | 'id' | 'title' | 'created' | 'slug' | 'category'> & SearchResultHighlight>, ResponseWrapper>>;
-  search(type: 'page', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PageModel, 'modified' | 'id' | 'title' | 'created' | 'slug'> & SearchResultHighlight>, ResponseWrapper>>;
-  searchAll(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+  search(type: 'note', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<NoteModel, 'modifiedAt' | 'id' | 'title' | 'createdAt' | 'nid'> & SearchResultHighlight>, ResponseWrapper>>;
+  search(type: 'post', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PostModel, 'modifiedAt' | 'id' | 'title' | 'createdAt' | 'slug' | 'category'> & SearchResultHighlight>, ResponseWrapper>>;
+  search(type: 'page', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PageModel, 'modifiedAt' | 'id' | 'title' | 'createdAt' | 'slug'> & SearchResultHighlight>, ResponseWrapper>>;
+  searchAll(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
     type: "post";
-  }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+  }) | (Pick<NoteModel, "id" | "createdAt" | "modifiedAt" | "title" | "nid"> & SearchResultHighlight & {
     type: "note";
-  }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+  }) | (Pick<PageModel, "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
     type: "page";
   })>, ResponseWrapper>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "createdAt" | "modifiedAt" | "title" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   } : ResponseWrapper extends {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "createdAt" | "modifiedAt" | "title" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "createdAt" | "modifiedAt" | "title" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "createdAt" | "modifiedAt" | "title" | "slug"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   }>;
@@ -2787,4 +2877,4 @@ declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate"
  */
 declare const camelcaseKeys: <T = any>(obj: any) => T;
 //#endregion
-export { AIController, AIDeepReadingModel, AIInsightsModel, AIInsightsStreamEvent, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, AcademicMetadata, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateSiteInfo, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AnonymousCommentDto, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, BookMetadata, CategoryChildPost, CategoryController, CategoryEntries, CategoryModel$1 as CategoryModel, CategoryType, CategoryWithChildrenModel, CheckLoggedResult, CodeMetadata, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentRef, CommentReplyWindow, CommentState, CommentThreadItem, CommentThreadReplies, Coordinate, Count, EnumPageType, GithubMetadata, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LatestCombinedItem, LatestData, LatestNoteItem, LatestPostItem, LinkController, LinkMetadata, LinkModel, LinkState, LinkType, MailOptionsModel, MediaMetadata, ModelWithLiked, ModelWithTranslation, MusicMetadata, 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, ReaderCommentDto, ReaderModel, RecentActivities, RecentComment, RecentLike, RecentNote, RecentPost, RecentRecent, RecentlyAttitudeEnum, RecentlyAttitudeResultEnum, RecentlyController, RecentlyMetadata, RecentlyModel, RecentlyRefType, RecentlyRefTypes, RecentlyTypeEnum, RequestError, RoomOmittedNote, RoomOmittedPage, RoomOmittedPost, RoomsData, SayController, SayModel, SearchController, SeoOptionModel, ServerlessController, SnippetController, SnippetModel, SnippetType, SubscribeAllBit, SubscribeController, SubscribeNoteCreateBit, SubscribePostCreateBit, SubscribeRecentCreateBit, SubscribeSayCreateBit, SubscribeType, SubscribeTypeToBitMap, TLogin, TagDetailPost, 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, AIInsightsModel, AIInsightsStreamEvent, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, AcademicMetadata, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateSiteInfo, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AnonymousCommentDto, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, BookMetadata, CategoryChildPost, CategoryController, CategoryEntries, CategoryModel, CategoryType, CategoryWithChildrenModel, CheckLoggedResult, CodeMetadata, CollectionRefTypes, CommentController, CommentDto, CommentModel, CommentOptionsModel, CommentParentPreview, CommentRef, CommentReplyWindow, CommentState, CommentThreadItem, CommentThreadReplies, CommentUploadConfigDto, CommentUploadResultDto, Coordinate, EnumPageType, GithubMetadata, type HTTPClient, IConfig, IConfigKeys, type IRequestAdapter, Image, LastYearPublication, LatestCombinedItem, LatestData, LatestNoteItem, LatestPostItem, LinkController, LinkMetadata, LinkModel, LinkState, LinkType, MailOptionsModel, MediaMetadata, ModelWithLiked, ModelWithTranslation, MusicMetadata, NoteController, type NoteMiddleListOptions, NoteModel, type NoteTimelineItem, type NoteTopicListItem, type NoteTopicListOptions, NoteWrappedPayload, NoteWrappedWithLikedAndTranslationPayload, NoteWrappedWithLikedPayload, OwnerAllowLoginResult, OwnerSessionResult, PageController, PageModel, PageModelLexical, PageModelMarkdown, Pager, PaginateResult, PostContentFormat, PostController, type PostListItem, type PostListOptions, PostModel, PostModelLexical, PostModelMarkdown, PostRelatedSummary, ProjectController, ProjectModel, ReaderCommentDto, ReaderModel, RecentActivities, RecentComment, RecentLike, RecentNote, RecentPost, RecentRecent, RecentlyAttitudeEnum, RecentlyAttitudeResultEnum, RecentlyController, RecentlyMetadata, RecentlyModel, RecentlyRefType, RecentlyRefTypes, RecentlyTypeEnum, RequestError, RoomOmittedNote, RoomOmittedPage, RoomOmittedPost, RoomsData, SayController, SayModel, SearchController, SeoOptionModel, ServerlessController, SnippetController, SnippetModel, SnippetType, SubscribeAllBit, SubscribeController, SubscribeNoteCreateBit, SubscribePostCreateBit, SubscribeRecentCreateBit, SubscribeSayCreateBit, SubscribeType, SubscribeTypeToBitMap, TLogin, TagDetailPost, TagModel, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };