@mx-space/api-client 3.3.0 → 3.5.0

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

@@ -708,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 {
@@ -1277,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 & {
@@ -1524,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
@@ -1574,7 +1681,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 +1733,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 +2574,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 +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

@@ -708,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 {
@@ -1277,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 & {
@@ -1524,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
@@ -1574,7 +1681,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 +1733,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 +2574,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 +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.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.0",
   "description": "A api client for mx-space server@next",
   "type": "module",
   "engines": {