@mx-space/api-client 1.0.0 → 1.0.2

package/lib/controllers/category.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryController = void 0;
+const utils_1 = require("../utils");
+const auto_bind_1 = require("../utils/auto-bind");
+const error_1 = require("../core/error");
+const category_1 = require("../models/category");
+class CategoryController {
+    constructor(client) {
+        this.client = client;
+        this.name = 'category';
+        this.base = 'categories';
+        (0, auto_bind_1.autoBind)(this);
+    }
+    get proxy() {
+        return this.client.proxy(this.base);
+    }
+    getAllCategories() {
+        return this.proxy.get({
+            params: {
+                type: category_1.CategoryType.Category,
+            },
+        });
+    }
+    getAllTags() {
+        return this.proxy.get({
+            params: {
+                type: category_1.CategoryType.Tag,
+            },
+        });
+    }
+    async getCategoryDetail(ids) {
+        if (typeof ids === 'string') {
+            const data = await this.proxy.get({
+                params: {
+                    ids,
+                },
+            });
+            const result = Object.values(data.entries)[0];
+            (0, utils_1.attachRawFromOneToAnthor)(data, result);
+            return result;
+        }
+        else if (Array.isArray(ids)) {
+            const data = await this.proxy.get({
+                params: {
+                    ids: ids.join(','),
+                },
+            });
+            const entries = data?.entries;
+            if (!entries) {
+                throw new error_1.RequestError('data structure error', 500, data.$request.path, data);
+            }
+            const map = new Map(Object.entries(entries).map(([id, value]) => [id.toLowerCase(), value]));
+            (0, utils_1.attachRawFromOneToAnthor)(data, map);
+            return map;
+        }
+    }
+    async getCategoryByIdOrSlug(idOrSlug) {
+        const res = await this.proxy(idOrSlug).get();
+        return (0, utils_1.destructureData)(res);
+    }
+    async getTagByName(name) {
+        const res = await this.proxy(name).get({
+            params: {
+                tag: 1,
+            },
+        });
+        return res;
+    }
+}
+exports.CategoryController = CategoryController;
+//# sourceMappingURL=category.js.map

package/lib/controllers/category.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.js","sourceRoot":"","sources":["../../controllers/category.ts"],"names":[],"mappings":";;;AAOA,mCAAmE;AACnE,iDAA4C;AAG5C,yCAA4C;AAC5C,iDAM2B;AAY3B,MAAa,kBAAkB;IAG7B,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAFtC,SAAI,GAAG,UAAU,CAAA;QACjB,SAAI,GAAG,YAAY,CAAA;QAEjB,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IAED,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED,gBAAgB;QAId,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;YACpB,MAAM,EAAE;gBACN,IAAI,EAAE,uBAAY,CAAC,QAAQ;aAC5B;SACF,CAAC,CAAA;IACJ,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB;YAC1C,MAAM,EAAE;gBACN,IAAI,EAAE,uBAAY,CAAC,GAAG;aACvB;SACF,CAAC,CAAA;IACJ,CAAC;IAQD,KAAK,CAAC,iBAAiB,CAAC,GAAsB;QAC5C,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE;YAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB;gBACjD,MAAM,EAAE;oBACN,GAAG;iBACJ;aACF,CAAC,CAAA;YACF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;YAC7C,IAAA,gCAAwB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YACtC,OAAO,MAAM,CAAA;SACd;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB;gBACjD,MAAM,EAAE;oBACN,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;iBACnB;aACF,CAAC,CAAA;YACF,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,CAAA;YAC7B,IAAI,CAAC,OAAO,EAAE;gBACZ,MAAM,IAAI,oBAAY,CACpB,sBAAsB,EACtB,GAAG,EACH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAClB,IAAI,CACL,CAAA;aACF;YAED,MAAM,GAAG,GAAG,IAAI,GAAG,CACjB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC,CACxE,CAAA;YAED,IAAA,gCAAwB,EAAC,IAAI,EAAE,GAAG,CAAC,CAAA;YACnC,OAAO,GAAG,CAAA;SACX;IACH,CAAC;IAED,KAAK,CAAC,qBAAqB,CAAC,QAAgB;QAC1C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,EAA6B,CAAA;QACvE,OAAO,IAAA,uBAAe,EAAC,GAAG,CAAe,CAAA;IAC3C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAGnC;YACD,MAAM,EAAE;gBACN,GAAG,EAAE,CAAC;aACP;SACF,CAAC,CAAA;QAEF,OAAO,GAAG,CAAA;IACZ,CAAC;CACF;AAxFD,gDAwFC"}

package/lib/controllers/comment.d.ts

@@ -0,0 +1,81 @@
+import { IRequestAdapter } from '../interfaces/adapter';
+import { IController } from '../interfaces/controller';
+import { PaginationParams } from '../interfaces/params';
+import { IRequestHandler } from '../interfaces/request';
+import { PaginateResult } from '../models/base';
+import { CommentModel } from '../models/comment';
+import { HTTPClient } from '../core';
+import { CommentDto } from '../dtos/comment';
+declare module '../core/client' {
+    interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+        comment: CommentController<ResponseWrapper>;
+    }
+}
+export declare class CommentController<ResponseWrapper> implements IController {
+    private readonly client;
+    base: string;
+    name: string;
+    constructor(client: HTTPClient);
+    get proxy(): IRequestHandler<ResponseWrapper>;
+    /**
+     * 根据 comment id 获取评论, 包括子评论
+     */
+    getById(id: string): import("../interfaces/request").RequestProxyResult<CommentModel & {
+        ref: string;
+    }, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: CommentModel & {
+            ref: string;
+        };
+    } : ResponseWrapper extends {
+        data: CommentModel & {
+            ref: string;
+        };
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: CommentModel & {
+            ref: string;
+        };
+    }>;
+    /**
+     * 获取文章的评论列表
+     * @param refId 文章 Id
+     */
+    getByRefId(refId: string, pagination?: PaginationParams): import("../interfaces/request").RequestProxyResult<PaginateResult<CommentModel & {
+        ref: string;
+    }>, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: PaginateResult<CommentModel & {
+            ref: string;
+        }>;
+    } : ResponseWrapper extends {
+        data: PaginateResult<CommentModel & {
+            ref: string;
+        }>;
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: PaginateResult<CommentModel & {
+            ref: string;
+        }>;
+    }>;
+    /**
+     * 评论
+     */
+    comment(refId: string, data: CommentDto): import("../interfaces/request").RequestProxyResult<CommentModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: CommentModel;
+    } : ResponseWrapper extends {
+        data: CommentModel;
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: CommentModel;
+    }>;
+    /**
+     * 回复评论
+     */
+    reply(commentId: string, data: CommentDto): import("../interfaces/request").RequestProxyResult<CommentModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: CommentModel;
+    } : ResponseWrapper extends {
+        data: CommentModel;
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: CommentModel;
+    }>;
+}

package/lib/controllers/comment.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommentController = void 0;
+const auto_bind_1 = require("../utils/auto-bind");
+class CommentController {
+    constructor(client) {
+        this.client = client;
+        this.base = 'comments';
+        this.name = 'comment';
+        (0, auto_bind_1.autoBind)(this);
+    }
+    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,
+        });
+    }
+}
+exports.CommentController = CommentController;
+//# sourceMappingURL=comment.js.map

package/lib/controllers/comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment.js","sourceRoot":"","sources":["../../controllers/comment.ts"],"names":[],"mappings":";;;AAMA,iDAA4C;AAc5C,MAAa,iBAAiB;IAI5B,YAA6B,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAH/C,SAAI,GAAG,UAAU,CAAA;QACjB,SAAI,GAAG,SAAS,CAAA;QAGd,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAkC,CAAA;IAC7D,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,KAAa,EAAE,aAA+B,EAAE;QACzD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,UAAU,CAAA;QACjC,OAAO,IAAI,CAAC,KAAK;aACd,GAAG,CAAC,KAAK,CAAC;aACV,GAAG,CAAiD;YACnD,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE;SAC9C,CAAC,CAAA;IACN,CAAC;IACD;;OAEG;IACH,OAAO,CAAC,KAAa,EAAE,IAAgB;QACrC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAe;YAC1C,IAAI;SACL,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAiB,EAAE,IAAgB;QACvC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAe;YACpD,IAAI;SACL,CAAC,CAAA;IACJ,CAAC;CACF;AAhDD,8CAgDC"}

