@mx-space/api-client 0.6.3 → 0.7.0-alpha.0

package/src/controllers/comment.ts

@@ -0,0 +1,64 @@
+import { IController } from '~/interfaces/controller'
+import { PaginationParams } from '~/interfaces/params'
+import { IRequestHandler, RequestProxyResult } from '~/interfaces/request'
+import { PaginateResult } from '~/models/base'
+import { CommentModel } from '~/models/comment'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+import { CommentDto } from '../dtos/comment'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    comment: CommentController
+  }
+}
+
+export class CommentController implements IController {
+  base = 'comments'
+  name = 'comment'
+
+  constructor(private readonly client: HTTPClient) {
+    autoBind(this)
+  }
+
+  get proxy(): IRequestHandler {
+    return this.client.proxy(this.base)
+  }
+
+  /**
+   * 根据 comment id 获取评论, 包括子评论
+   */
+  getById(id: string): RequestProxyResult<CommentModel> {
+    return this.proxy(id).get<CommentModel & { ref: string }>()
+  }
+
+  /**
+   * 获取文章的评论列表
+   * @param refId 文章 Id
+   */
+  getByRefId(refId: string, pagination: PaginationParams = {}) {
+    const { page, size } = pagination
+    return this.proxy
+      .ref(refId)
+      .get<PaginateResult<CommentModel & { ref: string }>>({
+        params: { page: page || 1, size: size || 10 },
+      })
+  }
+  /**
+   * 评论
+   */
+  comment(refId: string, data: CommentDto) {
+    return this.proxy(refId).post<CommentModel>({
+      data,
+    })
+  }
+
+  /**
+   * 回复评论
+   */
+  reply(commentId: string, data: CommentDto) {
+    return this.proxy.reply(commentId).post<CommentModel>({
+      data,
+    })
+  }
+}

package/src/controllers/index.ts

@@ -0,0 +1,66 @@
+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 { SnippetController } from './snippet'
+import { UserController } from './user'
+
+export const allControllers = [
+  AggregateController,
+  CategoryController,
+  CommentController,
+  LinkController,
+  NoteController,
+  PageController,
+  PostController,
+  ProjectController,
+  RecentlyController,
+  SayController,
+  SearchController,
+  SnippetController,
+  UserController,
+]
+
+export const allContollerNames = [
+  'aggregate',
+  'category',
+  'comment',
+  'link',
+  'note',
+  'page',
+  'post',
+  'project',
+  'recently',
+  'say',
+  'search',
+  'snippet',
+  'user',
+
+  // alias,
+  'friend',
+  'master',
+  'shorthand',
+] as const
+
+export {
+  AggregateController,
+  CategoryController,
+  CommentController,
+  LinkController,
+  NoteController,
+  PageController,
+  PostController,
+  ProjectController,
+  RecentlyController,
+  SayController,
+  SearchController,
+  SnippetController,
+  UserController,
+}

package/src/controllers/link.ts

@@ -0,0 +1,21 @@
+import { LinkModel } from '~/models/link'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+import { BaseCrudController } from './base'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    link: LinkController
+    friend: LinkController
+  }
+}
+
+export class LinkController extends BaseCrudController<LinkModel> {
+  constructor(protected readonly client: HTTPClient) {
+    super(client)
+    autoBind(this)
+  }
+
+  name = ['link', 'friend']
+  base = 'links'
+}

package/src/controllers/note.ts

