tachybase_todo/packages/plugins/@nocobase/plugin-auth/src/swagger/index.ts
jack zhang 705b7449f0
feat: new plugin manager, supports adding plugins through UI (#2430)
* refactor: plugin manager page

* fix: bug

* feat: addByNpm api

* fix: improve the addByNpm

* feat: improve applicationPlugins:list api

* fix: re-download npm package when restart app

* fix: plugin delete api

* feat: plugin detail api

* feat: zipUrl add api

* fix: upload api bug

* fix: plugin detail info

* feat: upgrade api

* fix: upload api

* feat: handle plugin load error

* feat: support authToken

* feat: muti lang

* fix: build error

* fix: self review

* Update plugin-manager.ts

* fix: bug

* fix: bug

* fix: bug

* fix: bug

* fix: bug

* fix: bugs

* fix: detail click and remove isOfficial

* fix: upgrade no refresh

* fix: file size and type check

* fix: bug

* fix: upgrade error

* fix: bug

* fix: bug

* fix: plugin card layout

* fix: handling exceptional cases

* fix: tgz file support

* fix: macos compress file

* fix: bug

* fix: bug

* fix: bug

* fix: bug

* fix: add upgrade npm type

* fix: bugs

* fix: bug

* fix: change plugins static expose url

* fix: api prefix

* fix: bug

* fix: add nginx `/static/plugin/` path

* fix: bugs and pr docker build no dts

* fix: bug

* fix: build tools bug

* fix: improve code

* fix: build bug

* feat: improve plugin info

* fix: ui bug

* fix: plugin document bug

* feat: improve code

* feat: improve code

* feat: process dev deps check

* feat: improve code

* feat: process.env.IS_DEV_CMD

* fix: do not delete the plugin package

* feat: plugin symlink

* fix: tsx watch --ignore=./storage/plugins/**

* fix: test error

* fix: improve code

* fix: improve code

* fix: emitStartedEvent

* fix: improve code

* fix: type error

* fix: test error

* test: console.log

* fix: createStoragePluginSymLink

* fix: clientStaticMiddleware rename to clientStaticUtils

* feat: build tools support plugins folder

* fix: 350px

* fix: error

* feat: client dev support plugin folder

* fix: clear cli options

* fix: typeError: Converting circular structure to JSON

* fix: plugin name

* chore: restart application after command

* feat: upgrade error & docs

* Update v14-changelog.md

* Update v14-changelog.md

* Update v14-changelog.md

* fix: gateway test

* refactor(plugin-workflow): add ready state for gracefully tearing down

* Revert "chore: restart application after command"

This reverts commit 5015274f8e4e06e506e15754b672330330e8c7f8.

* chore: stop application whe restart

* T 1218 change plugin folder (#2629)

* feat: change folder name

* feat: change `pm create` command

* feat:  revert plugin name change

* fix: delete samples

* feat: change plugins folder

* fix: pm create

* feat: update docs

* fix: link package error

* fix: docs

* fix: create command

* fix: pm add error

* fix: create  add build

* fix: pm creatre + add

* feat: add tar command

* fix: docs

* fix: bug

* fix: docs

---------

Co-authored-by: chenos <chenlinxh@gmail.com>

* feat: docs

* Update your-fisrt-plugin.md

* Update your-fisrt-plugin.md

* chore: application reload

* chore: test

* fix: pm add error

* chore: preset install skip exists plugin

* fix: createIfNotExists

---------

Co-authored-by: chenos <chenlinxh@gmail.com>
Co-authored-by: chareice <chareice@live.com>
Co-authored-by: Zhou <zhou.working@gmail.com>
Co-authored-by: mytharcher <mytharcher@gmail.com>
2023-09-12 22:39:23 +08:00

732 lines
18 KiB
TypeScript

export default {
info: {
title: 'NocoBase API - Auth plugin',
},
paths: {
'/auth:check': {
get: {
description: 'Check if the user is logged in',
tags: ['Auth'],
parameters: [
{
name: 'X-Authenticator',
description: '登录方式标识',
in: 'header',
schema: {
type: 'string',
default: 'basic',
},
},
],
security: [],
responses: {
200: {
description: 'successful operation',
content: {
'application/json': {
schema: {
allOf: [
{
$ref: '#/components/schemas/user',
},
{
type: 'object',
properties: {
roles: {
$ref: '#/components/schemas/roles',
},
},
},
],
},
},
},
},
},
},
},
'/auth:signIn': {
post: {
description: 'Sign in',
tags: ['Basic auth'],
security: [],
parameters: [
{
name: 'X-Authenticator',
description: '登录方式标识',
in: 'header',
schema: {
type: 'string',
default: 'basic',
},
},
],
requestBody: {
content: {
'application/json': {
schema: {
type: 'object',
properties: {
email: {
type: 'string',
description: '邮箱',
},
password: {
type: 'string',
description: '密码',
},
},
},
},
},
},
responses: {
200: {
description: 'successful operation',
content: {
'application/json': {
schema: {
type: 'object',
properties: {
token: {
type: 'string',
},
user: {
$ref: '#/components/schemas/user',
},
},
},
},
},
},
401: {
description: 'Unauthorized',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/error',
},
},
},
},
},
},
},
'/auth:signUp': {
post: {
description: 'Sign up',
tags: ['Basic auth'],
security: [],
requestBody: {
content: {
'application/json': {
schema: {
type: 'object',
properties: {
email: {
type: 'string',
description: '邮箱',
},
password: {
type: 'string',
description: '密码',
},
confirm_password: {
type: 'string',
description: '确认密码',
},
},
},
},
},
},
responses: {
200: {
description: 'ok',
},
},
},
},
'/auth:signOut': {
post: {
description: 'Sign out',
tags: ['Basic auth'],
security: [],
responses: {
200: {
description: 'ok',
},
},
},
},
'/auth:lostPassword': {
post: {
description: 'Lost password',
tags: ['Basic auth'],
security: [],
requestBody: {
content: {
'application/json': {
schema: {
type: 'object',
properties: {
email: {
type: 'string',
description: '邮箱',
},
},
},
},
},
},
responses: {
200: {
description: 'successful operation',
content: {
'application/json': {
schema: {
allOf: [
{
$ref: '#/components/schemas/user',
},
{
type: 'object',
properties: {
resetToken: {
type: 'string',
description: '重置密码的token',
},
},
},
],
},
},
},
},
400: {
description: 'Please fill in your email address',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/error',
},
},
},
},
401: {
description: 'The email is incorrect, please re-enter',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/error',
},
},
},
},
},
},
},
'/auth:resetPassword': {
post: {
description: 'Reset password',
tags: ['Basic auth'],
security: [],
requestBody: {
content: {
'application/json': {
schema: {
type: 'object',
properties: {
email: {
type: 'string',
description: '邮箱',
},
password: {
type: 'string',
description: '密码',
},
resetToken: {
type: 'string',
description: '重置密码的token',
},
},
},
},
},
},
responses: {
200: {
description: 'successful operation',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/user',
},
},
},
},
404: {
description: 'User not found',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/error',
},
},
},
},
},
},
},
'/auth:getUserByResetToken': {
get: {
description: 'Get user by reset token',
tags: ['Basic auth'],
security: [],
parameters: [
{
name: 'token',
in: 'query',
description: '重置密码的token',
required: true,
schema: {
type: 'string',
},
},
],
responses: {
200: {
description: 'ok',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/user',
},
},
},
},
401: {
description: 'Unauthorized',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/error',
},
},
},
},
},
},
},
'authenticators:listTypes': {
get: {
description: 'List authenticator types',
tags: ['Authenticator'],
responses: {
200: {
description: 'ok',
content: {
'application/json': {
schema: {
type: 'array',
items: {
type: 'string',
},
},
},
},
},
},
},
},
'authenticators:publicList': {
get: {
description: 'List enabled authenticators',
tags: ['Authenticator'],
security: [],
responses: {
200: {
description: 'ok',
content: {
'application/json': {
schema: {
type: 'array',
items: {
type: 'object',
properties: {
name: {
type: 'string',
description: '登录方式标识',
},
title: {
type: 'string',
description: '登录方式标题',
},
authType: {
type: 'string',
description: '登录方式类型',
},
options: {
type: 'object',
description: '登录方式公开配置',
},
},
},
},
},
},
},
},
},
},
'authenticators:create': {
post: {
description: 'Create authenticator',
tags: ['Authenticator'],
requestBody: {
content: {
'application/json': {
schema: {
type: 'object',
properties: {
name: {
type: 'string',
description: '登录方式标识',
},
authType: {
type: 'string',
description: '登录方式类型',
},
options: {
type: 'object',
description: '登录方式配置',
},
},
},
},
},
},
responses: {
200: {
description: 'ok',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/authenticator',
},
},
},
},
},
},
},
'authenticators:list': {
get: {
description: 'List authenticators',
tags: ['Authenticator'],
responses: {
200: {
description: 'ok',
content: {
'application/json': {
schema: {
type: 'array',
items: {
$ref: '#/components/schemas/authenticator',
},
},
},
},
},
},
},
},
'authenticators:get': {
get: {
description: 'Get authenticator',
tags: ['Authenticator'],
parameters: [
{
name: 'filterByTk',
in: 'query',
description: 'ID',
required: true,
schema: {
type: 'integer',
},
},
],
responses: {
200: {
description: 'ok',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/authenticator',
},
},
},
},
},
},
},
'authenticators:update': {
post: {
description: 'Update authenticator',
tags: ['Authenticator'],
parameters: [
{
name: 'filterByTk',
in: 'query',
description: 'ID',
required: true,
schema: {
type: 'integer',
},
},
],
requestBody: {
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/authenticator',
},
},
},
},
responses: {
200: {
description: 'ok',
content: {
'application/json': {
schema: {
$ref: '#/components/schemas/authenticator',
},
},
},
},
},
},
},
'authenticators:destroy': {
post: {
description: 'Destroy authenticator',
tags: ['Authenticator'],
parameters: [
{
name: 'filterByTk',
in: 'query',
description: 'ID',
required: true,
schema: {
type: 'integer',
},
},
],
responses: {
200: {
description: 'ok',
},
},
},
},
},
components: {
schemas: {
user: {
type: 'object',
description: '用户',
properties: {
id: {
type: 'integer',
description: 'ID',
},
nickname: {
type: 'string',
description: '昵称',
},
email: {
type: 'string',
description: '邮箱',
},
phone: {
type: 'string',
description: '手机号',
},
appLang: {
type: 'string',
description: '用户使用语言',
},
systemSettings: {
type: 'object',
description: '系统设置',
properties: {
theme: {
type: 'string',
description: '用户使用主题',
},
},
},
createdAt: {
type: 'string',
format: 'date-time',
description: '创建时间',
},
updatedAt: {
type: 'string',
format: 'date-time',
description: '更新时间',
},
createdById: {
type: 'integer',
description: '创建人',
},
updatedById: {
type: 'integer',
description: '更新人',
},
},
},
roles: {
type: 'array',
description: '角色',
items: {
type: 'object',
properties: {
title: {
type: 'string',
description: '角色名称',
},
name: {
type: 'string',
description: '角色标识',
},
description: {
type: 'string',
description: '角色描述',
},
hidden: {
type: 'boolean',
description: '是否隐藏',
},
default: {
type: 'boolean',
description: '是否默认',
},
allowConfigure: {
type: 'boolean',
description: '是否允许配置',
},
allowNewMenu: {
type: 'boolean',
description: '是否允许新建菜单',
},
snippets: {
type: 'array',
items: {
type: 'string',
},
description: '接口权限',
},
strategy: {
type: 'array',
description: '数据表权限策略',
items: {
type: 'object',
properties: {
actions: {
type: 'array',
items: {
type: 'string',
},
description: '操作',
},
},
},
},
createdAt: {
type: 'string',
format: 'date-time',
description: '创建时间',
},
updatedAt: {
type: 'string',
format: 'date-time',
description: '更新时间',
},
},
},
},
authenticator: {
type: 'object',
properties: {
id: {
type: 'integer',
description: 'ID',
},
authType: {
type: 'string',
description: '登录方式类型',
},
name: {
type: 'string',
description: '登录方式标识',
},
title: {
type: 'string',
description: '登录方式标题',
},
options: {
type: 'object',
description: '登录方式配置',
},
description: {
type: 'string',
description: '登录方式描述',
},
enabled: {
type: 'boolean',
description: '是否启用',
},
createdAt: {
type: 'string',
format: 'date-time',
description: '创建时间',
},
updatedAt: {
type: 'string',
format: 'date-time',
description: '更新时间',
},
createdById: {
type: 'integer',
description: '创建人',
},
updatedById: {
type: 'integer',
description: '更新人',
},
},
},
},
},
};
/*
/api/auth:check
/api/auth:signIn
/api/auth:signUp
/api/auth:signOut
/api/auth:lostPassword
/api/auth:resetPassword
/api/auth:getUserByResetToken
/api/auth:changePassword
/api/authenticators:listTypes
/api/authenticators:publicList
/api/authenticators:create
/api/authenticators:list
/api/authenticators:get
/api/authenticators:update
/api/authenticators:destroy
*/