package/lib/controllers/index.d.ts

@@ -0,0 +1,18 @@
+import { AggregateController } from './aggregate';
+import { CategoryController } from './category';
+import { CommentController } from './comment';
+import { LinkController } from './link';
+import { NoteController } from './note';
+import { PageController } from './page';
+import { PostController } from './post';
+import { ProjectController } from './project';
+import { RecentlyController } from './recently';
+import { SayController } from './say';
+import { SearchController } from './search';
+import { ServerlessController } from './severless';
+import { SnippetController } from './snippet';
+import { TopicController } from './topic';
+import { UserController } from './user';
+export declare const allControllers: (typeof AggregateController | typeof CategoryController | typeof CommentController | typeof LinkController | typeof NoteController | typeof PageController | typeof PostController | typeof ProjectController | typeof RecentlyController | typeof SayController | typeof SearchController | typeof ServerlessController | typeof SnippetController | typeof TopicController | typeof UserController)[];
+export declare const allContollerNames: readonly ["aggregate", "category", "comment", "link", "note", "page", "post", "project", "topic", "recently", "say", "search", "snippet", "serverless", "user", "friend", "master", "shorthand"];
+export { AggregateController, CategoryController, CommentController, LinkController, NoteController, PageController, PostController, ProjectController, RecentlyController, SayController, SearchController, SnippetController, ServerlessController, UserController, TopicController, };

package/lib/controllers/index.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TopicController = exports.UserController = exports.ServerlessController = exports.SnippetController = exports.SearchController = exports.SayController = exports.RecentlyController = exports.ProjectController = exports.PostController = exports.PageController = exports.NoteController = exports.LinkController = exports.CommentController = exports.CategoryController = exports.AggregateController = exports.allContollerNames = exports.allControllers = void 0;
+const aggregate_1 = require("./aggregate");
+Object.defineProperty(exports, "AggregateController", { enumerable: true, get: function () { return aggregate_1.AggregateController; } });
+const category_1 = require("./category");
+Object.defineProperty(exports, "CategoryController", { enumerable: true, get: function () { return category_1.CategoryController; } });
+const comment_1 = require("./comment");
+Object.defineProperty(exports, "CommentController", { enumerable: true, get: function () { return comment_1.CommentController; } });
+const link_1 = require("./link");
+Object.defineProperty(exports, "LinkController", { enumerable: true, get: function () { return link_1.LinkController; } });
+const note_1 = require("./note");
+Object.defineProperty(exports, "NoteController", { enumerable: true, get: function () { return note_1.NoteController; } });
+const page_1 = require("./page");
+Object.defineProperty(exports, "PageController", { enumerable: true, get: function () { return page_1.PageController; } });
+const post_1 = require("./post");
+Object.defineProperty(exports, "PostController", { enumerable: true, get: function () { return post_1.PostController; } });
+const project_1 = require("./project");
+Object.defineProperty(exports, "ProjectController", { enumerable: true, get: function () { return project_1.ProjectController; } });
+const recently_1 = require("./recently");
+Object.defineProperty(exports, "RecentlyController", { enumerable: true, get: function () { return recently_1.RecentlyController; } });
+const say_1 = require("./say");
+Object.defineProperty(exports, "SayController", { enumerable: true, get: function () { return say_1.SayController; } });
+const search_1 = require("./search");
+Object.defineProperty(exports, "SearchController", { enumerable: true, get: function () { return search_1.SearchController; } });
+const severless_1 = require("./severless");
+Object.defineProperty(exports, "ServerlessController", { enumerable: true, get: function () { return severless_1.ServerlessController; } });
+const snippet_1 = require("./snippet");
+Object.defineProperty(exports, "SnippetController", { enumerable: true, get: function () { return snippet_1.SnippetController; } });
+const topic_1 = require("./topic");
+Object.defineProperty(exports, "TopicController", { enumerable: true, get: function () { return topic_1.TopicController; } });
+const user_1 = require("./user");
+Object.defineProperty(exports, "UserController", { enumerable: true, get: function () { return user_1.UserController; } });
+exports.allControllers = [
+    aggregate_1.AggregateController,
+    category_1.CategoryController,
+    comment_1.CommentController,
+    link_1.LinkController,
+    note_1.NoteController,
+    page_1.PageController,
+    post_1.PostController,
+    project_1.ProjectController,
+    recently_1.RecentlyController,
+    topic_1.TopicController,
+    say_1.SayController,
+    search_1.SearchController,
+    snippet_1.SnippetController,
+    severless_1.ServerlessController,
+    user_1.UserController,
+];
+exports.allContollerNames = [
+    'aggregate',
+    'category',
+    'comment',
+    'link',
+    'note',
+    'page',
+    'post',
+    'project',
+    'topic',
+    'recently',
+    'say',
+    'search',
+    'snippet',
+    'serverless',
+    'user',
+    // alias,
+    'friend',
+    'master',
+    'shorthand',
+];
+//# sourceMappingURL=index.js.map

