@mix-space-lts/api-client 2.4.2 → 2.4.3

package/dist/index.d.cts

@@ -0,0 +1,2653 @@
+import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DLzJOGbI.cjs";
+
+//#region interfaces/controller.d.ts
+interface IController {
+  base: string;
+  name: string | string[];
+}
+//#endregion
+//#region interfaces/types.d.ts
+type Class<T> = new (...args: any[]) => T;
+type SelectFields<T extends string> = `${'+' | '-' | ''}${T}`[];
+//#endregion
+//#region interfaces/client.d.ts
+interface IClientOptions {
+  controllers: Class<IController>[];
+  getCodeMessageFromException: <T = Error>(error: T) => {
+    message?: string | undefined | null;
+    code?: number | undefined | null;
+  };
+  customThrowResponseError: <T extends Error = Error>(err: any) => T;
+  transformResponse: <T = any>(data: any) => T;
+  /**
+   *
+   * @default (res) => res.data
+   */
+  getDataFromResponse: <T = any>(response: unknown) => T;
+}
+type ClientOptions = Partial<IClientOptions>;
+//#endregion
+//#region interfaces/request.d.ts
+type NoStringIndex<T> = { [K in keyof T as string extends K ? never : K]: T[K] };
+interface IRequestHandler<ResponseWrapper> {
+  (path?: string | number): IRequestHandler<ResponseWrapper>;
+  get: <P = unknown>(options?: Omit<NoStringIndex<RequestOptions>, 'data'>) => RequestProxyResult<P, ResponseWrapper>;
+  post: <P = unknown>(options?: RequestOptions) => RequestProxyResult<P, ResponseWrapper>;
+  patch: <P = unknown>(options?: RequestOptions) => RequestProxyResult<P, ResponseWrapper>;
+  delete: <P = unknown>(options?: Omit<NoStringIndex<RequestOptions>, 'data'>) => RequestProxyResult<P, ResponseWrapper>;
+  put: <P = unknown>(options?: RequestOptions) => RequestProxyResult<P, ResponseWrapper>;
+  toString: (withBase?: boolean) => string;
+  valueOf: (withBase?: boolean) => string;
+  [key: string]: IRequestHandler<ResponseWrapper>;
+}
+type RequestProxyResult<T, ResponseWrapper, R = (ResponseWrapper extends unknown ? {
+  data: T;
+  [key: string]: any;
+} : ResponseWrapper extends {
+  data: T;
+} ? ResponseWrapper : Omit<ResponseWrapper, 'data'> & {
+  data: T;
+})> = Promise<ResponseProxyExtraRaw<T, R, ResponseWrapper>>;
+type CamelToSnake<T extends string, P extends string = ''> = string extends T ? string : T extends `${infer C0}${infer R}` ? CamelToSnake<R, `${P}${C0 extends Lowercase<C0> ? '' : '_'}${Lowercase<C0>}`> : P;
+type CamelKeysToSnake<T> = { [K in keyof T as CamelToSnake<Extract<K, string>>]: T[K] };
+type ResponseWrapperType<Response, RawData, T> = {
+  $raw: Response extends {
+    data: infer T;
+  } ? Response : Response extends unknown ? {
+    [i: string]: any;
+    data: RawData extends unknown ? CamelKeysToSnake<T> : RawData;
+  } : Response;
+  $request: {
+    path: string;
+    method: string;
+    [k: string]: string;
+  };
+  $serialized: T;
+};
+type ResponseProxyExtraRaw<T, RawData = unknown, Response = unknown> = T extends object ? T & ResponseWrapperType<Response, RawData, T> : T extends unknown ? T & ResponseWrapperType<Response, RawData, T> : unknown;
+//#endregion
+//#region core/client.d.ts
+declare class HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+  private readonly _endpoint;
+  private _adaptor;
+  private options;
+  private readonly _proxy;
+  constructor(_endpoint: string, _adaptor: T, options?: Omit<ClientOptions, 'controllers'>);
+  private initGetClient;
+  injectControllers(...Controller: Class<IController>[]): void;
+  injectControllers(Controller: Class<IController>[]): void;
+  get endpoint(): string;
+  get instance(): T;
+  request(options: {
+    url: string;
+    method?: string;
+    data?: any;
+    params?: any;
+  }): Promise<IAdaptorRequestResponseType<any>>;
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  private buildRoute;
+}
+declare function createClient<T extends IRequestAdapter>(adapter: T): <ResponseWrapper = (T extends {
+  responseWrapper: infer Type;
+} ? Type extends undefined ? unknown : Type : unknown)>(endpoint: string, options?: ClientOptions) => HTTPClient<T, ResponseWrapper>;
+//#endregion
+//#region core/error.d.ts
+declare class RequestError extends Error {
+  status: number;
+  path: string;
+  raw: any;
+  constructor(message: string, status: number, path: string, raw: any);
+}
+//#endregion
+//#region controllers/ack.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    ack: AckController<ResponseWrapper>;
+  }
+}
+/**
+ * @support core >= 4.4.0
+ */
+declare class AckController<ResponseWrapper> implements IController {
+  private client;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  read(type: 'post' | 'note', id: string): RequestProxyResult<never, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: never;
+  } : ResponseWrapper extends {
+    data: never;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: never;
+  }>;
+}
+//#endregion
+//#region ../../apps/core/src/constants/db.constant.d.ts
+declare enum CollectionRefTypes {
+  Post = "posts",
+  Note = "notes",
+  Page = "pages",
+  Recently = "recentlies"
+}
+//#endregion
+//#region models/base.d.ts
+interface Count {
+  read: number;
+  like: number;
+}
+interface Image {
+  height: number;
+  width: number;
+  type: string;
+  accent?: string;
+  src: string;
+  blurHash?: string;
+}
+interface Pager {
+  total: number;
+  size: number;
+  currentPage: number;
+  totalPage: number;
+  hasPrevPage: boolean;
+  hasNextPage: boolean;
+}
+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;
+};
+interface TranslationMeta {
+  sourceLang: string;
+  targetLang: string;
+  translatedAt: string;
+}
+type ModelWithTranslation<T> = T & {
+  isTranslated: boolean;
+  translationMeta?: TranslationMeta;
+  availableTranslations?: string[];
+};
+//#endregion
+//#region models/post.d.ts
+type PostModel = TextBaseModel & {
+  summary?: string | null;
+  copyright: boolean;
+  tags: string[];
+  count: Count;
+  slug: string;
+  categoryId: string;
+  images: Image[];
+  category: CategoryModel;
+  pin?: string | null;
+  pinOrder?: number;
+  related?: Pick<PostModel, 'id' | 'category' | 'categoryId' | 'created' | 'modified' | 'title' | 'slug' | 'summary'>[];
+};
+//#endregion
+//#region models/category.d.ts
+declare enum CategoryType {
+  Category = 0,
+  Tag = 1
+}
+interface CategoryModel extends BaseModel {
+  type: CategoryType;
+  count: number;
+  slug: string;
+  name: string;
+}
+type CategoryWithChildrenModel = CategoryModel & {
+  children: Pick<PostModel, 'id' | 'title' | 'slug' | 'modified' | 'created'>[];
+};
+type CategoryEntries = {
+  entries: Record<string, CategoryWithChildrenModel>;
+};
+interface TagModel {
+  count: number;
+  name: string;
+}
+//#endregion
+//#region models/activity.d.ts
+interface ActivityPresence {
+  operationTime: number;
+  identity: string;
+  roomName: string;
+  position: number;
+  joinedAt: number;
+  connectedAt: number;
+  updatedAt: number;
+  readerId?: string;
+  displayName?: string;
+}
+interface RoomOmittedNote {
+  title: string;
+  nid: number;
+  id: string;
+  created: string;
+}
+interface RoomOmittedPage {
+  title: string;
+  slug: string;
+  id: string;
+  created: string;
+}
+interface RoomOmittedPost {
+  slug: string;
+  title: string;
+  categoryId: string;
+  category: CategoryModel;
+  id: string;
+  created: string;
+}
+interface RoomsData {
+  rooms: string[];
+  roomCount: {
+    [key: string]: number;
+  };
+  objects: {
+    posts: RoomOmittedPost[];
+    notes: RoomOmittedNote[];
+    pages: RoomOmittedPage[];
+  };
+}
+interface RecentActivities {
+  like: RecentLike[];
+  comment: RecentComment[];
+  recent: RecentRecent[];
+  post: RecentPost[];
+  note: RecentNote[];
+}
+interface RecentComment {
+  created: string;
+  author: string;
+  text: string;
+  id: string;
+  title: string;
+  slug?: string;
+  type: string;
+  avatar: string;
+  nid?: string;
+}
+interface RecentLike {
+  created: string;
+  id: string;
+  type: CollectionRefTypes.Post | CollectionRefTypes.Note;
+  nid?: number;
+  slug?: string;
+  title: string;
+}
+interface RecentNote {
+  id: string;
+  created: string;
+  title: string;
+  modified: string;
+  nid: number;
+}
+interface RecentPost {
+  id: string;
+  created: string;
+  title: string;
+  modified: string;
+  slug: string;
+}
+interface RecentRecent {
+  id: string;
+  content: string;
+  up: number;
+  down: number;
+  created: string;
+}
+interface LastYearPublication {
+  posts: PostsItem[];
+  notes: NotesItem[];
+}
+interface PostsItem {
+  id: string;
+  created: string;
+  title: string;
+  slug: string;
+  categoryId: string;
+  category: Category;
+}
+interface Category {
+  id: string;
+  type: number;
+  name: string;
+  slug: string;
+  created: string;
+}
+interface NotesItem {
+  id: string;
+  created: string;
+  title: string;
+  mood: string;
+  weather: string;
+  nid: number;
+  bookmark: boolean;
+}
+//#endregion
+//#region models/topic.d.ts
+interface TopicModel extends BaseModel {
+  description?: string;
+  introduce: string;
+  name: string;
+  slug: string;
+  icon?: string;
+}
+//#endregion
+//#region models/note.d.ts
+type NoteModel = TextBaseModel & {
+  isPublished: boolean;
+  count: {
+    read: number;
+    like: number;
+  };
+  mood?: string;
+  weather?: string;
+  bookmark?: boolean;
+  publicAt?: Date;
+  password?: string | null;
+  nid: number;
+  slug?: string;
+  location?: string;
+  coordinates?: Coordinate;
+  topic?: TopicModel;
+  topicId?: string;
+};
+interface Coordinate {
+  latitude: number;
+  longitude: number;
+}
+interface NoteWrappedPayload {
+  data: NoteModel;
+  next?: Partial<NoteModel>;
+  prev?: Partial<NoteModel>;
+}
+interface NoteWrappedWithLikedPayload {
+  data: ModelWithLiked<NoteModel>;
+  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 {
+  'md' = "md",
+  'html' = "html",
+  'frame' = "frame"
+}
+type PageModel = TextBaseModel & {
+  created: string;
+  slug: string;
+  subtitle?: string;
+  order?: number;
+  type?: EnumPageType;
+  options?: object;
+};
+//#endregion
+//#region models/say.d.ts
+interface SayModel extends BaseModel {
+  text: string;
+  source?: string;
+  author?: string;
+}
+//#endregion
+//#region models/setting.d.ts
+declare class SeoOptionModel {
+  title: string;
+  description: string;
+  icon?: string;
+  keywords?: string[];
+}
+declare class UrlOptionModel {
+  webUrl: string;
+  adminUrl: string;
+  serverUrl: string;
+  wsUrl: string;
+}
+declare class SmtpOptionsModel {
+  port?: number;
+  host?: string;
+  secure?: boolean;
+}
+declare class SmtpConfigModel {
+  user?: string;
+  pass?: string;
+  options?: SmtpOptionsModel;
+}
+declare class ResendConfigModel {
+  apiKey?: string;
+}
+declare class MailOptionsModel {
+  enable: boolean;
+  provider?: 'smtp' | 'resend';
+  from?: string;
+  smtp?: SmtpConfigModel;
+  resend?: ResendConfigModel;
+}
+declare class CommentOptionsModel {
+  antiSpam: boolean;
+  disableComment: boolean;
+  allowGuestComment: boolean;
+  spamKeywords?: string[];
+  blockIps?: string[];
+  disableNoChinese?: boolean;
+}
+declare class BackupOptionsModel {
+  enable: boolean;
+  secretId?: string;
+  secretKey?: string;
+  bucket?: string;
+  region: string;
+}
+declare class BaiduSearchOptionsModel {
+  enable: boolean;
+  token?: string;
+}
+declare class BingSearchOptionsModel {
+  enable: boolean;
+  token?: string;
+}
+declare class AlgoliaSearchOptionsModel {
+  enable: boolean;
+  apiKey?: string;
+  appId?: string;
+  indexName?: string;
+}
+declare class AdminExtraModel {
+  background?: string;
+  gaodemapKey?: string;
+  title?: string;
+  /**
+   * 是否开启后台反代访问
+   */
+  enableAdminProxy?: boolean;
+}
+declare class ThirdPartyServiceIntegrationModel {
+  githubToken?: string;
+}
+interface IConfig {
+  seo: SeoOptionModel;
+  url: UrlOptionModel;
+  mailOptions: MailOptionsModel;
+  commentOptions: CommentOptionsModel;
+  backupOptions: BackupOptionsModel;
+  baiduSearchOptions: BaiduSearchOptionsModel;
+  algoliaSearchOptions: AlgoliaSearchOptionsModel;
+  adminExtra: AdminExtraModel;
+  thirdPartyServiceIntegration: ThirdPartyServiceIntegrationModel;
+}
+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>;
+  username: string;
+  modified: string;
+  v: number;
+  lastLoginTime: string;
+  lastLoginIp?: string;
+  avatar: string;
+  postID: string;
+}
+type TLogin = {
+  token: string;
+  expiresIn: number;
+  lastLoginTime: null | string;
+  lastLoginIp?: null | string;
+} & Pick<UserModel, 'name' | 'username' | 'created' | 'url' | 'mail' | 'avatar' | 'id'>;
+type BetterAuthUserRole = 'owner' | 'reader';
+interface BetterAuthUser {
+  id: string;
+  email?: string | null;
+  name?: string | null;
+  image?: string | null;
+  role?: BetterAuthUserRole;
+  handle?: string | null;
+  username?: string | null;
+  displayUsername?: string | null;
+  [key: string]: unknown;
+}
+interface BetterAuthSession {
+  id?: string;
+  token: string;
+  userId: string;
+  expiresAt: string;
+  createdAt: string;
+  updatedAt: string;
+  ipAddress?: string | null;
+  userAgent?: string | null;
+  provider?: string | null;
+  [key: string]: unknown;
+}
+interface BetterAuthSignInResult {
+  token: string;
+  user: BetterAuthUser;
+}
+interface BetterAuthSessionResult {
+  session: BetterAuthSession;
+  user: BetterAuthUser;
+}
+interface OwnerSessionResult extends BetterAuthUser {
+  provider?: string;
+  providerAccountId?: string;
+  session?: BetterAuthSession;
+}
+type CheckLoggedResult = {
+  ok: number;
+  isGuest: boolean;
+};
+type OwnerAllowLoginResult = {
+  password: boolean;
+  passkey: boolean;
+} & Record<string, boolean>;
+//#endregion
+//#region models/aggregate.d.ts
+interface AggregateAIConfig {
+  enableSummary: boolean;
+}
+interface AggregateRoot {
+  user: UserModel;
+  seo: SeoOptionModel;
+  url: Url;
+  commentOptions?: Pick<CommentOptionsModel, 'disableComment' | 'allowGuestComment'>;
+  categories: CategoryModel[];
+  pageMeta: Pick<PageModel, 'title' | 'id' | 'slug' | 'order'>[] | null;
+  /**
+   * @available 4.2.2
+   */
+  latestNoteId: {
+    id: string;
+    nid: number;
+  };
+  /**
+   * @available 9.2.0
+   */
+  ai?: AggregateAIConfig;
+}
+interface AggregateRootWithTheme<Theme = unknown> extends AggregateRoot {
+  theme?: Theme;
+}
+interface Url {
+  wsUrl: string;
+  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 AggregateTop {
+  notes: AggregateTopNote[];
+  posts: AggregateTopPost[];
+  says: SayModel[];
+}
+declare enum TimelineType {
+  Post = 0,
+  Note = 1
+}
+interface TimelineData {
+  notes?: Pick<NoteModel, 'id' | 'nid' | 'title' | 'weather' | 'mood' | 'created' | 'modified' | 'bookmark'>[];
+  posts?: (Pick<PostModel, 'id' | 'title' | 'slug' | 'created' | 'modified' | 'category'> & {
+    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;
+  comments: number;
+  linkApply: number;
+  links: number;
+  notes: number;
+  pages: number;
+  posts: number;
+  says: number;
+  recently: number;
+  unreadComments: number;
+  online: number;
+  todayMaxOnline: string;
+  todayOnlineTotal: string;
+  callTime: number;
+  uv: number;
+  todayIpAccessCount: number;
+}
+//#endregion
+//#region models/ai.d.ts
+interface AISummaryModel {
+  id: string;
+  created: string;
+  summary: string;
+  hash: string;
+  refId: string;
+  lang: string;
+}
+interface AITranslationModel {
+  id: string;
+  created: string;
+  hash: string;
+  refId: string;
+  refType: string;
+  lang: string;
+  sourceLang: string;
+  title: string;
+  text: string;
+  subtitle?: string;
+  summary?: string;
+  tags?: string[];
+  aiModel?: string;
+  aiProvider?: string;
+}
+interface AIDeepReadingModel {
+  id: string;
+  hash: string;
+  refId: string;
+  keyPoints: string[];
+  criticalAnalysis: string;
+  content: string;
+}
+/**
+ * SSE Stream Event Types
+ *
+ * Note: All data fields are transmitted as strings over SSE.
+ * Objects are JSON.stringify'd before sending.
+ */
+type AISummaryStreamEvent = {
+  type: 'token';
+  data: string;
+} | {
+  type: 'done';
+  data: undefined;
+} | {
+  type: 'error';
+  data: string;
+};
+type AITranslationStreamEvent = {
+  type: 'token';
+  data: string;
+} | {
+  type: 'done';
+  data: undefined;
+} | {
+  type: 'error';
+  data: string;
+};
+//#endregion
+//#region models/auth.d.ts
+interface AuthUser {
+  id: string;
+  email: string;
+  isOwner: boolean;
+  image: string;
+  name: string;
+  provider: string;
+  handle: string;
+}
+//#endregion
+//#region models/comment.d.ts
+interface CommentModel extends BaseModel {
+  refType: CollectionRefTypes;
+  ref: string;
+  state: number;
+  author: string;
+  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;
+}
+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;
+  slug: string;
+  title: string;
+  category?: CategoryModel;
+}
+declare enum CommentState {
+  Unread = 0,
+  Read = 1,
+  Junk = 2
+}
+//#endregion
+//#region models/link.d.ts
+declare enum LinkType {
+  Friend = 0,
+  Collection = 1
+}
+declare enum LinkState {
+  Pass = 0,
+  Audit = 1,
+  Outdate = 2,
+  Banned = 3,
+  Reject = 4
+}
+interface LinkModel extends BaseModel {
+  name: string;
+  url: string;
+  avatar: string;
+  description?: string;
+  type: LinkType;
+  state: LinkState;
+  hide: boolean;
+  email: string;
+}
+//#endregion
+//#region models/project.d.ts
+interface ProjectModel extends BaseModel {
+  name: string;
+  previewUrl?: string;
+  docUrl?: string;
+  projectUrl?: string;
+  images?: string[];
+  description: string;
+  avatar?: string;
+  text: string;
+}
+//#endregion
+//#region models/reader.d.ts
+interface ReaderModel {
+  email: string;
+  name: string;
+  handle: string;
+  image: string;
+  role?: 'reader' | 'owner';
+}
+//#endregion
+//#region models/recently.d.ts
+declare enum RecentlyRefTypes {
+  Post = "Post",
+  Note = "Note",
+  Page = "Page"
+}
+type RecentlyRefType = {
+  title: string;
+  url: string;
+};
+declare enum RecentlyTypeEnum {
+  Text = "text",
+  Book = "book",
+  Media = "media",
+  Music = "music",
+  Github = "github",
+  Link = "link",
+  Academic = "academic",
+  Code = "code"
+}
+interface BookMetadata {
+  url: string;
+  title: string;
+  author: string;
+  cover?: string;
+  rating?: number;
+  isbn?: string;
+}
+interface MediaMetadata {
+  url: string;
+  title: string;
+  originalTitle?: string;
+  cover?: string;
+  rating?: number;
+  description?: string;
+  genre?: string;
+}
+interface MusicMetadata {
+  url: string;
+  title: string;
+  artist: string;
+  album?: string;
+  cover?: string;
+  source?: string;
+}
+interface GithubMetadata {
+  url: string;
+  owner: string;
+  repo: string;
+  description?: string;
+  stars?: number;
+  language?: string;
+  languageColor?: string;
+}
+interface LinkMetadata {
+  url: string;
+  title?: string;
+  description?: string;
+  image?: string;
+}
+interface AcademicMetadata {
+  url: string;
+  title: string;
+  authors?: string[];
+  arxivId?: string;
+}
+interface CodeMetadata {
+  url: string;
+  title: string;
+  difficulty?: string;
+  tags?: string[];
+  platform?: string;
+}
+type RecentlyMetadata = BookMetadata | MediaMetadata | MusicMetadata | GithubMetadata | LinkMetadata | AcademicMetadata | CodeMetadata;
+interface RecentlyModel extends BaseCommentIndexModel {
+  content: string;
+  type: RecentlyTypeEnum;
+  metadata?: RecentlyMetadata;
+  ref?: RecentlyRefType & {
+    [key: string]: any;
+  };
+  refId?: string;
+  refType?: RecentlyRefTypes;
+  up: number;
+  down: number;
+  modified?: string;
+}
+//#endregion
+//#region models/snippet.d.ts
+declare enum SnippetType {
+  JSON = "json",
+  Function = "function",
+  Text = "text",
+  YAML = "yaml"
+}
+interface SnippetModel<T = unknown> extends BaseModel {
+  type: SnippetType;
+  private: boolean;
+  raw: string;
+  name: string;
+  reference: string;
+  comment?: string;
+  metatype?: string;
+  schema?: string;
+  data: T;
+}
+//#endregion
+//#region ../../apps/core/src/modules/subscribe/subscribe.constant.d.ts
+declare const SubscribePostCreateBit = 1;
+declare const SubscribeNoteCreateBit: number;
+declare const SubscribeSayCreateBit: number;
+declare const SubscribeRecentCreateBit: number;
+declare const SubscribeAllBit: number;
+declare const SubscribeTypeToBitMap: {
+  post_c: number;
+  note_c: number;
+  say_c: number;
+  recently_c: number;
+  all: number;
+};
+//#endregion
+//#region models/subscribe.d.ts
+type SubscribeType = keyof typeof SubscribeTypeToBitMap;
+//#endregion
+//#region controllers/activity.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    activity: ActivityController<ResponseWrapper>;
+  }
+}
+/**
+ * @support core >= 4.3.0
+ */
+declare class ActivityController<ResponseWrapper> implements IController {
+  private client;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  likeIt(type: 'Post' | 'Note', id: string): RequestProxyResult<never, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: never;
+  } : ResponseWrapper extends {
+    data: never;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: never;
+  }>;
+  /**
+   *
+   * @support core >= 5.0.0
+   */
+  getPresence(roomName: string): RequestProxyResult<{
+    data: Record<string, ActivityPresence>;
+    readers: Record<string, AuthUser>;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      data: Record<string, ActivityPresence>;
+      readers: Record<string, AuthUser>;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      data: Record<string, ActivityPresence>;
+      readers: Record<string, AuthUser>;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      data: Record<string, ActivityPresence>;
+      readers: Record<string, AuthUser>;
+    };
+  }>;
+  /**
+   *
+   * @support core >= 5.0.0
+   */
+  updatePresence({
+    identity,
+    position,
+    roomName,
+    sid,
+    ts,
+    displayName,
+    readerId
+  }: {
+    roomName: string;
+    position: number;
+    identity: string;
+    sid: string;
+    displayName?: string;
+    ts?: number;
+    readerId?: string;
+  }): RequestProxyResult<unknown, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: unknown;
+  } : ResponseWrapper extends {
+    data: unknown;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: unknown;
+  }>;
+  getRoomsInfo(): Promise<RoomsData & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: RoomsData;
+      } : ResponseWrapper extends {
+        data: RoomsData;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: RoomsData;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: RoomsData;
+      } : ResponseWrapper extends {
+        data: RoomsData;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: RoomsData;
+      }) ? T_1 extends unknown ? {
+        rooms: string[];
+        room_count: {
+          [key: string]: number;
+        };
+        objects: {
+          posts: RoomOmittedPost[];
+          notes: RoomOmittedNote[];
+          pages: RoomOmittedPage[];
+        };
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: RoomsData;
+  }>;
+  getRecentActivities(): Promise<RecentActivities & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: RecentActivities;
+      } : ResponseWrapper extends {
+        data: RecentActivities;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: RecentActivities;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: RecentActivities;
+      } : ResponseWrapper extends {
+        data: RecentActivities;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: RecentActivities;
+      }) ? T_1 extends unknown ? {
+        like: RecentLike[];
+        comment: RecentComment[];
+        recent: RecentRecent[];
+        post: RecentPost[];
+        note: RecentNote[];
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: RecentActivities;
+  }>;
+  getLastYearPublication(): Promise<LastYearPublication>;
+}
+//#endregion
+//#region interfaces/options.d.ts
+type SortOrder = 'asc' | 'desc';
+//#endregion
+//#region controllers/aggregate.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    aggregate: AggregateController<ResponseWrapper>;
+  }
+}
+declare class AggregateController<ResponseWrapper> implements IController {
+  private client;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 获取聚合数据
+   */
+  getAggregateData<Theme>(theme?: string): RequestProxyResult<AggregateRootWithTheme<Theme>, ResponseWrapper>;
+  /**
+   * 获取最新发布的内容
+   */
+  getTop(size?: number): RequestProxyResult<AggregateTop, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: AggregateTop;
+  } : ResponseWrapper extends {
+    data: AggregateTop;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: AggregateTop;
+  }>;
+  getTimeline(options?: {
+    sort?: SortOrder;
+    type?: TimelineType;
+    year?: number;
+  }): RequestProxyResult<{
+    data: TimelineData;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      data: TimelineData;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      data: TimelineData;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      data: TimelineData;
+    };
+  }>;
+  getLatest(options: {
+    limit?: number;
+    types?: TimelineType[];
+    combined: true;
+  }): RequestProxyResult<LatestCombinedItem[], ResponseWrapper>;
+  getLatest(options?: {
+    limit?: number;
+    types?: TimelineType[];
+    combined?: false;
+  }): RequestProxyResult<LatestData, ResponseWrapper>;
+  /**
+   * 获取聚合数据统计
+   */
+  getStat(): RequestProxyResult<AggregateStat, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: AggregateStat;
+  } : ResponseWrapper extends {
+    data: AggregateStat;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: AggregateStat;
+  }>;
+}
+//#endregion
+//#region controllers/ai.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    ai: AIController<ResponseWrapper>;
+  }
+}
+/**
+ * @support core >= 5.6.0
+ */
+declare class AIController<ResponseWrapper> implements IController {
+  private client;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  getSummary({
+    articleId,
+    lang,
+    onlyDb
+  }: {
+    articleId: string;
+    lang?: string;
+    onlyDb?: boolean;
+  }): Promise<AISummaryModel & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AISummaryModel;
+      } : ResponseWrapper extends {
+        data: AISummaryModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AISummaryModel;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AISummaryModel;
+      } : ResponseWrapper extends {
+        data: AISummaryModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AISummaryModel;
+      }) ? T_1 extends unknown ? {
+        id: string;
+        created: string;
+        summary: string;
+        hash: string;
+        ref_id: string;
+        lang: string;
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: AISummaryModel;
+  }>;
+  generateSummary(articleId: string, lang?: string, token?: string): Promise<AISummaryModel & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AISummaryModel;
+      } : ResponseWrapper extends {
+        data: AISummaryModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AISummaryModel;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AISummaryModel;
+      } : ResponseWrapper extends {
+        data: AISummaryModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AISummaryModel;
+      }) ? T_1 extends unknown ? {
+        id: string;
+        created: string;
+        summary: string;
+        hash: string;
+        ref_id: string;
+        lang: string;
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: AISummaryModel;
+  }>;
+  /**
+   * Core >= 8.3.0
+   * @param articleId
+   */
+  getDeepReading(articleId: string): Promise<AIDeepReadingModel & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AIDeepReadingModel;
+      } : ResponseWrapper extends {
+        data: AIDeepReadingModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AIDeepReadingModel;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AIDeepReadingModel;
+      } : ResponseWrapper extends {
+        data: AIDeepReadingModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AIDeepReadingModel;
+      }) ? T_1 extends unknown ? {
+        id: string;
+        hash: string;
+        ref_id: string;
+        key_points: string[];
+        critical_analysis: string;
+        content: string;
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: AIDeepReadingModel;
+  }>;
+  /**
+   * Get translation for an article
+   * @support core >= 9.4.0
+   */
+  getTranslation({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang: string;
+  }): Promise<AITranslationModel & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AITranslationModel;
+      } : ResponseWrapper extends {
+        data: AITranslationModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AITranslationModel;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AITranslationModel;
+      } : ResponseWrapper extends {
+        data: AITranslationModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AITranslationModel;
+      }) ? T_1 extends unknown ? {
+        id: string;
+        created: string;
+        hash: string;
+        ref_id: string;
+        ref_type: string;
+        lang: string;
+        source_lang: string;
+        title: string;
+        text: string;
+        subtitle?: string | undefined;
+        summary?: string | undefined;
+        tags?: string[] | undefined;
+        ai_model?: string | undefined;
+        ai_provider?: string | undefined;
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: AITranslationModel;
+  }>;
+  /**
+   * Get available translation languages for an article
+   * @support core >= 9.4.0
+   */
+  getAvailableLanguages(articleId: string): Promise<string[] & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: string[];
+      } : ResponseWrapper extends {
+        data: string[];
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: string[];
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: string[];
+      } : ResponseWrapper extends {
+        data: string[];
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: string[];
+      }) ? T_1 extends unknown ? {
+        length: number;
+        to_string: () => string;
+        to_locale_string: {
+          (): string;
+          (locales: string | string[], options?: Intl.NumberFormatOptions & Intl.DateTimeFormatOptions): string;
+        };
+        pop: () => string | undefined;
+        push: (...items: string[]) => number;
+        concat: {
+          (...items: ConcatArray<string>[]): string[];
+          (...items: (string | ConcatArray<string>)[]): string[];
+        };
+        join: (separator?: string) => string;
+        reverse: () => string[];
+        shift: () => string | undefined;
+        slice: (start?: number, end?: number) => string[];
+        sort: (compareFn?: ((a: string, b: string) => number) | undefined) => string[];
+        splice: {
+          (start: number, deleteCount?: number): string[];
+          (start: number, deleteCount: number, ...items: string[]): string[];
+        };
+        unshift: (...items: string[]) => number;
+        index_of: (searchElement: string, fromIndex?: number) => number;
+        last_index_of: (searchElement: string, fromIndex?: number) => number;
+        every: {
+          <S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): this is S[];
+          (predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): boolean;
+        };
+        some: (predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any) => boolean;
+        for_each: (callbackfn: (value: string, index: number, array: string[]) => void, thisArg?: any) => void;
+        map: <U>(callbackfn: (value: string, index: number, array: string[]) => U, thisArg?: any) => U[];
+        filter: {
+          <S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): S[];
+          (predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): string[];
+        };
+        reduce: {
+          (callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
+          (callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
+          <U>(callbackfn: (previousValue: U, currentValue: string, currentIndex: number, array: string[]) => U, initialValue: U): U;
+        };
+        reduce_right: {
+          (callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string): string;
+          (callbackfn: (previousValue: string, currentValue: string, currentIndex: number, array: string[]) => string, initialValue: string): string;
+          <U>(callbackfn: (previousValue: U, currentValue: string, currentIndex: number, array: string[]) => U, initialValue: U): U;
+        };
+        find: {
+          <S extends string>(predicate: (value: string, index: number, obj: string[]) => value is S, thisArg?: any): S | undefined;
+          (predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any): string | undefined;
+        };
+        find_index: (predicate: (value: string, index: number, obj: string[]) => unknown, thisArg?: any) => number;
+        fill: (value: string, start?: number, end?: number) => string[];
+        copy_within: (target: number, start: number, end?: number) => string[];
+        entries: () => ArrayIterator<[number, string]>;
+        keys: () => ArrayIterator<number>;
+        values: () => ArrayIterator<string>;
+        includes: (searchElement: string, fromIndex?: number) => boolean;
+        flat_map: <U, This = undefined>(callback: (this: This, value: string, index: number, array: string[]) => U | readonly U[], thisArg?: This | undefined) => U[];
+        flat: <A, D extends number = 1>(this: A, depth?: D | undefined) => FlatArray<A, D>[];
+        at: (index: number) => string | undefined;
+        find_last: {
+          <S extends string>(predicate: (value: string, index: number, array: string[]) => value is S, thisArg?: any): S | undefined;
+          (predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any): string | undefined;
+        };
+        find_last_index: (predicate: (value: string, index: number, array: string[]) => unknown, thisArg?: any) => number;
+        to_reversed: () => string[];
+        to_sorted: (compareFn?: ((a: string, b: string) => number) | undefined) => string[];
+        to_spliced: {
+          (start: number, deleteCount: number, ...items: string[]): string[];
+          (start: number, deleteCount?: number): string[];
+        };
+        with: (index: number, value: string) => string[];
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: string[];
+  }>;
+  /**
+   * Get URL for streaming summary generation (SSE)
+   *
+   * @see AISummaryStreamEvent for event types
+   * @support core >= 9.4.0
+   */
+  getSummaryGenerateUrl({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang?: string;
+  }): string;
+  /**
+   * Stream summary generation using fetch
+   *
+   * @see AISummaryStreamEvent for event types
+   * @support core >= 9.4.0
+   */
+  streamSummaryGenerate({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang?: string;
+  }, fetchOptions?: RequestInit): Promise<Response>;
+  /**
+   * Get URL for streaming translation generation (SSE)
+   *
+   * @see AITranslationStreamEvent for event types
+   * @support core >= 9.4.0
+   */
+  getTranslationGenerateUrl({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang: string;
+  }): string;
+  /**
+   * Stream translation generation using fetch
+   *
+   * @see AITranslationStreamEvent for event types
+   * @support core >= 9.4.0
+   */
+  streamTranslationGenerate({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang: string;
+  }, fetchOptions?: RequestInit): Promise<Response>;
+}
+//#endregion
+//#region controllers/category.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    category: CategoryController<ResponseWrapper>;
+  }
+}
+declare class CategoryController<ResponseWrapper> implements IController {
+  private client;
+  name: string;
+  base: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  getAllCategories(): RequestProxyResult<{
+    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 & {
+    children: Pick<PostModel, "id" | "title" | "slug" | "modified" | "created">[];
+  } & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: CategoryWithChildrenModel;
+      } : ResponseWrapper extends {
+        data: CategoryWithChildrenModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: CategoryWithChildrenModel;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: CategoryWithChildrenModel;
+      } : ResponseWrapper extends {
+        data: CategoryWithChildrenModel;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: CategoryWithChildrenModel;
+      }) ? T_1 extends unknown ? {
+        type: CategoryType;
+        count: number;
+        slug: string;
+        name: string;
+        created: string;
+        id: string;
+        children: Pick<PostModel, "id" | "created" | "title" | "slug" | "modified">[];
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: CategoryWithChildrenModel;
+  }>;
+  getTagByName(name: string): Promise<{
+    tag: string;
+    data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+  } & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: {
+          tag: string;
+          data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+        };
+      } : ResponseWrapper extends {
+        data: {
+          tag: string;
+          data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+        };
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: {
+          tag: string;
+          data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+        };
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: {
+          tag: string;
+          data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+        };
+      } : ResponseWrapper extends {
+        data: {
+          tag: string;
+          data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+        };
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: {
+          tag: string;
+          data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+        };
+      }) ? T_1 extends unknown ? {
+        tag: string;
+        data: Pick<PostModel, "category" | "id" | "created" | "title" | "slug">[];
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: {
+      tag: string;
+      data: Pick<PostModel, "id" | "title" | "slug" | "category" | "created">[];
+    };
+  }>;
+}
+//#endregion
+//#region interfaces/params.d.ts
+interface PaginationParams {
+  size?: number;
+  page?: number;
+}
+//#endregion
+//#region dtos/comment.d.ts
+interface AnonymousCommentDto {
+  author: string;
+  text: string;
+  mail: string;
+  url?: string;
+  avatar?: string;
+  isWhispers?: boolean;
+}
+interface ReaderCommentDto {
+  text: string;
+  isWhispers?: boolean;
+}
+type CommentDto = AnonymousCommentDto | ReaderCommentDto;
+//#endregion
+//#region controllers/comment.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    comment: CommentController<ResponseWrapper>;
+  }
+}
+declare class CommentController<ResponseWrapper> implements IController {
+  private readonly client;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 根据 comment id 获取评论，包括子评论
+   */
+  getById(id: string): RequestProxyResult<CommentModel & {
+    ref: string;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentModel & {
+      ref: string;
+    };
+  } : ResponseWrapper extends {
+    data: CommentModel & {
+      ref: string;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentModel & {
+      ref: string;
+    };
+  }>;
+  /**
+   * 获取文章的评论列表
+   * @param refId 文章 Id
+   */
+  getByRefId(refId: string, pagination?: PaginationParams): RequestProxyResult<PaginateResult<CommentThreadItem & {
+    ref: string;
+  }> & {
+    readers: Record<string, ReaderModel>;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PaginateResult<CommentThreadItem & {
+      ref: string;
+    }> & {
+      readers: Record<string, ReaderModel>;
+    };
+  } : ResponseWrapper extends {
+    data: PaginateResult<CommentThreadItem & {
+      ref: string;
+    }> & {
+      readers: Record<string, ReaderModel>;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    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;
+  }>;
+  /**
+   * 评论
+   */
+  guestComment(refId: string, data: AnonymousCommentDto): RequestProxyResult<CommentModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentModel;
+  } : ResponseWrapper extends {
+    data: CommentModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentModel;
+  }>;
+  /**
+   * 回复评论
+   */
+  guestReply(commentId: string, data: AnonymousCommentDto): RequestProxyResult<CommentModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentModel;
+  } : ResponseWrapper extends {
+    data: CommentModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentModel;
+  }>;
+  readerComment(refId: string, data: ReaderCommentDto): RequestProxyResult<CommentModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentModel;
+  } : ResponseWrapper extends {
+    data: CommentModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentModel;
+  }>;
+  readerReply(commentId: string, data: ReaderCommentDto): RequestProxyResult<CommentModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CommentModel;
+  } : ResponseWrapper extends {
+    data: CommentModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CommentModel;
+  }>;
+}
+//#endregion
+//#region controllers/base.d.ts
+type SortOptions = {
+  sortBy?: string;
+  sortOrder?: 1 | -1 | 'asc' | 'desc';
+};
+declare abstract class BaseCrudController<T, ResponseWrapper> {
+  protected client: HTTPClient;
+  base: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  getById(id: string): RequestProxyResult<T, ResponseWrapper>;
+  getAll(): RequestProxyResult<{
+    data: T[];
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      data: T[];
+    };
+  } : ResponseWrapper extends {
+    data: {
+      data: T[];
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      data: T[];
+    };
+  }>;
+  /**
+   * 带分页的查询
+   * @param page
+   * @param perPage
+   */
+  getAllPaginated(page?: number, perPage?: number, sortOption?: SortOptions): RequestProxyResult<PaginateResult<T>, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PaginateResult<T>;
+  } : ResponseWrapper extends {
+    data: PaginateResult<T>;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: PaginateResult<T>;
+  }>;
+}
+//#endregion
+//#region controllers/link.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    link: LinkController<ResponseWrapper>;
+    friend: LinkController<ResponseWrapper>;
+  }
+}
+declare class LinkController<ResponseWrapper> extends BaseCrudController<LinkModel, ResponseWrapper> {
+  protected readonly client: HTTPClient;
+  constructor(client: HTTPClient);
+  canApplyLink(): Promise<boolean>;
+  applyLink(data: Pick<LinkModel, 'avatar' | 'name' | 'description' | 'url' | 'email'> & {
+    author: string;
+  }): Promise<never>;
+  name: string[];
+  base: string;
+}
+//#endregion
+//#region controllers/note.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    note: NoteController<ResponseWrapper>;
+  }
+}
+type NoteListOptions = {
+  select?: SelectFields<keyof NoteModel>;
+  year?: number;
+  sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified';
+  sortOrder?: 1 | -1;
+  lang?: string;
+  withSummary?: boolean;
+};
+type NoteByNidOptions = {
+  password?: string;
+  single?: boolean;
+  lang?: string;
+  prefer?: 'lexical';
+};
+type NoteBySlugDateOptions = NoteByNidOptions;
+type NoteMiddleListOptions = {
+  lang?: string;
+};
+type NoteTopicListOptions = SortOptions & {
+  lang?: string;
+};
+type NoteTimelineItem = Pick<NoteModel, 'id' | 'title' | 'nid' | 'slug' | 'created' | 'isPublished'> & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
+};
+type NoteTopicListItem = NoteModel & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
+};
+declare class NoteController<ResponseWrapper> implements IController {
+  private client;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 最新日记
+   */
+  getLatest(): RequestProxyResult<NoteWrappedWithLikedPayload, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: NoteWrappedWithLikedPayload;
+  } : ResponseWrapper extends {
+    data: NoteWrappedWithLikedPayload;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: NoteWrappedWithLikedPayload;
+  }>;
+  /**
+   * 获取一篇日记，根据 Id 查询需要鉴权
+   * @param id id | nid
+   * @param password 访问密码
+   */
+  getNoteById(id: string): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
+  getNoteById(id: number): Promise<NoteWrappedPayload>;
+  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>;
+  getNoteBySlugDate(year: number, month: number, day: number, slug: string, options?: NoteBySlugDateOptions): RequestProxyResult<NoteWrappedWithLikedAndTranslationPayload, ResponseWrapper>;
+  /**
+   * 日记列表分页
+   */
+  getList(page?: number, perPage?: number, options?: NoteListOptions): RequestProxyResult<PaginateResult<NoteModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PaginateResult<NoteModel>;
+  } : ResponseWrapper extends {
+    data: PaginateResult<NoteModel>;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: PaginateResult<NoteModel>;
+  }>;
+  /**
+   * 获取当前日记的上下各 n / 2 篇日记
+   * @param id 当前日记 ID
+   * @param size 返回数量，默认 5
+   * @param options 可选参数，包含 lang 用于获取翻译版本
+   */
+  getMiddleList(id: string, size?: number, options?: NoteMiddleListOptions): RequestProxyResult<{
+    data: NoteTimelineItem[];
+    size: number;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      data: NoteTimelineItem[];
+      size: number;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      data: NoteTimelineItem[];
+      size: number;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      data: NoteTimelineItem[];
+      size: number;
+    };
+  }>;
+  /**
+   * 获取专栏内的所有日记
+   * @param topicId 专栏 ID
+   * @param page 页码，默认 1
+   * @param size 每页数量，默认 10
+   * @param options 可选参数，包含排序选项和 lang 用于获取翻译版本
+   */
+  getNoteByTopicId(topicId: string, page?: number, size?: number, options?: NoteTopicListOptions): RequestProxyResult<PaginateResult<NoteTopicListItem>, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PaginateResult<NoteTopicListItem>;
+  } : ResponseWrapper extends {
+    data: PaginateResult<NoteTopicListItem>;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: PaginateResult<NoteTopicListItem>;
+  }>;
+}
+//#endregion
+//#region controllers/owner.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    owner: UserController<ResponseWrapper>;
+  }
+}
+declare class UserController<ResponseWrapper> implements IController {
+  private readonly client;
+  constructor(client: HTTPClient);
+  base: string;
+  name: string[];
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  private get authProxy();
+  private normalizeToken;
+  /**
+   * @deprecated Use `getOwnerInfo()` instead.
+   */
+  getMasterInfo(): RequestProxyResult<UserModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: UserModel;
+  } : ResponseWrapper extends {
+    data: UserModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: UserModel;
+  }>;
+  getOwnerInfo(): RequestProxyResult<UserModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: UserModel;
+  } : ResponseWrapper extends {
+    data: UserModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: UserModel;
+  }>;
+  login(username: string, password: string, options?: {
+    callbackURL?: string;
+    rememberMe?: boolean;
+  }): RequestProxyResult<BetterAuthSignInResult, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: BetterAuthSignInResult;
+  } : ResponseWrapper extends {
+    data: BetterAuthSignInResult;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: BetterAuthSignInResult;
+  }>;
+  logout(): RequestProxyResult<{
+    success: boolean;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      success: boolean;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      success: boolean;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      success: boolean;
+    };
+  }>;
+  /**
+   * Better Auth raw session (`/auth/get-session`).
+   */
+  getAuthSession(options?: {
+    disableCookieCache?: boolean;
+    disableRefresh?: boolean;
+  }): RequestProxyResult<BetterAuthSessionResult | null, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: BetterAuthSessionResult | null;
+  } : ResponseWrapper extends {
+    data: BetterAuthSessionResult | null;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: BetterAuthSessionResult | null;
+  }>;
+  /**
+   * Core session summary (`/auth/session`).
+   */
+  getSession(): RequestProxyResult<OwnerSessionResult | null, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: OwnerSessionResult | null;
+  } : ResponseWrapper extends {
+    data: OwnerSessionResult | null;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: OwnerSessionResult | null;
+  }>;
+  getProviders(): RequestProxyResult<string[], ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: string[];
+  } : ResponseWrapper extends {
+    data: string[];
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: string[];
+  }>;
+  getAllowLoginMethods(): RequestProxyResult<OwnerAllowLoginResult, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: OwnerAllowLoginResult;
+  } : ResponseWrapper extends {
+    data: OwnerAllowLoginResult;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: OwnerAllowLoginResult;
+  }>;
+  listSessions(): RequestProxyResult<BetterAuthSession[], ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: BetterAuthSession[];
+  } : ResponseWrapper extends {
+    data: BetterAuthSession[];
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: BetterAuthSession[];
+  }>;
+  revokeSession(token: string): RequestProxyResult<{
+    status: boolean;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      status: boolean;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      status: boolean;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      status: boolean;
+    };
+  }>;
+  revokeSessions(): RequestProxyResult<{
+    status: boolean;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      status: boolean;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      status: boolean;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      status: boolean;
+    };
+  }>;
+  revokeOtherSessions(): RequestProxyResult<{
+    status: boolean;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      status: boolean;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      status: boolean;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      status: boolean;
+    };
+  }>;
+  checkTokenValid(token?: string): RequestProxyResult<CheckLoggedResult, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: CheckLoggedResult;
+  } : ResponseWrapper extends {
+    data: CheckLoggedResult;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: CheckLoggedResult;
+  }>;
+}
+//#endregion
+//#region controllers/page.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    page: PageController<ResponseWrapper>;
+  }
+}
+type PageListOptions = {
+  select?: SelectFields<keyof PageModel>;
+  sortBy?: 'order' | 'subtitle' | 'title' | 'created' | 'modified';
+  sortOrder?: 1 | -1;
+};
+declare class PageController<ResponseWrapper> implements IController {
+  private readonly client;
+  constructor(client: HTTPClient);
+  base: string;
+  name: string;
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 页面列表
+   */
+  getList(page?: number, perPage?: number, options?: PageListOptions): RequestProxyResult<PaginateResult<PageModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PaginateResult<PageModel>;
+  } : ResponseWrapper extends {
+    data: PaginateResult<PageModel>;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: PaginateResult<PageModel>;
+  }>;
+  /**
+   * 页面详情
+   */
+  getById(id: string): RequestProxyResult<PageModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PageModel;
+  } : ResponseWrapper extends {
+    data: PageModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: PageModel;
+  }>;
+  /**
+   * 根据路径获取页面
+   * @param slug 路径
+   * @returns
+   */
+  getBySlug(slug: string, options?: {
+    prefer?: 'lexical';
+  }): RequestProxyResult<PageModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PageModel;
+  } : ResponseWrapper extends {
+    data: PageModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: PageModel;
+  }>;
+}
+//#endregion
+//#region controllers/post.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    post: PostController<ResponseWrapper>;
+  }
+}
+type PostListOptions = {
+  select?: SelectFields<keyof PostModel>;
+  year?: number;
+  sortBy?: 'categoryId' | 'title' | 'created' | 'modified';
+  sortOrder?: 1 | -1;
+  truncate?: number; /** 语言代码，用于获取翻译版本 */
+  lang?: string;
+};
+/** 文章列表项，可能包含翻译信息 */
+type PostListItem = PostModel & {
+  isTranslated?: boolean;
+  translationMeta?: TranslationMeta;
+};
+declare class PostController<ResponseWrapper> implements IController {
+  private client;
+  constructor(client: HTTPClient);
+  base: string;
+  name: string;
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 获取文章列表分页
+   * @param page
+   * @param perPage
+   * @param options 可选参数，包含 lang 用于获取翻译版本
+   * @returns 当传入 lang 时，返回的文章可能包含 isTranslated 和 translationMeta 字段
+   */
+  getList(page?: number, perPage?: number, options?: PostListOptions): RequestProxyResult<PaginateResult<PostListItem>, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: PaginateResult<PostListItem>;
+  } : ResponseWrapper extends {
+    data: PaginateResult<PostListItem>;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: PaginateResult<PostListItem>;
+  }>;
+  /**
+   * 根据分类和路径查找文章
+   * @param categoryName
+   * @param slug
+   * @param options 可选参数，包含 lang 用于获取翻译版本
+   */
+  getPost(categoryName: string, slug: string, options?: {
+    lang?: string;
+    prefer?: 'lexical';
+  }): RequestProxyResult<ModelWithLiked<ModelWithTranslation<PostModel>>, ResponseWrapper>;
+  /**
+   * 根据 ID 查找文章
+   * @param id
+   */
+  getPost(id: string): RequestProxyResult<PostModel, ResponseWrapper>;
+  /**
+   * 获取最新的文章
+   */
+  getLatest(): RequestProxyResult<ModelWithLiked<PostModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: ModelWithLiked<PostModel>;
+  } : ResponseWrapper extends {
+    data: ModelWithLiked<PostModel>;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: ModelWithLiked<PostModel>;
+  }>;
+  getFullUrl(slug: string): RequestProxyResult<{
+    path: string;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      path: string;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      path: string;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      path: string;
+    };
+  }>;
+}
+//#endregion
+//#region controllers/project.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    project: ProjectController<ResponseWrapper>;
+  }
+}
+declare class ProjectController<ResponseWrapper> extends BaseCrudController<ProjectModel, ResponseWrapper> {
+  protected readonly client: HTTPClient;
+  constructor(client: HTTPClient);
+  base: string;
+  name: string;
+}
+//#endregion
+//#region controllers/recently.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    recently: RecentlyController<ResponseWrapper>;
+    shorthand: RecentlyController<ResponseWrapper>;
+  }
+}
+declare enum RecentlyAttitudeResultEnum {
+  Inc = 1,
+  Dec = -1
+}
+declare enum RecentlyAttitudeEnum {
+  Up = 0,
+  Down = 1
+}
+declare class RecentlyController<ResponseWrapper> implements IController {
+  private readonly client;
+  base: string;
+  name: string[];
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 获取最新一条
+   */
+  getLatestOne(): RequestProxyResult<RecentlyModel & {
+    comments: number;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: RecentlyModel & {
+      comments: number;
+    };
+  } : ResponseWrapper extends {
+    data: RecentlyModel & {
+      comments: number;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: RecentlyModel & {
+      comments: number;
+    };
+  }>;
+  getAll(): RequestProxyResult<{
+    data: RecentlyModel[] & {
+      comments: number;
+    };
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      data: RecentlyModel[] & {
+        comments: number;
+      };
+    };
+  } : ResponseWrapper extends {
+    data: {
+      data: RecentlyModel[] & {
+        comments: number;
+      };
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      data: RecentlyModel[] & {
+        comments: number;
+      };
+    };
+  }>;
+  getList({
+    before,
+    after,
+    size
+  }?: {
+    before?: string | undefined;
+    after?: string | undefined;
+    size?: number | number;
+  }): RequestProxyResult<{
+    data: RecentlyModel[] & {
+      comments: number;
+    };
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      data: RecentlyModel[] & {
+        comments: number;
+      };
+    };
+  } : ResponseWrapper extends {
+    data: {
+      data: RecentlyModel[] & {
+        comments: number;
+      };
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      data: RecentlyModel[] & {
+        comments: number;
+      };
+    };
+  }>;
+  getById(id: string): RequestProxyResult<RecentlyModel & {
+    comments: number;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: RecentlyModel & {
+      comments: number;
+    };
+  } : ResponseWrapper extends {
+    data: RecentlyModel & {
+      comments: number;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: RecentlyModel & {
+      comments: number;
+    };
+  }>;
+  /**  表态：点赞，点踩 */
+  attitude(id: string, attitude: RecentlyAttitudeEnum): RequestProxyResult<{
+    code: RecentlyAttitudeResultEnum;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      code: RecentlyAttitudeResultEnum;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      code: RecentlyAttitudeResultEnum;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      code: RecentlyAttitudeResultEnum;
+    };
+  }>;
+}
+//#endregion
+//#region controllers/say.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    say: SayController<ResponseWrapper>;
+  }
+}
+declare class SayController<ResponseWrapper> extends BaseCrudController<SayModel, ResponseWrapper> implements IController {
+  protected client: HTTPClient;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 获取随机一条
+   */
+  getRandom(): RequestProxyResult<{
+    data: SayModel | null;
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      data: SayModel | null;
+    };
+  } : ResponseWrapper extends {
+    data: {
+      data: SayModel | null;
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      data: SayModel | null;
+    };
+  }>;
+}
+//#endregion
+//#region controllers/search.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    search: SearchController<ResponseWrapper>;
+  }
+}
+type SearchOption = {
+  orderBy?: string;
+  order?: number;
+  rawAlgolia?: boolean;
+};
+declare class SearchController<ResponseWrapper> implements IController {
+  private readonly client;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  search(type: 'note', keyword: string, options?: Omit<SearchOption, 'rawAlgolia'>): Promise<RequestProxyResult<PaginateResult<Pick<NoteModel, 'modified' | 'id' | 'title' | 'created' | 'nid'>>, ResponseWrapper>>;
+  search(type: 'post', keyword: string, options?: Omit<SearchOption, 'rawAlgolia'>): Promise<RequestProxyResult<PaginateResult<Pick<PostModel, 'modified' | 'id' | 'title' | 'created' | 'slug' | 'category'>>, ResponseWrapper>>;
+  /**
+   * 从 algolya 搜索
+   * https://www.algolia.com/doc/api-reference/api-methods/search/
+   * @param keyword
+   * @param options
+   * @returns
+   */
+  searchByAlgolia(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
+    type: "post";
+  }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
+    type: "note";
+  }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
+    type: "page";
+  })> & {
+    /**
+     * @see: algoliasearch <https://www.algolia.com/doc/api-reference/api-methods/search/>
+     */
+    raw?: any;
+  }, ResponseWrapper>, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
+      type: "post";
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
+      type: "note";
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
+      type: "page";
+    })> & {
+      /**
+       * @see: algoliasearch <https://www.algolia.com/doc/api-reference/api-methods/search/>
+       */
+      raw?: any;
+    }, ResponseWrapper>;
+  } : ResponseWrapper extends {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
+      type: "post";
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
+      type: "note";
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
+      type: "page";
+    })> & {
+      /**
+       * @see: algoliasearch <https://www.algolia.com/doc/api-reference/api-methods/search/>
+       */
+      raw?: any;
+    }, ResponseWrapper>;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & {
+      type: "post";
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & {
+      type: "note";
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & {
+      type: "page";
+    })> & {
+      /**
+       * @see: algoliasearch <https://www.algolia.com/doc/api-reference/api-methods/search/>
+       */
+      raw?: any;
+    }, ResponseWrapper>;
+  }>;
+}
+//#endregion
+//#region controllers/severless.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    serverless: ServerlessController<ResponseWrapper>;
+  }
+}
+declare class ServerlessController<ResponseWrapper> implements IController {
+  protected client: HTTPClient;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  getByReferenceAndName<T = unknown>(reference: string, name: string): RequestProxyResult<T, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: T;
+  } : ResponseWrapper extends {
+    data: T;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: T;
+  }>;
+}
+//#endregion
+//#region controllers/snippet.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    snippet: SnippetController<ResponseWrapper>;
+  }
+}
+declare class SnippetController<ResponseWrapper> implements IController {
+  protected client: HTTPClient;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  getByReferenceAndName<T = unknown>(reference: string, name: string): RequestProxyResult<T, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: T;
+  } : ResponseWrapper extends {
+    data: T;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: T;
+  }>;
+}
+//#endregion
+//#region controllers/subscribe.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    subscribe: SubscribeController<ResponseWrapper>;
+  }
+}
+declare class SubscribeController<ResponseWrapper> implements IController {
+  protected client: HTTPClient;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  /**
+   * 检查开启状态
+   */
+  check(): RequestProxyResult<{
+    enable: boolean;
+    bitMap: Record<SubscribeType, number>;
+    allowBits: number[];
+    allowTypes: SubscribeType[];
+  }, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: {
+      enable: boolean;
+      bitMap: Record<SubscribeType, number>;
+      allowBits: number[];
+      allowTypes: SubscribeType[];
+    };
+  } : ResponseWrapper extends {
+    data: {
+      enable: boolean;
+      bitMap: Record<SubscribeType, number>;
+      allowBits: number[];
+      allowTypes: SubscribeType[];
+    };
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: {
+      enable: boolean;
+      bitMap: Record<SubscribeType, number>;
+      allowBits: number[];
+      allowTypes: SubscribeType[];
+    };
+  }>;
+  subscribe(email: string, types: SubscribeType[]): RequestProxyResult<never, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: never;
+  } : ResponseWrapper extends {
+    data: never;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: never;
+  }>;
+  unsubscribe(email: string, cancelToken: string): RequestProxyResult<string, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: string;
+  } : ResponseWrapper extends {
+    data: string;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: string;
+  }>;
+}
+//#endregion
+//#region controllers/topic.d.ts
+declare module '@mix-space-lts/api-client' {
+  interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+    topic: TopicController<ResponseWrapper>;
+  }
+}
+declare class TopicController<ResponseWrapper> extends BaseCrudController<TopicModel, ResponseWrapper> implements IController {
+  protected client: HTTPClient;
+  base: string;
+  name: string;
+  constructor(client: HTTPClient);
+  get proxy(): IRequestHandler<ResponseWrapper>;
+  getTopicBySlug(slug: string): RequestProxyResult<TopicModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+    [key: string]: any;
+    data: TopicModel;
+  } : ResponseWrapper extends {
+    data: TopicModel;
+  } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+    data: TopicModel;
+  }>;
+}
+//#endregion
+//#region controllers/index.d.ts
+declare const allControllers: (typeof AckController | typeof ActivityController | typeof AggregateController | typeof AIController | typeof CategoryController | typeof CommentController | typeof LinkController | typeof NoteController | typeof PageController | typeof PostController | typeof ProjectController | typeof RecentlyController | typeof SayController | typeof SearchController | typeof ServerlessController | typeof SnippetController | typeof SubscribeController | typeof TopicController | typeof UserController)[];
+declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate", "category", "comment", "link", "note", "page", "post", "project", "topic", "recently", "say", "search", "snippet", "serverless", "subscribe", "owner", "friend", "shorthand"];
+//#endregion
+//#region utils/camelcase-keys.d.ts
+/**
+ * A simple camelCase function that only handles strings, but not handling symbol, date, or other complex case.
+ * If you need to handle more complex cases, please use camelcase-keys package.
+ */
+declare const camelcaseKeys: <T = any>(obj: any) => T;
+//#endregion
+export { AIController, AIDeepReadingModel, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, AcademicMetadata, AckController, ActivityController, ActivityPresence, AdminExtraModel, AggregateAIConfig, AggregateController, AggregateRoot, AggregateRootWithTheme, AggregateStat, AggregateTop, AggregateTopNote, AggregateTopPost, AlgoliaSearchOptionsModel, AnonymousCommentDto, AuthUser, BackupOptionsModel, BaiduSearchOptionsModel, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, BookMetadata, CategoryController, CategoryEntries, 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, TagModel, TextBaseModel, TextBaseModelLexical, TextBaseModelMarkdown, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };