@mx-space/api-client 3.1.0 → 3.5.0

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DLzJOGbI.cjs";
+import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DB4Vji9d.cjs";
 
 //#region interfaces/controller.d.ts
 interface IController {
@@ -295,6 +295,10 @@ interface RecentComment {
   type: string;
   avatar: string;
   nid?: string;
+  category?: {
+    slug: string;
+    name: string;
+  };
 }
 interface RecentLike {
   created: string;
@@ -317,6 +321,10 @@ interface RecentPost {
   title: string;
   modified: string;
   slug: string;
+  category?: {
+    slug: string;
+    name: string;
+  };
 }
 interface RecentRecent {
   id: string;
@@ -700,6 +708,32 @@ type AITranslationStreamEvent = {
   type: 'error';
   data: string;
 };
+interface AIInsightsModel {
+  id: string;
+  created: string;
+  updated?: string;
+  hash: string;
+  refId: string;
+  lang: string;
+  content: string;
+  isTranslation: boolean;
+  sourceInsightsId?: string;
+  sourceLang?: string;
+  modelInfo?: {
+    provider: string;
+    model: string;
+  };
+}
+type AIInsightsStreamEvent = {
+  type: 'token';
+  data: string;
+} | {
+  type: 'done';
+  data: undefined;
+} | {
+  type: 'error';
+  data: string;
+};
 //#endregion
 //#region models/auth.d.ts
 interface AuthUser {
@@ -1269,7 +1303,7 @@ declare class AIController<ResponseWrapper> implements IController {
     $serialized: AISummaryModel;
   }>;
   /**
-   * Core >= 8.3.0
+   * @deprecated Feature removed from core; see ai-insights equivalent.
    * @param articleId
    */
   getDeepReading(articleId: string): Promise<AIDeepReadingModel & {
@@ -1516,6 +1550,87 @@ declare class AIController<ResponseWrapper> implements IController {
     articleId: string;
     lang: string;
   }, fetchOptions?: RequestInit): Promise<Response>;
+  /**
+   * Get cached AI insights for an article
+   * @support core >= 11.3.0
+   */
+  getInsights({
+    articleId,
+    lang,
+    onlyDb
+  }: {
+    articleId: string;
+    lang?: string;
+    onlyDb?: boolean;
+  }): Promise<AIInsightsModel & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AIInsightsModel | null;
+      } : ResponseWrapper extends {
+        data: AIInsightsModel | null;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AIInsightsModel | null;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AIInsightsModel | null;
+      } : ResponseWrapper extends {
+        data: AIInsightsModel | null;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AIInsightsModel | null;
+      }) ? T_1 extends unknown ? {
+        id: string;
+        created: string;
+        updated?: string | undefined;
+        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;
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: AIInsightsModel;
+  }>;
+  /**
+   * Get URL for streaming insights generation (SSE)
+   *
+   * @see AIInsightsStreamEvent for event types
+   * @support core >= 11.3.0
+   */
+  getInsightsGenerateUrl({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang?: string;
+  }): string;
+  /**
+   * Stream insights generation using fetch
+   *
+   * @see AIInsightsStreamEvent for event types
+   * @support core >= 11.3.0
+   */
+  streamInsightsGenerate({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang?: string;
+  }, fetchOptions?: RequestInit): Promise<Response>;
 }
 //#endregion
 //#region controllers/category.d.ts
@@ -1689,7 +1804,10 @@ declare class CommentController<ResponseWrapper> implements IController {
    * 获取文章的评论列表
    * @param refId 文章 Id
    */
-  getByRefId(refId: string, pagination?: PaginationParams): RequestProxyResult<PaginateResult<CommentThreadItem & {
+  getByRefId(refId: string, params?: PaginationParams & {
+    sort?: 'pinned' | 'newest' | 'oldest';
+    around?: string;
+  }): RequestProxyResult<PaginateResult<CommentThreadItem & {
     ref: string;
   }> & {
     readers: Record<string, ReaderModel>;
@@ -2628,4 +2746,4 @@ declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate"
  */
 declare const camelcaseKeys: <T = any>(obj: any) => T;
 //#endregion
-export { AIController, AIDeepReadingModel, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, 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, 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, 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, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, BookMetadata, 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, TagModel, TextBaseModel, TextBaseModelLexical, TextBaseModelMarkdown, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DLzJOGbI.cjs";
+import { n as IRequestAdapter, r as RequestOptions, t as IAdaptorRequestResponseType } from "./adapter-DB4Vji9d.cjs";
 
 //#region interfaces/controller.d.ts
 interface IController {
@@ -295,6 +295,10 @@ interface RecentComment {
   type: string;
   avatar: string;
   nid?: string;
+  category?: {
+    slug: string;
+    name: string;
+  };
 }
 interface RecentLike {
   created: string;
@@ -317,6 +321,10 @@ interface RecentPost {
   title: string;
   modified: string;
   slug: string;
+  category?: {
+    slug: string;
+    name: string;
+  };
 }
 interface RecentRecent {
   id: string;
@@ -700,6 +708,32 @@ type AITranslationStreamEvent = {
   type: 'error';
   data: string;
 };
+interface AIInsightsModel {
+  id: string;
+  created: string;
+  updated?: string;
+  hash: string;
+  refId: string;
+  lang: string;
+  content: string;
+  isTranslation: boolean;
+  sourceInsightsId?: string;
+  sourceLang?: string;
+  modelInfo?: {
+    provider: string;
+    model: string;
+  };
+}
+type AIInsightsStreamEvent = {
+  type: 'token';
+  data: string;
+} | {
+  type: 'done';
+  data: undefined;
+} | {
+  type: 'error';
+  data: string;
+};
 //#endregion
 //#region models/auth.d.ts
 interface AuthUser {
@@ -1269,7 +1303,7 @@ declare class AIController<ResponseWrapper> implements IController {
     $serialized: AISummaryModel;
   }>;
   /**
-   * Core >= 8.3.0
+   * @deprecated Feature removed from core; see ai-insights equivalent.
    * @param articleId
    */
   getDeepReading(articleId: string): Promise<AIDeepReadingModel & {
@@ -1516,6 +1550,87 @@ declare class AIController<ResponseWrapper> implements IController {
     articleId: string;
     lang: string;
   }, fetchOptions?: RequestInit): Promise<Response>;
+  /**
+   * Get cached AI insights for an article
+   * @support core >= 11.3.0
+   */
+  getInsights({
+    articleId,
+    lang,
+    onlyDb
+  }: {
+    articleId: string;
+    lang?: string;
+    onlyDb?: boolean;
+  }): Promise<AIInsightsModel & {
+    $raw: ResponseWrapper extends {
+      data: infer T;
+    } ? ResponseWrapper : ResponseWrapper extends unknown ? {
+      [i: string]: any;
+      data: (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AIInsightsModel | null;
+      } : ResponseWrapper extends {
+        data: AIInsightsModel | null;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AIInsightsModel | null;
+      }) extends infer T_1 ? T_1 extends (ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: AIInsightsModel | null;
+      } : ResponseWrapper extends {
+        data: AIInsightsModel | null;
+      } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: AIInsightsModel | null;
+      }) ? T_1 extends unknown ? {
+        id: string;
+        created: string;
+        updated?: string | undefined;
+        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;
+      } : T_1 : never : never;
+    } : ResponseWrapper;
+    $request: {
+      path: string;
+      method: string;
+      [k: string]: string;
+    };
+    $serialized: AIInsightsModel;
+  }>;
+  /**
+   * Get URL for streaming insights generation (SSE)
+   *
+   * @see AIInsightsStreamEvent for event types
+   * @support core >= 11.3.0
+   */
+  getInsightsGenerateUrl({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang?: string;
+  }): string;
+  /**
+   * Stream insights generation using fetch
+   *
+   * @see AIInsightsStreamEvent for event types
+   * @support core >= 11.3.0
+   */
+  streamInsightsGenerate({
+    articleId,
+    lang
+  }: {
+    articleId: string;
+    lang?: string;
+  }, fetchOptions?: RequestInit): Promise<Response>;
 }
 //#endregion
 //#region controllers/category.d.ts
@@ -1689,7 +1804,10 @@ declare class CommentController<ResponseWrapper> implements IController {
    * 获取文章的评论列表
    * @param refId 文章 Id
    */
-  getByRefId(refId: string, pagination?: PaginationParams): RequestProxyResult<PaginateResult<CommentThreadItem & {
+  getByRefId(refId: string, params?: PaginationParams & {
+    sort?: 'pinned' | 'newest' | 'oldest';
+    around?: string;
+  }): RequestProxyResult<PaginateResult<CommentThreadItem & {
     ref: string;
   }> & {
     readers: Record<string, ReaderModel>;
@@ -2628,4 +2746,4 @@ declare const allControllerNames: readonly ["ai", "ack", "activity", "aggregate"
  */
 declare const camelcaseKeys: <T = any>(obj: any) => T;
 //#endregion
-export { AIController, AIDeepReadingModel, AISummaryModel, AISummaryStreamEvent, AITranslationModel, AITranslationStreamEvent, 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, 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, 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, BaseCommentIndexModel, BaseModel, BetterAuthSession, BetterAuthSessionResult, BetterAuthSignInResult, BetterAuthUser, BetterAuthUserRole, BingSearchOptionsModel, BookMetadata, 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, TagModel, TextBaseModel, TextBaseModelLexical, TextBaseModelMarkdown, ThirdPartyServiceIntegrationModel, TimelineData, TimelineType, TopicController, TopicModel, TranslationMeta, Url, UrlOptionModel, UserController, UserModel, allControllerNames, allControllers, createClient, createClient as default, camelcaseKeys as simpleCamelcaseKeys };