X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=server%2Fcontrollers%2Fapi%2Fvideos%2Findex.ts;h=61a030ba144e18835557279dc05678f50dafbedc;hb=7226e90fdc61a3c6cad5ccab18b6707d55cf0992;hp=eb46ea01f5d0bbc78d14a633f5096296221fbf69;hpb=134cf2bce96a8c5aefd55154e884964975d8cf23;p=github%2FChocobozzz%2FPeerTube.git diff --git a/server/controllers/api/videos/index.ts b/server/controllers/api/videos/index.ts index eb46ea01f..61a030ba1 100644 --- a/server/controllers/api/videos/index.ts +++ b/server/controllers/api/videos/index.ts @@ -1,27 +1,21 @@ -import * as express from 'express' -import { extname } from 'path' -import { VideoCreate, VideoPrivacy, VideoState, VideoUpdate } from '../../../../shared' -import { getVideoFileFPS, getVideoFileResolution } from '../../../helpers/ffmpeg-utils' -import { logger } from '../../../helpers/logger' +import express from 'express' +import { pickCommonVideoQuery } from '@server/helpers/query' +import { doJSONRequest } from '@server/helpers/requests' +import { VideoViews } from '@server/lib/video-views' +import { openapiOperationDoc } from '@server/middlewares/doc' +import { getServerActor } from '@server/models/application/application' +import { guessAdditionalAttributesFromQuery } from '@server/models/video/formatter/video-format-utils' +import { MVideoAccountLight } from '@server/types/models' +import { HttpStatusCode } from '../../../../shared/models' import { auditLoggerFactory, getAuditIdFromRes, VideoAuditView } from '../../../helpers/audit-logger' -import { getFormattedObjects, getServerActor } from '../../../helpers/utils' -import { autoBlacklistVideoIfNeeded } from '../../../lib/video-blacklist' -import { - DEFAULT_AUDIO_RESOLUTION, - MIMETYPES, - VIDEO_CATEGORIES, - VIDEO_LANGUAGES, - VIDEO_LICENCES, - VIDEO_PRIVACIES -} from '../../../initializers/constants' -import { - changeVideoChannelShare, - federateVideoIfNeeded, - fetchRemoteVideoDescription, - getVideoActivityPubUrl -} from '../../../lib/activitypub' +import { buildNSFWFilter, getCountVideos } from '../../../helpers/express-utils' +import { logger } from '../../../helpers/logger' +import { getFormattedObjects } from '../../../helpers/utils' +import { REMOTE_SCHEME, VIDEO_CATEGORIES, VIDEO_LANGUAGES, VIDEO_LICENCES, VIDEO_PRIVACIES } from '../../../initializers/constants' +import { sequelizeTypescript } from '../../../initializers/database' +import { sendView } from '../../../lib/activitypub/send/send-view' import { JobQueue } from '../../../lib/job-queue' -import { Redis } from '../../../lib/redis' +import { Hooks } from '../../../lib/plugins/hooks' import { asyncMiddleware, asyncRetryTransactionMiddleware, @@ -31,64 +25,29 @@ import { optionalAuthenticate, paginationValidator, setDefaultPagination, - setDefaultSort, - videosAddValidator, + setDefaultVideosSort, videosCustomGetValidator, videosGetValidator, videosRemoveValidator, - videosSortValidator, - videosUpdateValidator + videosSortValidator } from '../../../middlewares' -import { TagModel } from '../../../models/video/tag' import { VideoModel } from '../../../models/video/video' -import { VideoFileModel } from '../../../models/video/video-file' -import { abuseVideoRouter } from './abuse' import { blacklistRouter } from './blacklist' -import { videoCommentRouter } from './comment' -import { rateVideoRouter } from './rate' -import { ownershipVideoRouter } from './ownership' -import { VideoFilter } from '../../../../shared/models/videos/video-query.type' -import { buildNSFWFilter, createReqFiles, getCountVideos } from '../../../helpers/express-utils' -import { ScheduleVideoUpdateModel } from '../../../models/video/schedule-video-update' import { videoCaptionsRouter } from './captions' +import { videoCommentRouter } from './comment' +import { filesRouter } from './files' import { videoImportsRouter } from './import' -import { resetSequelizeInstance } from '../../../helpers/database-utils' -import { move } from 'fs-extra' +import { liveRouter } from './live' +import { ownershipVideoRouter } from './ownership' +import { rateVideoRouter } from './rate' +import { transcodingRouter } from './transcoding' +import { updateRouter } from './update' +import { uploadRouter } from './upload' import { watchingRouter } from './watching' -import { Notifier } from '../../../lib/notifier' -import { sendView } from '../../../lib/activitypub/send/send-view' -import { CONFIG } from '../../../initializers/config' -import { sequelizeTypescript } from '../../../initializers/database' -import { createVideoMiniatureFromExisting, generateVideoMiniature } from '../../../lib/thumbnail' -import { ThumbnailType } from '../../../../shared/models/videos/thumbnail.type' -import { VideoTranscodingPayload } from '../../../lib/job-queue/handlers/video-transcoding' -import { Hooks } from '../../../lib/plugins/hooks' -import { MVideoDetails, MVideoFullLight } from '@server/typings/models' -import { createTorrentAndSetInfoHash } from '@server/helpers/webtorrent' -import { getVideoFilePath } from '@server/lib/video-paths' const auditLogger = auditLoggerFactory('videos') const videosRouter = express.Router() -const reqVideoFileAdd = createReqFiles( - [ 'videofile', 'thumbnailfile', 'previewfile' ], - Object.assign({}, MIMETYPES.VIDEO.MIMETYPE_EXT, MIMETYPES.IMAGE.MIMETYPE_EXT), - { - videofile: CONFIG.STORAGE.TMP_DIR, - thumbnailfile: CONFIG.STORAGE.TMP_DIR, - previewfile: CONFIG.STORAGE.TMP_DIR - } -) -const reqVideoFileUpdate = createReqFiles( - [ 'thumbnailfile', 'previewfile' ], - MIMETYPES.IMAGE.MIMETYPE_EXT, - { - thumbnailfile: CONFIG.STORAGE.TMP_DIR, - previewfile: CONFIG.STORAGE.TMP_DIR - } -) - -videosRouter.use('/', abuseVideoRouter) videosRouter.use('/', blacklistRouter) videosRouter.use('/', rateVideoRouter) videosRouter.use('/', videoCommentRouter) @@ -96,50 +55,60 @@ videosRouter.use('/', videoCaptionsRouter) videosRouter.use('/', videoImportsRouter) videosRouter.use('/', ownershipVideoRouter) videosRouter.use('/', watchingRouter) - -videosRouter.get('/categories', listVideoCategories) -videosRouter.get('/licences', listVideoLicences) -videosRouter.get('/languages', listVideoLanguages) -videosRouter.get('/privacies', listVideoPrivacies) +videosRouter.use('/', liveRouter) +videosRouter.use('/', uploadRouter) +videosRouter.use('/', updateRouter) +videosRouter.use('/', filesRouter) +videosRouter.use('/', transcodingRouter) + +videosRouter.get('/categories', + openapiOperationDoc({ operationId: 'getCategories' }), + listVideoCategories +) +videosRouter.get('/licences', + openapiOperationDoc({ operationId: 'getLicences' }), + listVideoLicences +) +videosRouter.get('/languages', + openapiOperationDoc({ operationId: 'getLanguages' }), + listVideoLanguages +) +videosRouter.get('/privacies', + openapiOperationDoc({ operationId: 'getPrivacies' }), + listVideoPrivacies +) videosRouter.get('/', + openapiOperationDoc({ operationId: 'getVideos' }), paginationValidator, videosSortValidator, - setDefaultSort, + setDefaultVideosSort, setDefaultPagination, optionalAuthenticate, commonVideosFiltersValidator, asyncMiddleware(listVideos) ) -videosRouter.put('/:id', - authenticate, - reqVideoFileUpdate, - asyncMiddleware(videosUpdateValidator), - asyncRetryTransactionMiddleware(updateVideo) -) -videosRouter.post('/upload', - authenticate, - reqVideoFileAdd, - asyncMiddleware(videosAddValidator), - asyncRetryTransactionMiddleware(addVideo) -) videosRouter.get('/:id/description', + openapiOperationDoc({ operationId: 'getVideoDesc' }), asyncMiddleware(videosGetValidator), asyncMiddleware(getVideoDescription) ) videosRouter.get('/:id', + openapiOperationDoc({ operationId: 'getVideo' }), optionalAuthenticate, - asyncMiddleware(videosCustomGetValidator('only-video-with-rights')), + asyncMiddleware(videosCustomGetValidator('for-api')), asyncMiddleware(checkVideoFollowConstraints), - asyncMiddleware(getVideo) + getVideo ) videosRouter.post('/:id/views', - asyncMiddleware(videosCustomGetValidator('only-immutable-attributes')), + openapiOperationDoc({ operationId: 'addView' }), + asyncMiddleware(videosCustomGetValidator('only-video')), asyncMiddleware(viewVideo) ) videosRouter.delete('/:id', + openapiOperationDoc({ operationId: 'delVideo' }), authenticate, asyncMiddleware(videosRemoveValidator), asyncRetryTransactionMiddleware(removeVideo) @@ -153,302 +122,24 @@ export { // --------------------------------------------------------------------------- -function listVideoCategories (req: express.Request, res: express.Response) { +function listVideoCategories (_req: express.Request, res: express.Response) { res.json(VIDEO_CATEGORIES) } -function listVideoLicences (req: express.Request, res: express.Response) { +function listVideoLicences (_req: express.Request, res: express.Response) { res.json(VIDEO_LICENCES) } -function listVideoLanguages (req: express.Request, res: express.Response) { +function listVideoLanguages (_req: express.Request, res: express.Response) { res.json(VIDEO_LANGUAGES) } -function listVideoPrivacies (req: express.Request, res: express.Response) { +function listVideoPrivacies (_req: express.Request, res: express.Response) { res.json(VIDEO_PRIVACIES) } -async function addVideo (req: express.Request, res: express.Response) { - // Processing the video could be long - // Set timeout to 10 minutes - req.setTimeout(1000 * 60 * 10, () => { - logger.error('Upload video has timed out.') - return res.sendStatus(408) - }) - - const videoPhysicalFile = req.files['videofile'][0] - const videoInfo: VideoCreate = req.body - - // Prepare data so we don't block the transaction - const videoData = { - name: videoInfo.name, - remote: false, - category: videoInfo.category, - licence: videoInfo.licence, - language: videoInfo.language, - commentsEnabled: videoInfo.commentsEnabled !== false, // If the value is not "false", the default is "true" - downloadEnabled: videoInfo.downloadEnabled !== false, - waitTranscoding: videoInfo.waitTranscoding || false, - state: CONFIG.TRANSCODING.ENABLED ? VideoState.TO_TRANSCODE : VideoState.PUBLISHED, - nsfw: videoInfo.nsfw || false, - description: videoInfo.description, - support: videoInfo.support, - privacy: videoInfo.privacy || VideoPrivacy.PRIVATE, - duration: videoPhysicalFile['duration'], // duration was added by a previous middleware - channelId: res.locals.videoChannel.id, - originallyPublishedAt: videoInfo.originallyPublishedAt - } - - const video = new VideoModel(videoData) as MVideoDetails - video.url = getVideoActivityPubUrl(video) // We use the UUID, so set the URL after building the object - - const videoFile = new VideoFileModel({ - extname: extname(videoPhysicalFile.filename), - size: videoPhysicalFile.size, - videoStreamingPlaylistId: null - }) - - if (videoFile.isAudio()) { - videoFile.resolution = DEFAULT_AUDIO_RESOLUTION - } else { - videoFile.fps = await getVideoFileFPS(videoPhysicalFile.path) - videoFile.resolution = (await getVideoFileResolution(videoPhysicalFile.path)).videoFileResolution - } - - // Move physical file - const destination = getVideoFilePath(video, videoFile) - await move(videoPhysicalFile.path, destination) - // This is important in case if there is another attempt in the retry process - videoPhysicalFile.filename = getVideoFilePath(video, videoFile) - videoPhysicalFile.path = destination - - // Process thumbnail or create it from the video - const thumbnailField = req.files['thumbnailfile'] - const thumbnailModel = thumbnailField - ? await createVideoMiniatureFromExisting(thumbnailField[0].path, video, ThumbnailType.MINIATURE, false) - : await generateVideoMiniature(video, videoFile, ThumbnailType.MINIATURE) - - // Process preview or create it from the video - const previewField = req.files['previewfile'] - const previewModel = previewField - ? await createVideoMiniatureFromExisting(previewField[0].path, video, ThumbnailType.PREVIEW, false) - : await generateVideoMiniature(video, videoFile, ThumbnailType.PREVIEW) - - // Create the torrent file - await createTorrentAndSetInfoHash(video, videoFile) - - const { videoCreated } = await sequelizeTypescript.transaction(async t => { - const sequelizeOptions = { transaction: t } - - const videoCreated = await video.save(sequelizeOptions) as MVideoFullLight - - await videoCreated.addAndSaveThumbnail(thumbnailModel, t) - await videoCreated.addAndSaveThumbnail(previewModel, t) - - // Do not forget to add video channel information to the created video - videoCreated.VideoChannel = res.locals.videoChannel - - videoFile.videoId = video.id - await videoFile.save(sequelizeOptions) - - video.VideoFiles = [ videoFile ] - - // Create tags - if (videoInfo.tags !== undefined) { - const tagInstances = await TagModel.findOrCreateTags(videoInfo.tags, t) - - await video.$set('Tags', tagInstances, sequelizeOptions) - video.Tags = tagInstances - } - - // Schedule an update in the future? - if (videoInfo.scheduleUpdate) { - await ScheduleVideoUpdateModel.create({ - videoId: video.id, - updateAt: videoInfo.scheduleUpdate.updateAt, - privacy: videoInfo.scheduleUpdate.privacy || null - }, { transaction: t }) - } - - await autoBlacklistVideoIfNeeded({ - video, - user: res.locals.oauth.token.User, - isRemote: false, - isNew: true, - transaction: t - }) - await federateVideoIfNeeded(video, true, t) - - auditLogger.create(getAuditIdFromRes(res), new VideoAuditView(videoCreated.toFormattedDetailsJSON())) - logger.info('Video with name %s and uuid %s created.', videoInfo.name, videoCreated.uuid) - - return { videoCreated } - }) - - Notifier.Instance.notifyOnNewVideoIfNeeded(videoCreated) - - if (video.state === VideoState.TO_TRANSCODE) { - // Put uuid because we don't have id auto incremented for now - let dataInput: VideoTranscodingPayload - - if (videoFile.isAudio()) { - dataInput = { - type: 'merge-audio' as 'merge-audio', - resolution: DEFAULT_AUDIO_RESOLUTION, - videoUUID: videoCreated.uuid, - isNewVideo: true - } - } else { - dataInput = { - type: 'optimize' as 'optimize', - videoUUID: videoCreated.uuid, - isNewVideo: true - } - } - - await JobQueue.Instance.createJobWithPromise({ type: 'video-transcoding', payload: dataInput }) - } - - Hooks.runAction('action:api.video.uploaded', { video: videoCreated }) - - return res.json({ - video: { - id: videoCreated.id, - uuid: videoCreated.uuid - } - }).end() -} - -async function updateVideo (req: express.Request, res: express.Response) { - const videoInstance = res.locals.videoAll - const videoFieldsSave = videoInstance.toJSON() - const oldVideoAuditView = new VideoAuditView(videoInstance.toFormattedDetailsJSON()) - const videoInfoToUpdate: VideoUpdate = req.body - - const wasConfidentialVideo = videoInstance.isConfidential() - const hadPrivacyForFederation = videoInstance.hasPrivacyForFederation() - - // Process thumbnail or create it from the video - const thumbnailModel = req.files && req.files['thumbnailfile'] - ? await createVideoMiniatureFromExisting(req.files['thumbnailfile'][0].path, videoInstance, ThumbnailType.MINIATURE, false) - : undefined - - const previewModel = req.files && req.files['previewfile'] - ? await createVideoMiniatureFromExisting(req.files['previewfile'][0].path, videoInstance, ThumbnailType.PREVIEW, false) - : undefined - - try { - const videoInstanceUpdated = await sequelizeTypescript.transaction(async t => { - const sequelizeOptions = { transaction: t } - const oldVideoChannel = videoInstance.VideoChannel - - if (videoInfoToUpdate.name !== undefined) videoInstance.name = videoInfoToUpdate.name - if (videoInfoToUpdate.category !== undefined) videoInstance.category = videoInfoToUpdate.category - if (videoInfoToUpdate.licence !== undefined) videoInstance.licence = videoInfoToUpdate.licence - if (videoInfoToUpdate.language !== undefined) videoInstance.language = videoInfoToUpdate.language - if (videoInfoToUpdate.nsfw !== undefined) videoInstance.nsfw = videoInfoToUpdate.nsfw - if (videoInfoToUpdate.waitTranscoding !== undefined) videoInstance.waitTranscoding = videoInfoToUpdate.waitTranscoding - if (videoInfoToUpdate.support !== undefined) videoInstance.support = videoInfoToUpdate.support - if (videoInfoToUpdate.description !== undefined) videoInstance.description = videoInfoToUpdate.description - if (videoInfoToUpdate.commentsEnabled !== undefined) videoInstance.commentsEnabled = videoInfoToUpdate.commentsEnabled - if (videoInfoToUpdate.downloadEnabled !== undefined) videoInstance.downloadEnabled = videoInfoToUpdate.downloadEnabled - - if (videoInfoToUpdate.originallyPublishedAt !== undefined && videoInfoToUpdate.originallyPublishedAt !== null) { - videoInstance.originallyPublishedAt = new Date(videoInfoToUpdate.originallyPublishedAt) - } - - let isNewVideo = false - if (videoInfoToUpdate.privacy !== undefined) { - isNewVideo = videoInstance.isNewVideo(videoInfoToUpdate.privacy) - - const newPrivacy = parseInt(videoInfoToUpdate.privacy.toString(), 10) - videoInstance.setPrivacy(newPrivacy) - - // Unfederate the video if the new privacy is not compatible with federation - if (hadPrivacyForFederation && !videoInstance.hasPrivacyForFederation()) { - await VideoModel.sendDelete(videoInstance, { transaction: t }) - } - } - - const videoInstanceUpdated = await videoInstance.save(sequelizeOptions) as MVideoFullLight - - if (thumbnailModel) await videoInstanceUpdated.addAndSaveThumbnail(thumbnailModel, t) - if (previewModel) await videoInstanceUpdated.addAndSaveThumbnail(previewModel, t) - - // Video tags update? - if (videoInfoToUpdate.tags !== undefined) { - const tagInstances = await TagModel.findOrCreateTags(videoInfoToUpdate.tags, t) - - await videoInstanceUpdated.$set('Tags', tagInstances, sequelizeOptions) - videoInstanceUpdated.Tags = tagInstances - } - - // Video channel update? - if (res.locals.videoChannel && videoInstanceUpdated.channelId !== res.locals.videoChannel.id) { - await videoInstanceUpdated.$set('VideoChannel', res.locals.videoChannel, { transaction: t }) - videoInstanceUpdated.VideoChannel = res.locals.videoChannel - - if (hadPrivacyForFederation === true) await changeVideoChannelShare(videoInstanceUpdated, oldVideoChannel, t) - } - - // Schedule an update in the future? - if (videoInfoToUpdate.scheduleUpdate) { - await ScheduleVideoUpdateModel.upsert({ - videoId: videoInstanceUpdated.id, - updateAt: videoInfoToUpdate.scheduleUpdate.updateAt, - privacy: videoInfoToUpdate.scheduleUpdate.privacy || null - }, { transaction: t }) - } else if (videoInfoToUpdate.scheduleUpdate === null) { - await ScheduleVideoUpdateModel.deleteByVideoId(videoInstanceUpdated.id, t) - } - - await autoBlacklistVideoIfNeeded({ - video: videoInstanceUpdated, - user: res.locals.oauth.token.User, - isRemote: false, - isNew: false, - transaction: t - }) - - await federateVideoIfNeeded(videoInstanceUpdated, isNewVideo, t) - - auditLogger.update( - getAuditIdFromRes(res), - new VideoAuditView(videoInstanceUpdated.toFormattedDetailsJSON()), - oldVideoAuditView - ) - logger.info('Video with name %s and uuid %s updated.', videoInstance.name, videoInstance.uuid) - - return videoInstanceUpdated - }) - - if (wasConfidentialVideo) { - Notifier.Instance.notifyOnNewVideoIfNeeded(videoInstanceUpdated) - } - - Hooks.runAction('action:api.video.updated', { video: videoInstanceUpdated }) - } catch (err) { - // Force fields we want to update - // If the transaction is retried, sequelize will think the object has not changed - // So it will skip the SQL request, even if the last one was ROLLBACKed! - resetSequelizeInstance(videoInstance, videoFieldsSave) - - throw err - } - - return res.type('json').status(204).end() -} - -async function getVideo (req: express.Request, res: express.Response) { - // We need more attributes - const userId: number = res.locals.oauth ? res.locals.oauth.token.User.id : null - - const video = await Hooks.wrapPromiseFun( - VideoModel.loadForGetAPI, - { id: res.locals.onlyVideoWithRights.id, userId }, - 'filter:api.video.get.result' - ) +function getVideo (_req: express.Request, res: express.Response) { + const video = res.locals.videoAPI if (video.isOutdated()) { JobQueue.Instance.createJob({ type: 'activitypub-refresher', payload: { type: 'video', url: video.url } }) @@ -458,57 +149,45 @@ async function getVideo (req: express.Request, res: express.Response) { } async function viewVideo (req: express.Request, res: express.Response) { - const videoInstance = res.locals.onlyImmutableVideo + const video = res.locals.onlyVideo const ip = req.ip - const exists = await Redis.Instance.doesVideoIPViewExist(ip, videoInstance.uuid) - if (exists) { - logger.debug('View for ip %s and video %s already exists.', ip, videoInstance.uuid) - return res.status(204).end() - } + const success = await VideoViews.Instance.processView({ video, ip }) - await Promise.all([ - Redis.Instance.addVideoView(videoInstance.id), - Redis.Instance.setIPVideoView(ip, videoInstance.uuid) - ]) + if (success) { + const serverActor = await getServerActor() + await sendView(serverActor, video, undefined) - const serverActor = await getServerActor() - await sendView(serverActor, videoInstance, undefined) - - Hooks.runAction('action:api.video.viewed', { video: videoInstance, ip }) + Hooks.runAction('action:api.video.viewed', { video: video, ip, req, res }) + } - return res.status(204).end() + return res.status(HttpStatusCode.NO_CONTENT_204).end() } async function getVideoDescription (req: express.Request, res: express.Response) { const videoInstance = res.locals.videoAll - let description = '' - if (videoInstance.isOwned()) { - description = videoInstance.description - } else { - description = await fetchRemoteVideoDescription(videoInstance) - } + const description = videoInstance.isOwned() + ? videoInstance.description + : await fetchRemoteVideoDescription(videoInstance) return res.json({ description }) } async function listVideos (req: express.Request, res: express.Response) { + const serverActor = await getServerActor() + + const query = pickCommonVideoQuery(req.query) const countVideos = getCountVideos(req) const apiOptions = await Hooks.wrapObject({ - start: req.query.start, - count: req.query.count, - sort: req.query.sort, - includeLocalVideos: true, - categoryOneOf: req.query.categoryOneOf, - licenceOneOf: req.query.licenceOneOf, - languageOneOf: req.query.languageOneOf, - tagsOneOf: req.query.tagsOneOf, - tagsAllOf: req.query.tagsAllOf, - nsfw: buildNSFWFilter(res, req.query.nsfw), - filter: req.query.filter as VideoFilter, - withFiles: false, + ...query, + + displayOnlyForFollower: { + actorId: serverActor.id, + orLocalVideos: true + }, + nsfw: buildNSFWFilter(res, query.nsfw), user: res.locals.oauth ? res.locals.oauth.token.User : undefined, countVideos }, 'filter:api.videos.list.params') @@ -519,7 +198,7 @@ async function listVideos (req: express.Request, res: express.Response) { 'filter:api.videos.list.result' ) - return res.json(getFormattedObjects(resultList.data, resultList.total)) + return res.json(getFormattedObjects(resultList.data, resultList.total, guessAdditionalAttributesFromQuery(query))) } async function removeVideo (req: express.Request, res: express.Response) { @@ -532,7 +211,21 @@ async function removeVideo (req: express.Request, res: express.Response) { auditLogger.delete(getAuditIdFromRes(res), new VideoAuditView(videoInstance.toFormattedDetailsJSON())) logger.info('Video with name %s and uuid %s deleted.', videoInstance.name, videoInstance.uuid) - Hooks.runAction('action:api.video.deleted', { video: videoInstance }) + Hooks.runAction('action:api.video.deleted', { video: videoInstance, req, res }) + + return res.type('json') + .status(HttpStatusCode.NO_CONTENT_204) + .end() +} + +// --------------------------------------------------------------------------- + +// FIXME: Should not exist, we rely on specific API +async function fetchRemoteVideoDescription (video: MVideoAccountLight) { + const host = video.VideoChannel.Account.Actor.Server.host + const path = video.getDescriptionAPIPath() + const url = REMOTE_SCHEME.HTTP + '://' + host + path - return res.type('json').status(204).end() + const { body } = await doJSONRequest(url) + return body.description || '' }