@mx-space/api-client 1.3.3 → 1.3.5

package/dist/index.js

@@ -108,9 +108,15 @@ var AggregateController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 获取聚合数据
+   */
   getAggregateData() {
     return this.proxy.get();
   }
+  /**
+   * 获取最新发布的内容
+   */
   getTop(size = 5) {
     return this.proxy.top.get({ params: { size } });
   }
@@ -124,6 +130,9 @@ var AggregateController = class {
       }
     });
   }
+  /**
+   * 获取聚合数据统计
+   */
   getStat() {
     return this.proxy.stat.get();
   }
@@ -228,20 +237,33 @@ var CommentController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 根据 comment id 获取评论, 包括子评论
+   */
   getById(id) {
     return this.proxy(id).get();
   }
+  /**
+   * 获取文章的评论列表
+   * @param refId 文章 Id
+   */
   getByRefId(refId, pagination = {}) {
     const { page, size } = pagination;
     return this.proxy.ref(refId).get({
       params: { page: page || 1, size: size || 10 }
     });
   }
+  /**
+   * 评论
+   */
   comment(refId, data) {
     return this.proxy(refId).post({
       data
     });
   }
+  /**
+   * 回复评论
+   */
   reply(commentId, data) {
     return this.proxy.reply(commentId).post({
       data
@@ -264,6 +286,11 @@ var BaseCrudController = class {
   getAll() {
     return this.proxy.all.get();
   }
+  /**
+   * 带分页的查询
+   * @param page
+   * @param perPage
+   */
   getAllPaginated(page, perPage, sortOption) {
     return this.proxy.get({
       params: { page, size: perPage, ...sortOption }
@@ -280,10 +307,12 @@ var LinkController = class extends BaseCrudController {
     this.base = "links";
     autoBind(this);
   }
+  // 是否可以申请友链
   async canApplyLink() {
     const { can } = await this.proxy.audit.get();
     return can;
   }
+  // 申请友链
   async applyLink(data) {
     return await this.proxy.audit.post({ data });
   }
@@ -300,6 +329,9 @@ var NoteController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 最新日记
+   */
   getLatest() {
     return this.proxy.latest.get();
   }
@@ -313,6 +345,9 @@ var NoteController = class {
       return this.proxy(id).get();
     }
   }
+  /**
+   * 日记列表分页
+   */
   getList(page = 1, perPage = 10, options = {}) {
     const { select, sortBy, sortOrder, year } = options;
     return this.proxy.get({
@@ -326,14 +361,23 @@ var NoteController = class {
       }
     });
   }
+  /**
+   * 获取当前日记的上下各 n / 2 篇日记
+   */
   getMiddleList(id, size = 5) {
     return this.proxy.list(id).get({
       params: { size }
     });
   }
+  /**
+   * 喜欢这篇日记
+   */
   likeIt(id) {
     return this.proxy.like(id).get();
   }
+  /**
+   * 获取专栏内的所有日记
+   */
   getNoteByTopicId(topicId, page = 1, size = 10, sortOptions = {}) {
     return this.proxy.topics(topicId).get({
       params: { page, size, ...sortOptions }
@@ -352,6 +396,9 @@ var PageController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 页面列表
+   */
   getList(page = 1, perPage = 10, options = {}) {
     const { select, sortBy, sortOrder } = options;
     return this.proxy.get({
@@ -364,9 +411,17 @@ var PageController = class {
       }
     });
   }
+  /**
+   * 页面详情
+   */
   getById(id) {
     return this.proxy(id).get();
   }
+  /**
+   * 根据路径获取页面
+   * @param slug 路径
+   * @returns
+   */
   getBySlug(slug) {
     return this.proxy.slug(slug).get({});
   }
@@ -383,6 +438,12 @@ var PostController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 获取文章列表分页
+   * @param page
+   * @param perPage
+   * @returns
+   */
   getList(page = 1, perPage = 10, options = {}) {
     const { select, sortBy, sortOrder, year } = options;
     return this.proxy.get({
@@ -403,9 +464,15 @@ var PostController = class {
       return this.proxy(idOrCategoryName)(slug).get();
     }
   }
+  /**
+   * 获取最新的文章
+   */
   getLatest() {
     return this.proxy.latest.get();
   }
+  /**
+   * 点赞
+   */
   thumbsUp(id) {
     return this.proxy("_thumbs-up").get({ params: { id } });
   }
@@ -443,6 +510,9 @@ var RecentlyController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 获取最新一条
+   */
   getLatestOne() {
     return this.proxy.latest.get();
   }
@@ -458,6 +528,7 @@ var RecentlyController = class {
       }
     });
   }
+  /**  表态：点赞，点踩 */
   attitude(id, attitude) {
     return this.proxy.attitude(id).get({
       params: {
@@ -479,6 +550,9 @@ var SayController = class extends BaseCrudController {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 获取随机一条
+   */
   getRandom() {
     return this.proxy.random.get();
   }
@@ -500,6 +574,13 @@ var SearchController = class {
       params: { keyword, ...options }
     });
   }
+  /**
+   * 从 algolya 搜索
+   * https://www.algolia.com/doc/api-reference/api-methods/search/
+   * @param keyword
+   * @param options
+   * @returns
+   */
   searchByAlgolia(keyword, options) {
     return this.proxy("algolia").get({ params: { keyword, ...options } });
   }
@@ -532,6 +613,9 @@ var SnippetController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  // getById(id: string) {
+  //   return this.proxy(id).get<Omit<SnippetModel, 'data'>>()
+  // }
   getByReferenceAndName(reference, name) {
     return this.proxy(reference)(name).get();
   }
@@ -548,12 +632,15 @@ var SubscribeController = class {
   get proxy() {
     return this.client.proxy(this.base);
   }
+  /**
+   * 检查开启状态
+   */
   check() {
     return this.proxy.status.get();
   }
   subscribe(email, types) {
     return this.proxy.post({
-      params: {
+      data: {
         email,
         types
       }
@@ -660,6 +747,7 @@ var allContollerNames = [
   "serverless",
   "subscribe",
   "user",
+  // alias,
   "friend",
   "master",
   "shorthand"
@@ -845,6 +933,7 @@ var HTTPClient = class {
           route.push(name);
           return new Proxy(noop, handler);
         },
+        // @ts-ignore
         apply(target, _, args) {
           route.push(...args.filter((x) => x !== null));
           return new Proxy(noop, handler);

package/models/comment.ts

@@ -25,6 +25,7 @@ export interface CommentModel extends BaseModel {
   children: CommentModel[]
 
   isWhispers?: boolean
+  location?: string
 }
 export interface CommentRef {
   id: string

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/api-client",
-  "version": "1.3.3",
+  "version": "1.3.5",
   "type": "module",
   "description": "A api client for mx-space server@next",
   "author": "Innei",
@@ -59,19 +59,18 @@
   },
   "devDependencies": {
     "@types/cors": "2.8.13",
-    "@types/express": "4.17.16",
+    "@types/express": "4.17.17",
     "@types/lodash": "4.14.191",
     "abort-controller": "3.0.0",
     "axios": "^1.3.1",
     "camelcase-keys": "*",
     "cors": "2.8.5",
     "express": "4.18.2",
-    "isomorphic-unfetch": "3.1.0",
     "ky": "0.33.2",
     "lodash": "4.17.21",
     "node-fetch": "3.3.0",
     "tsc-alias": "1.8.2",
-    "tsup": "6.5.0",
+    "tsup": "6.6.3",
     "umi-request": "1.4.0"
   }
 }