1 import { omit, pick } from '@shared/core-utils'
15 } from '@shared/models'
16 import { unwrapBody } from '../requests'
17 import { AbstractCommand, OverrideCommandOptions } from '../shared'
19 export class UsersCommand extends AbstractCommand {
21 askResetPassword (options: OverrideCommandOptions & {
24 const { email } = options
25 const path = '/api/v1/users/ask-reset-password'
27 return this.postBodyRequest({
33 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
37 resetPassword (options: OverrideCommandOptions & {
39 verificationString: string
42 const { userId, verificationString, password } = options
43 const path = '/api/v1/users/' + userId + '/reset-password'
45 return this.postBodyRequest({
49 fields: { password, verificationString },
51 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
55 // ---------------------------------------------------------------------------
57 askSendVerifyEmail (options: OverrideCommandOptions & {
60 const { email } = options
61 const path = '/api/v1/users/ask-send-verify-email'
63 return this.postBodyRequest({
69 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
73 verifyEmail (options: OverrideCommandOptions & {
75 verificationString: string
76 isPendingEmail?: boolean // default false
78 const { userId, verificationString, isPendingEmail = false } = options
79 const path = '/api/v1/users/' + userId + '/verify-email'
81 return this.postBodyRequest({
90 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
94 // ---------------------------------------------------------------------------
96 banUser (options: OverrideCommandOptions & {
100 const { userId, reason } = options
101 const path = '/api/v1/users' + '/' + userId + '/block'
103 return this.postBodyRequest({
109 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
113 unbanUser (options: OverrideCommandOptions & {
116 const { userId } = options
117 const path = '/api/v1/users' + '/' + userId + '/unblock'
119 return this.postBodyRequest({
124 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
128 // ---------------------------------------------------------------------------
130 getMyScopedTokens (options: OverrideCommandOptions = {}) {
131 const path = '/api/v1/users/scoped-tokens'
133 return this.getRequestBody<ScopedToken>({
138 defaultExpectedStatus: HttpStatusCode.OK_200
142 renewMyScopedTokens (options: OverrideCommandOptions = {}) {
143 const path = '/api/v1/users/scoped-tokens'
145 return this.postBodyRequest({
150 defaultExpectedStatus: HttpStatusCode.OK_200
154 // ---------------------------------------------------------------------------
156 create (options: OverrideCommandOptions & {
160 videoQuotaDaily?: number
162 adminFlags?: UserAdminFlag
167 password = 'password',
168 videoQuota = 42000000,
169 videoQuotaDaily = -1,
173 const path = '/api/v1/users'
175 return unwrapBody<{ user: UserCreateResult }>(this.postBodyRequest({
184 email: username + '@example.com',
189 defaultExpectedStatus: HttpStatusCode.OK_200
190 })).then(res => res.user)
193 async generate (username: string, role?: UserRole) {
194 const password = 'password'
195 const user = await this.create({ username, password, role })
197 const token = await this.server.login.getAccessToken({ username, password })
199 const me = await this.getMyInfo({ token })
204 userChannelId: me.videoChannels[0].id,
205 userChannelName: me.videoChannels[0].name
209 async generateUserAndToken (username: string, role?: UserRole) {
210 const password = 'password'
211 await this.create({ username, password, role })
213 return this.server.login.getAccessToken({ username, password })
216 register (options: OverrideCommandOptions & {
225 const { username, password = 'password', displayName, channel } = options
226 const path = '/api/v1/users/register'
228 return this.postBodyRequest({
235 email: username + '@example.com',
239 implicitToken: false,
240 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
244 // ---------------------------------------------------------------------------
246 getMyInfo (options: OverrideCommandOptions = {}) {
247 const path = '/api/v1/users/me'
249 return this.getRequestBody<MyUser>({
254 defaultExpectedStatus: HttpStatusCode.OK_200
258 getMyQuotaUsed (options: OverrideCommandOptions = {}) {
259 const path = '/api/v1/users/me/video-quota-used'
261 return this.getRequestBody<UserVideoQuota>({
266 defaultExpectedStatus: HttpStatusCode.OK_200
270 getMyRating (options: OverrideCommandOptions & {
271 videoId: number | string
273 const { videoId } = options
274 const path = '/api/v1/users/me/videos/' + videoId + '/rating'
276 return this.getRequestBody<UserVideoRate>({
281 defaultExpectedStatus: HttpStatusCode.OK_200
285 deleteMe (options: OverrideCommandOptions = {}) {
286 const path = '/api/v1/users/me'
288 return this.deleteRequest({
293 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
297 updateMe (options: OverrideCommandOptions & UserUpdateMe) {
298 const path = '/api/v1/users/me'
300 const toSend: UserUpdateMe = omit(options, [ 'expectedStatus', 'token' ])
302 return this.putBodyRequest({
308 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
312 updateMyAvatar (options: OverrideCommandOptions & {
315 const { fixture } = options
316 const path = '/api/v1/users/me/avatar/pick'
318 return this.updateImageRequest({
323 fieldname: 'avatarfile',
326 defaultExpectedStatus: HttpStatusCode.OK_200
330 // ---------------------------------------------------------------------------
332 get (options: OverrideCommandOptions & {
334 withStats?: boolean // default false
336 const { userId, withStats } = options
337 const path = '/api/v1/users/' + userId
339 return this.getRequestBody<User>({
343 query: { withStats },
345 defaultExpectedStatus: HttpStatusCode.OK_200
349 list (options: OverrideCommandOptions & {
356 const path = '/api/v1/users'
358 return this.getRequestBody<ResultList<User>>({
362 query: pick(options, [ 'start', 'count', 'sort', 'search', 'blocked' ]),
364 defaultExpectedStatus: HttpStatusCode.OK_200
368 remove (options: OverrideCommandOptions & {
371 const { userId } = options
372 const path = '/api/v1/users/' + userId
374 return this.deleteRequest({
379 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204
383 update (options: OverrideCommandOptions & {
386 emailVerified?: boolean
388 videoQuotaDaily?: number
390 adminFlags?: UserAdminFlag
394 const path = '/api/v1/users/' + options.userId
396 const toSend: UserUpdate = {}
397 if (options.password !== undefined && options.password !== null) toSend.password = options.password
398 if (options.email !== undefined && options.email !== null) toSend.email = options.email
399 if (options.emailVerified !== undefined && options.emailVerified !== null) toSend.emailVerified = options.emailVerified
400 if (options.videoQuota !== undefined && options.videoQuota !== null) toSend.videoQuota = options.videoQuota
401 if (options.videoQuotaDaily !== undefined && options.videoQuotaDaily !== null) toSend.videoQuotaDaily = options.videoQuotaDaily
402 if (options.role !== undefined && options.role !== null) toSend.role = options.role
403 if (options.adminFlags !== undefined && options.adminFlags !== null) toSend.adminFlags = options.adminFlags
404 if (options.pluginAuth !== undefined) toSend.pluginAuth = options.pluginAuth
406 return this.putBodyRequest({
412 defaultExpectedStatus: HttpStatusCode.NO_CONTENT_204