@mx-space/api-client 3.3.0 → 3.5.1

package/LICENSE

@@ -0,0 +1,33 @@
+** Mix Space Open Source License**
+
+This project is dual-licensed under different terms for different parts of the project. It is important for users and contributors to understand the licensing terms applicable to each part of the project.
+
+### For the `apps/` Directory
+
+**License:** GNU Affero General Public License v3.0 (AGPLv3) with Additional Terms (ADDITIONAL_TERMS).
+
+**Scope:** This license applies exclusively to all files within the `apps/` directory of this project.
+
+**Summary:**
+- The AGPLv3 is a free, copyleft license suitable for software that will be distributed over a network. It allows users to use, modify, and distribute the software and any modifications under the same terms.
+- The "Additional Terms" (ADDITIONAL_TERMS) are specific conditions that are added to the AGPLv3 license. These terms must be reviewed in the accompanying LICENSE file or documentation to understand any additional restrictions or permissions that apply to the software.
+
+### For Other Parts of the Project
+
+**License:** MIT License.
+
+**Scope:** This license applies to all parts of the project that are not included within the `apps/` directory.
+
+**Summary:**
+- The MIT License is a permissive open-source license that allows users considerable freedom. It permits use, copying, modification, merging, publishing, distribution, sublicensing, and/or selling copies of the software.
+- It also protects the authors by including a limitation of liability and a disclaimer of warranty.
+
+**General Conditions:**
+- Redistribution and use in source and binary forms, with or without modification, are permitted provided that the above license notices and this permission notice appear in all copies of the software.
+- The software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement.
+
+**Contribution:**
+- Contributions to this project are accepted under the terms of the same license as the part of the project to which the contribution is made.
+
+**Notice:**
+- This summary is not the license itself and is not a substitute for reading the licenses in their entirety. All users and contributors are encouraged to read the full text of the licenses for a comprehensive understanding.

package/dist/index.cjs

@@ -256,7 +256,7 @@ var AIController = class {
 		});
 	}
 	/**
-	* Core >= 8.3.0
+	* @deprecated Feature removed from core; see ai-insights equivalent.
 	* @param articleId
 	*/
 	async getDeepReading(articleId) {
@@ -339,6 +339,48 @@ var AIController = class {
 			}
 		});
 	}
+	/**
+	* Get cached AI insights for an article
+	* @support core >= 11.3.0
+	*/
+	async getInsights({ articleId, lang = "zh", onlyDb }) {
+		return this.proxy.insights.article(articleId).get({ params: {
+			lang,
+			onlyDb
+		} });
+	}
+	/**
+	* Get URL for streaming insights generation (SSE)
+	*
+	* @see AIInsightsStreamEvent for event types
+	* @support core >= 11.3.0
+	*/
+	getInsightsGenerateUrl({ articleId, lang }) {
+		const baseUrl = this.client.endpoint;
+		const params = new URLSearchParams();
+		if (lang) params.set("lang", lang);
+		const query = params.toString();
+		return `${baseUrl}/${this.base}/insights/article/${articleId}/generate${query ? `?${query}` : ""}`;
+	}
+	/**
+	* Stream insights generation using fetch
+	*
+	* @see AIInsightsStreamEvent for event types
+	* @support core >= 11.3.0
+	*/
+	async streamInsightsGenerate({ articleId, lang }, fetchOptions) {
+		const url = this.getInsightsGenerateUrl({
+			articleId,
+			lang
+		});
+		return fetch(url, {
+			...fetchOptions,
+			headers: {
+				Accept: "text/event-stream",
+				...fetchOptions?.headers
+			}
+		});
+	}
 };
 //#endregion
 //#region core/error.ts

package/dist/index.d.cts