package/lib/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../controllers/index.ts"],"names":[],"mappings":";;;AAAA,2CAAiD;AA0D/C,oGA1DO,+BAAmB,OA0DP;AAzDrB,yCAA+C;AA0D7C,mGA1DO,6BAAkB,OA0DP;AAzDpB,uCAA6C;AA0D3C,kGA1DO,2BAAiB,OA0DP;AAzDnB,iCAAuC;AA0DrC,+FA1DO,qBAAc,OA0DP;AAzDhB,iCAAuC;AA0DrC,+FA1DO,qBAAc,OA0DP;AAzDhB,iCAAuC;AA0DrC,+FA1DO,qBAAc,OA0DP;AAzDhB,iCAAuC;AA0DrC,+FA1DO,qBAAc,OA0DP;AAzDhB,uCAA6C;AA0D3C,kGA1DO,2BAAiB,OA0DP;AAzDnB,yCAA+C;AA0D7C,mGA1DO,6BAAkB,OA0DP;AAzDpB,+BAAqC;AA0DnC,8FA1DO,mBAAa,OA0DP;AAzDf,qCAA2C;AA0DzC,iGA1DO,yBAAgB,OA0DP;AAzDlB,2CAAkD;AA2DhD,qGA3DO,gCAAoB,OA2DP;AA1DtB,uCAA6C;AAyD3C,kGAzDO,2BAAiB,OAyDP;AAxDnB,mCAAyC;AA2DvC,gGA3DO,uBAAe,OA2DP;AA1DjB,iCAAuC;AAyDrC,+FAzDO,qBAAc,OAyDP;AAvDH,QAAA,cAAc,GAAG;IAC5B,+BAAmB;IACnB,6BAAkB;IAClB,2BAAiB;IACjB,qBAAc;IACd,qBAAc;IACd,qBAAc;IACd,qBAAc;IACd,2BAAiB;IACjB,6BAAkB;IAClB,uBAAe;IACf,mBAAa;IACb,yBAAgB;IAChB,2BAAiB;IACjB,gCAAoB;IACpB,qBAAc;CACf,CAAA;AAEY,QAAA,iBAAiB,GAAG;IAC/B,WAAW;IACX,UAAU;IACV,SAAS;IACT,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;IACP,UAAU;IACV,KAAK;IACL,QAAQ;IACR,SAAS;IACT,YAAY;IACZ,MAAM;IAEN,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,WAAW;CACH,CAAA"}

package/lib/controllers/link.d.ts