@@ -0,0 +1,92 @@
+import { IController } from '~/interfaces/controller'
+import { IRequestHandler, RequestProxyResult } from '~/interfaces/request'
+import { PaginateResult } from '~/models/base'
+import { NoteModel, NoteWrappedPayload } from '~/models/note'
+import { SelectFields } from '~/types/helper'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core/client'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    note: NoteController
+  }
+}
+
+export type NoteListOptions = {
+  select?: SelectFields<keyof NoteModel>
+  year?: number
+  sortBy?: 'weather' | 'mood' | 'title' | 'created' | 'modified'
+  sortOrder?: 1 | -1
+}
+
+export class NoteController implements IController {
+  base = 'notes'
+  name = 'note'
+
+  constructor(private client: HTTPClient) {
+    autoBind(this)
+  }
+  get proxy(): IRequestHandler {
+    return this.client.proxy(this.base)
+  }
+
+  /**
+   * 最新日记
+   */
+  getLatest(): RequestProxyResult<NoteWrappedPayload> {
+    return this.proxy.latest.get<NoteWrappedPayload>()
+  }
+
+  /**
+   * 获取一篇日记
+   * @param id id | nid
+   * @param password 访问密码
+   */
+
+  getNoteById(id: string | number, password?: string) {
+    if (typeof id === 'number') {
+      return this.proxy.nid(id.toString()).get<NoteWrappedPayload>({
+        params: { password },
+      })
+    } else {
+      return this.proxy(id).get<NoteWrappedPayload>({ params: { password } })
+    }
+  }
+
+  /**
+   * 日记列表分页
+   */
+
+  getList(page = 1, perPage = 10, options: NoteListOptions = {}) {
+    const { select, sortBy, sortOrder, year } = options
+    return this.proxy.get<PaginateResult<NoteModel>>({
+      params: {
+        page,
+        size: perPage,
+        select: select?.join(' '),
+        sortBy,
+        sortOrder,
+        year,
+      },
+    })
+  }
+
+  /**
+   * 获取当前日记的上下各 n / 2 篇日记
+   */
+  getMiddleList(id: string, size = 5) {
+    return this.proxy.list(id).get<{
+      data: Pick<NoteModel, 'id' | 'title' | 'nid' | 'created'>[]
+      size: number
+    }>({
+      params: { size },
+    })
+  }
+
+  /**
+   * 喜欢这篇日记
+   */
+  likeIt(id: string | number) {
+    return this.proxy.like(id).get<never>()
+  }
+}

package/src/controllers/page.ts

@@ -0,0 +1,59 @@
+import { IController } from '~/interfaces/controller'
+import { PaginateResult } from '~/models/base'
+import { PageModel } from '~/models/page'
+import { SelectFields } from '~/types/helper'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    page: PageController
+  }
+}
+
+export type PageListOptions = {
+  select?: SelectFields<keyof PageModel>
+  sortBy?: 'order' | 'subtitle' | 'title' | 'created' | 'modified'
+  sortOrder?: 1 | -1
+}
+
+export class PageController implements IController {
+  constructor(private readonly client: HTTPClient) {
+    autoBind(this)
+  }
+  base = 'pages'
+  name = 'page'
+  get proxy() {
+    return this.client.proxy(this.base)
+  }
+  /**
+   * 页面列表
+   */
+  getList(page = 1, perPage = 10, options: PageListOptions = {}) {
+    const { select, sortBy, sortOrder } = options
+    return this.proxy.get<PaginateResult<PageModel>>({
+      params: {
+        page,
+        size: perPage,
+        select: select?.join(' '),
+        sortBy,
+        sortOrder,
+      },
+    })
+  }
+
+  /**
+   * 页面详情
+   */
+  getById(id: string) {
+    return this.proxy(id).get<PageModel>()
+  }
+  /**
+   * 根据路径获取页面
+   * @param slug 路径
+   * @returns
+   */
+  getBySlug(slug: string) {
+    return this.proxy.slug(slug).get<PageModel>({})
+  }
+}

package/src/controllers/post.ts