@@ -196,6 +196,13 @@ type ModelWithTranslation<T> = T & {
   isTranslated: boolean;
   translationMeta?: TranslationMeta;
   availableTranslations?: string[];
+  /**
+   * Whether AI insights are available in the caller's requested locale.
+   * Independent from `translationMeta` because insights maintain their own
+   * translation pipeline — the article may be translated without insights,
+   * and vice versa. Absent (undefined) on endpoints that don't surface it.
+   */
+  hasInsightsInLocale?: boolean;
 };
 //#endregion
 //#region models/post.d.ts
@@ -708,6 +715,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 {
@@ -1277,7 +1310,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 & {
@@ -1524,6 +1557,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
@@ -1574,7 +1688,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         name: string;
         created: string;
         id: string;
-        children: Pick<PostModel, "id" | "title" | "slug" | "modified" | "created">[];
+        children: Pick<PostModel, "id" | "created" | "title" | "slug" | "modified">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1626,7 +1740,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         };
       }) ? T_1 extends unknown ? {
         tag: string;
-        data: Pick<PostModel, "category" | "id" | "title" | "slug" | "created">[];
+        data: Pick<PostModel, "category" | "id" | "created" | "title" | "slug">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -2467,35 +2581,35 @@ declare class SearchController<ResponseWrapper> implements IController {
   search(type: 'note', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<NoteModel, 'modified' | 'id' | 'title' | 'created' | 'nid'> & SearchResultHighlight>, ResponseWrapper>>;
   search(type: 'post', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PostModel, 'modified' | 'id' | 'title' | 'created' | 'slug' | 'category'> & SearchResultHighlight>, ResponseWrapper>>;
   search(type: 'page', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PageModel, 'modified' | 'id' | 'title' | 'created' | 'slug'> & SearchResultHighlight>, ResponseWrapper>>;
-  searchAll(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+  searchAll(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
     type: "post";
-  }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+  }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
     type: "note";
-  }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+  }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
     type: "page";
   })>, ResponseWrapper>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   } : ResponseWrapper extends {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   }>;
@@ -2639,4 +2753,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

@@ -196,6 +196,13 @@ type ModelWithTranslation<T> = T & {
   isTranslated: boolean;
   translationMeta?: TranslationMeta;
   availableTranslations?: string[];
+  /**
+   * Whether AI insights are available in the caller's requested locale.
+   * Independent from `translationMeta` because insights maintain their own
+   * translation pipeline — the article may be translated without insights,
+   * and vice versa. Absent (undefined) on endpoints that don't surface it.
+   */
+  hasInsightsInLocale?: boolean;
 };
 //#endregion
 //#region models/post.d.ts
@@ -708,6 +715,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 {
@@ -1277,7 +1310,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 & {
@@ -1524,6 +1557,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
@@ -1574,7 +1688,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         name: string;
         created: string;
         id: string;
-        children: Pick<PostModel, "id" | "title" | "slug" | "modified" | "created">[];
+        children: Pick<PostModel, "id" | "created" | "title" | "slug" | "modified">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -1626,7 +1740,7 @@ declare class CategoryController<ResponseWrapper> implements IController {
         };
       }) ? T_1 extends unknown ? {
         tag: string;
-        data: Pick<PostModel, "category" | "id" | "title" | "slug" | "created">[];
+        data: Pick<PostModel, "category" | "id" | "created" | "title" | "slug">[];
       } : T_1 : never : never;
     } : ResponseWrapper;
     $request: {
@@ -2467,35 +2581,35 @@ declare class SearchController<ResponseWrapper> implements IController {
   search(type: 'note', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<NoteModel, 'modified' | 'id' | 'title' | 'created' | 'nid'> & SearchResultHighlight>, ResponseWrapper>>;
   search(type: 'post', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PostModel, 'modified' | 'id' | 'title' | 'created' | 'slug' | 'category'> & SearchResultHighlight>, ResponseWrapper>>;
   search(type: 'page', keyword: string, options?: SearchOption): Promise<RequestProxyResult<PaginateResult<Pick<PageModel, 'modified' | 'id' | 'title' | 'created' | 'slug'> & SearchResultHighlight>, ResponseWrapper>>;
-  searchAll(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+  searchAll(keyword: string, options?: SearchOption): RequestProxyResult<RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
     type: "post";
-  }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+  }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
     type: "note";
-  }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+  }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
     type: "page";
   })>, ResponseWrapper>, ResponseWrapper, ResponseWrapper extends unknown ? {
     [key: string]: any;
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   } : ResponseWrapper extends {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
-    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    data: RequestProxyResult<PaginateResult<(Pick<PostModel, "category" | "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "post";
-    }) | (Pick<NoteModel, "id" | "title" | "modified" | "created" | "nid"> & SearchResultHighlight & {
+    }) | (Pick<NoteModel, "id" | "created" | "title" | "modified" | "nid"> & SearchResultHighlight & {
       type: "note";
-    }) | (Pick<PageModel, "id" | "title" | "slug" | "modified" | "created"> & SearchResultHighlight & {
+    }) | (Pick<PageModel, "id" | "created" | "title" | "slug" | "modified"> & SearchResultHighlight & {
       type: "page";
     })>, ResponseWrapper>;
   }>;