@@ -0,0 +1,20 @@
+import { IRequestAdapter } from '../interfaces/adapter';
+import { LinkModel } from '../models/link';
+import { HTTPClient } from '../core';
+import { BaseCrudController } from './base';
+declare module '../core/client' {
+    interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+        link: LinkController<ResponseWrapper>;
+        friend: LinkController<ResponseWrapper>;
+    }
+}
+export declare class LinkController<ResponseWrapper> extends BaseCrudController<LinkModel, ResponseWrapper> {
+    protected readonly client: HTTPClient;
+    constructor(client: HTTPClient);
+    canApplyLink(): Promise<boolean>;
+    applyLink(data: Pick<LinkModel, 'avatar' | 'name' | 'description' | 'url' | 'email'> & {
+        author: string;
+    }): Promise<never>;
+    name: string[];
+    base: string;
+}

package/lib/controllers/link.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinkController = void 0;
+const auto_bind_1 = require("../utils/auto-bind");
+const base_1 = require("./base");
+class LinkController extends base_1.BaseCrudController {
+    constructor(client) {
+        super(client);
+        this.client = client;
+        this.name = ['link', 'friend'];
+        this.base = 'links';
+        (0, auto_bind_1.autoBind)(this);
+    }
+    // 是否可以申请友链
+    async canApplyLink() {
+        const { can } = await this.proxy.audit.get();
+        return can;
+    }
+    // 申请友链
+    async applyLink(data) {
+        return await this.proxy.audit.post({ data });
+    }
+}
+exports.LinkController = LinkController;
+//# sourceMappingURL=link.js.map

package/lib/controllers/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../controllers/link.ts"],"names":[],"mappings":";;;AAEA,iDAA4C;AAG5C,iCAA2C;AAY3C,MAAa,cAAgC,SAAQ,yBAGpD;IACC,YAA+B,MAAkB;QAC/C,KAAK,CAAC,MAAM,CAAC,CAAA;QADgB,WAAM,GAAN,MAAM,CAAY;QAuBjD,SAAI,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACzB,SAAI,GAAG,OAAO,CAAA;QAtBZ,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IAED,WAAW;IACX,KAAK,CAAC,YAAY;QAChB,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAoB,CAAA;QAC9D,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,OAAO;IACP,KAAK,CAAC,SAAS,CACb,IAKC;QAED,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC;CAIF;AA7BD,wCA6BC"}

package/lib/controllers/note.d.ts