@@ -0,0 +1,87 @@
+import { IController } from '~/interfaces/controller'
+import { RequestProxyResult } from '~/interfaces/request'
+import { PaginateResult } from '~/models/base'
+import { PostModel } from '~/models/post'
+import { SelectFields } from '~/types/helper'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core/client'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    post: PostController
+  }
+}
+
+export type PostListOptions = {
+  select?: SelectFields<keyof PostModel>
+  year?: number
+  sortBy?: 'categoryId' | 'title' | 'created' | 'modified'
+  sortOrder?: 1 | -1
+}
+
+export class PostController implements IController {
+  constructor(private client: HTTPClient) {
+    autoBind(this)
+  }
+
+  base = 'posts'
+
+  name = 'post'
+
+  public get proxy() {
+    return this.client.proxy(this.base)
+  }
+
+  /**
+   * 获取文章列表分页
+   * @param page
+   * @param perPage
+   * @returns
+   */
+  getList(page = 1, perPage = 10, options: PostListOptions = {}) {
+    const { select, sortBy, sortOrder, year } = options
+    return this.proxy.get<PaginateResult<PostModel>>({
+      params: {
+        page,
+        size: perPage,
+        select: select?.join(' '),
+        sortBy,
+        sortOrder,
+        year,
+      },
+    })
+  }
+
+  /**
+   * 根据分类和路径查找文章
+   * @param categoryName
+   * @param slug
+   */
+  getPost(categoryName: string, slug: string): RequestProxyResult<PostModel>
+  /**
+   * 根据 ID 查找文章
+   * @param id
+   */
+  getPost(id: string): RequestProxyResult<PostModel>
+  getPost(idOrCategoryName: string, slug?: string): any {
+    if (arguments.length == 1) {
+      return this.proxy(idOrCategoryName).get<PostModel>()
+    } else {
+      return this.proxy(idOrCategoryName)(slug).get<PostModel>()
+    }
+  }
+
+  /**
+   * 获取最新的文章
+   */
+  getLatest() {
+    return this.proxy.latest.get<PostModel>()
+  }
+
+  /**
+   * 点赞
+   */
+  thumbsUp(id: string) {
+    return this.proxy('_thumbs-up').get<void>({ params: { id } })
+  }
+}

package/src/controllers/project.ts

@@ -0,0 +1,20 @@
+import { ProjectModel } from '~/models/project'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+import { BaseCrudController } from './base'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    project: ProjectController
+  }
+}
+
+export class ProjectController extends BaseCrudController<ProjectModel> {
+  constructor(protected readonly client: HTTPClient) {
+    super(client)
+    autoBind(this)
+  }
+
+  base = 'projects'
+  name = 'project'
+}

package/src/controllers/recently.ts

@@ -0,0 +1,48 @@
+import { IController } from '~/interfaces/controller'
+import { RecentlyModel } from '~/models/recently'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    recently: RecentlyController
+    shorthand: RecentlyController
+  }
+}
+
+export class RecentlyController implements IController {
+  base = 'recently'
+  name = ['recently', 'shorthand']
+
+  constructor(private readonly client: HTTPClient) {
+    autoBind(this)
+  }
+
+  get proxy() {
+    return this.client.proxy(this.base)
+  }
+  /**
+   * 获取最新一条
+   */
+  getLatestOne() {
+    return this.proxy.latest.get<RecentlyModel>()
+  }
+
+  getAll() {
+    return this.proxy.all.get<{ data: RecentlyModel[] }>()
+  }
+
+  getList(
+    before?: string | undefined,
+    after?: string | undefined,
+    size?: number | number,
+  ) {
+    return this.proxy.get<{ data: RecentlyModel[] }>({
+      params: {
+        before,
+        after,
+        size,
+      },
+    })
+  }
+}

package/src/controllers/say.ts

@@ -0,0 +1,35 @@
+import { IController } from '~/interfaces/controller'
+import { SayModel } from '~/models/say'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+import { BaseCrudController } from './base'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    say: SayController
+  }
+}
+
+export class SayController
+  extends BaseCrudController<SayModel>
+  implements IController
+{
+  base = 'says'
+  name = 'say'
+
+  constructor(protected client: HTTPClient) {
+    super(client)
+    autoBind(this)
+  }
+
+  public get proxy() {
+    return this.client.proxy(this.base)
+  }
+
+  /**
+   * 获取随机一条
+   */
+  getRandom() {
+    return this.proxy.random.get<{ data: SayModel | null }>()
+  }
+}

package/src/controllers/search.ts