@@ -2639,4 +2753,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.mjs

@@ -252,7 +252,7 @@ var AIController = class {
 		});
 	}
 	/**
-	* Core >= 8.3.0
+	* @deprecated Feature removed from core; see ai-insights equivalent.
 	* @param articleId
 	*/
 	async getDeepReading(articleId) {
@@ -335,6 +335,48 @@ var AIController = class {
 			}
 		});
 	}
+	/**
+	* Get cached AI insights for an article
+	* @support core >= 11.3.0
+	*/
+	async getInsights({ articleId, lang = "zh", onlyDb }) {
+		return this.proxy.insights.article(articleId).get({ params: {
+			lang,
+			onlyDb
+		} });
+	}
+	/**
+	* Get URL for streaming insights generation (SSE)
+	*
+	* @see AIInsightsStreamEvent for event types
+	* @support core >= 11.3.0
+	*/
+	getInsightsGenerateUrl({ articleId, lang }) {
+		const baseUrl = this.client.endpoint;
+		const params = new URLSearchParams();
+		if (lang) params.set("lang", lang);
+		const query = params.toString();
+		return `${baseUrl}/${this.base}/insights/article/${articleId}/generate${query ? `?${query}` : ""}`;
+	}
+	/**
+	* Stream insights generation using fetch
+	*
+	* @see AIInsightsStreamEvent for event types
+	* @support core >= 11.3.0
+	*/
+	async streamInsightsGenerate({ articleId, lang }, fetchOptions) {
+		const url = this.getInsightsGenerateUrl({
+			articleId,
+			lang
+		});
+		return fetch(url, {
+			...fetchOptions,
+			headers: {
+				Accept: "text/event-stream",
+				...fetchOptions?.headers
+			}
+		});
+	}
 };
 //#endregion
 //#region core/error.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/api-client",
-  "version": "3.3.0",
+  "version": "3.5.1",
   "description": "A api client for mx-space server@next",
   "type": "module",
   "engines": {
@@ -42,13 +42,6 @@
     "tag": false,
     "commit_message": "chore(release): bump @mx-space/api-client to v${NEW_VERSION}"
   },
-  "scripts": {
-    "package": "rm -rf dist && tsdown",
-    "build": "npm run package",
-    "prepackage": "rm -rf dist",
-    "test": "vitest",
-    "dev": "vitest"
-  },
   "devDependencies": {
     "@types/cors": "2.8.19",
     "@types/express": "5.0.6",
@@ -63,5 +56,12 @@
     "umi-request": "1.4.0",
     "vite": "^8.0.8",
     "vitest": "4.1.4"
+  },
+  "scripts": {
+    "package": "rm -rf dist && tsdown",
+    "build": "npm run package",
+    "prepackage": "rm -rf dist",
+    "test": "vitest",
+    "dev": "vitest"
   }
-}
+}