@@ -0,0 +1,123 @@
+import { IRequestAdapter } from '../interfaces/adapter';
+import { IController } from '../interfaces/controller';
+import { IRequestHandler, RequestProxyResult } from '../interfaces/request';
+import { SelectFields } from '../interfaces/types';
+import { PaginateResult } from '../models/base';
+import { NoteModel, NoteWrappedPayload, NoteWrappedWithLikedPayload } from '../models/note';
+import { HTTPClient } from '../core/client';
+import { SortOptions } from './base';
+declare module '../core/client' {
+    interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+        note: NoteController<ResponseWrapper>;
+    }
+}
+export type NoteListOptions = {
+    select?: SelectFields<keyof NoteModel>;
+    year?: number;
+    sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified';
+    sortOrder?: 1 | -1;
+};
+export declare class NoteController<ResponseWrapper> implements IController {
+    private client;
+    base: string;
+    name: string;
+    constructor(client: HTTPClient);
+    get proxy(): IRequestHandler<ResponseWrapper>;
+    /**
+     * 最新日记
+     */
+    getLatest(): RequestProxyResult<NoteWrappedWithLikedPayload, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: NoteWrappedWithLikedPayload;
+    } : ResponseWrapper extends {
+        data: NoteWrappedWithLikedPayload; /**
+         * 获取一篇日记，根据 Id 查询需要鉴权
+         * @param id id | nid
+         * @param password 访问密码
+         */
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: NoteWrappedWithLikedPayload;
+    }>;
+    /**
+     * 获取一篇日记，根据 Id 查询需要鉴权
+     * @param id id | nid
+     * @param password 访问密码
+     */
+    getNoteById(id: string): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
+    getNoteById(id: number): Promise<NoteWrappedPayload>;
+    getNoteById(id: number, password: string): Promise<NoteWrappedPayload>;
+    getNoteById(id: number, password: undefined, singleResult: true): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
+    getNoteById(id: number, password: string, singleResult: true): Promise<RequestProxyResult<NoteModel, ResponseWrapper>>;
+    /**
+     * 日记列表分页
+     */
+    getList(page?: number, perPage?: number, options?: NoteListOptions): RequestProxyResult<PaginateResult<NoteModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: PaginateResult<NoteModel>;
+    } : ResponseWrapper extends {
+        data: PaginateResult<NoteModel>; /**
+         * 获取一篇日记，根据 Id 查询需要鉴权
+         * @param id id | nid
+         * @param password 访问密码
+         */
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: PaginateResult<NoteModel>;
+    }>;
+    /**
+     * 获取当前日记的上下各 n / 2 篇日记
+     */
+    getMiddleList(id: string, size?: number): RequestProxyResult<{
+        data: Pick<NoteModel, 'id' | 'title' | 'nid' | 'created'>[];
+        size: number;
+    }, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: {
+            data: Pick<NoteModel, 'id' | 'title' | 'nid' | 'created'>[];
+            size: number;
+        };
+    } : ResponseWrapper extends {
+        data: {
+            data: Pick<NoteModel, 'id' | 'title' | 'nid' | 'created'>[];
+            size: number;
+        }; /**
+         * 获取一篇日记，根据 Id 查询需要鉴权
+         * @param id id | nid
+         * @param password 访问密码
+         */
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: {
+            data: Pick<NoteModel, 'id' | 'title' | 'nid' | 'created'>[];
+            size: number;
+        };
+    }>;
+    /**
+     * 喜欢这篇日记
+     */
+    likeIt(id: string | number): RequestProxyResult<never, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: never;
+    } : ResponseWrapper extends {
+        data: never; /**
+         * 获取一篇日记，根据 Id 查询需要鉴权
+         * @param id id | nid
+         * @param password 访问密码
+         */
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: never;
+    }>;
+    /**
+     * 获取专栏内的所有日记
+     */
+    getNoteByTopicId(topicId: string, page?: number, size?: number, sortOptions?: SortOptions): RequestProxyResult<PaginateResult<NoteModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: PaginateResult<NoteModel>;
+    } : ResponseWrapper extends {
+        data: PaginateResult<NoteModel>; /**
+         * 获取一篇日记，根据 Id 查询需要鉴权
+         * @param id id | nid
+         * @param password 访问密码
+         */
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: PaginateResult<NoteModel>;
+    }>;
+}