@@ -0,0 +1,101 @@
+import { IController } from '~/interfaces/controller'
+import { IRequestHandler, RequestProxyResult } from '~/interfaces/request'
+import { PaginateResult } from '~/models/base'
+import { NoteModel } from '~/models/note'
+import { PostModel } from '~/models/post'
+import { autoBind } from '~/utils/auto-bind'
+import { PageModel } from '..'
+import { HTTPClient } from '../core'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    search: SearchController
+  }
+}
+
+export type SearchType = 'post' | 'note'
+
+export type SearchOption = {
+  orderBy?: string
+  order?: number
+  rawAlgolia?: boolean
+}
+export class SearchController implements IController {
+  base = 'search'
+  name = 'search'
+
+  constructor(private readonly client: HTTPClient) {
+    autoBind(this)
+  }
+
+  get proxy(): IRequestHandler {
+    return this.client.proxy(this.base)
+  }
+
+  search(
+    type: 'note',
+    keyword: string,
+    options?: Omit<SearchOption, 'rawAlgolia'>,
+  ): Promise<
+    RequestProxyResult<
+      PaginateResult<
+        Pick<NoteModel, 'modified' | 'id' | 'title' | 'created' | 'nid'>
+      >
+    >
+  >
+  search(
+    type: 'post',
+    keyword: string,
+    options?: Omit<SearchOption, 'rawAlgolia'>,
+  ): Promise<
+    RequestProxyResult<
+      PaginateResult<
+        Pick<
+          PostModel,
+          'modified' | 'id' | 'title' | 'created' | 'slug' | 'category'
+        >
+      >
+    >
+  >
+  search(
+    type: SearchType,
+    keyword: string,
+    options: Omit<SearchOption, 'rawAlgolia'> = {},
+  ): any {
+    return this.proxy(type).get({
+      params: { keyword, ...options },
+    })
+  }
+  /**
+   * 从 algolya 搜索
+   * https://www.algolia.com/doc/api-reference/api-methods/search/
+   * @param keyword
+   * @param options
+   * @returns
+   */
+  searchByAlgolia(keyword: string, options?: SearchOption) {
+    return this.proxy('algolia').get<
+      RequestProxyResult<
+        PaginateResult<
+          | (Pick<
+              PostModel,
+              'modified' | 'id' | 'title' | 'created' | 'slug' | 'category'
+            > & { type: 'post' })
+          | (Pick<
+              NoteModel,
+              'id' | 'created' | 'id' | 'modified' | 'title' | 'nid'
+            > & { type: 'note' })
+          | (Pick<
+              PageModel,
+              'id' | 'title' | 'created' | 'modified' | 'slug'
+            > & { type: 'page' })
+        > & {
+          /**
+           * @see: algoliasearch <https://www.algolia.com/doc/api-reference/api-methods/search/>
+           */
+          raw?: any
+        }
+      >
+    >({ params: { keyword, ...options } })
+  }
+}

package/src/controllers/snippet.ts

@@ -0,0 +1,31 @@
+import { IController } from '~/interfaces/controller'
+import { SnippetModel } from '~/models/snippet'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    snippet: SnippetController
+  }
+}
+
+export class SnippetController implements IController {
+  base = 'snippets'
+  name = 'snippet'
+
+  constructor(protected client: HTTPClient) {
+    autoBind(this)
+  }
+
+  get proxy() {
+    return this.client.proxy(this.base)
+  }
+
+  getById<T = unknown>(id: string) {
+    return this.proxy(id).get<SnippetModel<T>>()
+  }
+
+  getByReferenceAndName<T = unknown>(reference: string, name: string) {
+    return this.proxy(reference)(name).get<T>()
+  }
+}

package/src/controllers/user.ts

@@ -0,0 +1,46 @@
+import { IController } from '~/interfaces/controller'
+import { TLogin, UserModel } from '~/models/user'
+import { autoBind } from '~/utils/auto-bind'
+import { HTTPClient } from '../core'
+
+declare module '../core/client' {
+  interface HTTPClient {
+    user: UserController
+    master: UserController
+  }
+}
+
+export class UserController implements IController {
+  constructor(private readonly client: HTTPClient) {
+    autoBind(this)
+  }
+
+  base = 'master'
+
+  name = ['user', 'master']
+
+  public get proxy() {
+    return this.client.proxy(this.base)
+  }
+
+  getMasterInfo() {
+    return this.proxy.get<UserModel>()
+  }
+
+  login(username: string, password: string) {
+    return this.proxy.login.post<TLogin>({
+      data: {
+        username,
+        password,
+      },
+    })
+  }
+
+  checkTokenValid(token: string) {
+    return this.proxy.check_logged.get<{ ok: number; isGuest: boolean }>({
+      params: {
+        token: 'bearer ' + token.replace(/^Bearer\s/i, ''),
+      },
+    })
+  }
+}