package/lib/controllers/note.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoteController = void 0;
+const auto_bind_1 = require("../utils/auto-bind");
+class NoteController {
+    constructor(client) {
+        this.client = client;
+        this.base = 'notes';
+        this.name = 'note';
+        (0, auto_bind_1.autoBind)(this);
+    }
+    get proxy() {
+        return this.client.proxy(this.base);
+    }
+    /**
+     * 最新日记
+     */
+    getLatest() {
+        return this.proxy.latest.get();
+    }
+    getNoteById(...rest) {
+        const [id, password = undefined, singleResult = false] = rest;
+        if (typeof id === 'number') {
+            return this.proxy.nid(id.toString()).get({
+                params: { password, single: singleResult ? '1' : undefined },
+            });
+        }
+        else {
+            return this.proxy(id).get();
+        }
+    }
+    /**
+     * 日记列表分页
+     */
+    getList(page = 1, perPage = 10, options = {}) {
+        const { select, sortBy, sortOrder, year } = options;
+        return this.proxy.get({
+            params: {
+                page,
+                size: perPage,
+                select: select?.join(' '),
+                sortBy,
+                sortOrder,
+                year,
+            },
+        });
+    }
+    /**
+     * 获取当前日记的上下各 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 },
+        });
+    }
+}
+exports.NoteController = NoteController;
+//# sourceMappingURL=note.js.map

package/lib/controllers/note.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"note.js","sourceRoot":"","sources":["../../controllers/note.ts"],"names":[],"mappings":";;;AAUA,iDAA4C;AAqB5C,MAAa,cAAc;IAIzB,YAAoB,MAAkB;QAAlB,WAAM,GAAN,MAAM,CAAY;QAHtC,SAAI,GAAG,OAAO,CAAA;QACd,SAAI,GAAG,MAAM,CAAA;QAGX,IAAA,oBAAQ,EAAC,IAAI,CAAC,CAAA;IAChB,CAAC;IACD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,EAA+B,CAAA;IAC7D,CAAC;IAuBD,WAAW,CAAC,GAAG,IAAW;QACxB,MAAM,CAAC,EAAE,EAAE,QAAQ,GAAG,SAAS,EAAE,YAAY,GAAG,KAAK,CAAC,GAAG,IAAI,CAAA;QAE7D,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE;YAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAA8B;gBACpE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE;aAC7D,CAAC,CAAA;SACH;aAAM;YACL,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,EAAa,CAAA;SACvC;IACH,CAAC;IAED;;OAEG;IAEH,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,OAAO,GAAG,EAAE,EAAE,UAA2B,EAAE;QAC3D,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAA;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B;YAC/C,MAAM,EAAE;gBACN,IAAI;gBACJ,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC;gBACzB,MAAM;gBACN,SAAS;gBACT,IAAI;aACL;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,EAAU,EAAE,IAAI,GAAG,CAAC;QAChC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,CAG3B;YACD,MAAM,EAAE,EAAE,IAAI,EAAE;SACjB,CAAC,CAAA;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAmB;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,EAAS,CAAA;IACzC,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,OAAe,EACf,IAAI,GAAG,CAAC,EACR,IAAI,GAAG,EAAE,EACT,cAA2B,EAAE;QAE7B,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAA4B;YAC/D,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE;SACvC,CAAC,CAAA;IACJ,CAAC;CACF;AArGD,wCAqGC"}

package/lib/controllers/page.d.ts

@@ -0,0 +1,59 @@
+import { IRequestAdapter } from '../interfaces/adapter';
+import { IController } from '../interfaces/controller';
+import { IRequestHandler } from '../interfaces/request';
+import { SelectFields } from '../interfaces/types';
+import { PaginateResult } from '../models/base';
+import { PageModel } from '../models/page';
+import { HTTPClient } from '../core';
+declare module '../core/client' {
+    interface HTTPClient<T extends IRequestAdapter = IRequestAdapter, ResponseWrapper = unknown> {
+        page: PageController<ResponseWrapper>;
+    }
+}
+export type PageListOptions = {
+    select?: SelectFields<keyof PageModel>;
+    sortBy?: 'order' | 'subtitle' | 'title' | 'created' | 'modified';
+    sortOrder?: 1 | -1;
+};
+export declare class PageController<ResponseWrapper> implements IController {
+    private readonly client;
+    constructor(client: HTTPClient);
+    base: string;
+    name: string;
+    get proxy(): IRequestHandler<ResponseWrapper>;
+    /**
+     * 页面列表
+     */
+    getList(page?: number, perPage?: number, options?: PageListOptions): import("../interfaces/request").RequestProxyResult<PaginateResult<PageModel>, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: PaginateResult<PageModel>;
+    } : ResponseWrapper extends {
+        data: PaginateResult<PageModel>;
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: PaginateResult<PageModel>;
+    }>;
+    /**
+     * 页面详情
+     */
+    getById(id: string): import("../interfaces/request").RequestProxyResult<PageModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: PageModel;
+    } : ResponseWrapper extends {
+        data: PageModel;
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: PageModel;
+    }>;
+    /**
+     * 根据路径获取页面
+     * @param slug 路径
+     * @returns
+     */
+    getBySlug(slug: string): import("../interfaces/request").RequestProxyResult<PageModel, ResponseWrapper, ResponseWrapper extends unknown ? {
+        [key: string]: any;
+        data: PageModel;
+    } : ResponseWrapper extends {
+        data: PageModel;
+    } ? ResponseWrapper : Omit<ResponseWrapper, "data"> & {
+        data: PageModel;
+    }>;
+}