import { VideoFilter, VideoPrivacy, VideoState } from '@shared/models' import { buildDirectionAndField, createSafeIn } from '@server/models/utils' import { Model } from 'sequelize-typescript' import { MUserAccountId, MUserId } from '@server/types/models' import validator from 'validator' import { exists } from '@server/helpers/custom-validators/misc' export type BuildVideosQueryOptions = { attributes?: string[] serverAccountId: number followerActorId: number includeLocalVideos: boolean count: number start: number sort: string filter?: VideoFilter categoryOneOf?: number[] nsfw?: boolean licenceOneOf?: number[] languageOneOf?: string[] tagsOneOf?: string[] tagsAllOf?: string[] withFiles?: boolean accountId?: number videoChannelId?: number videoPlaylistId?: number trendingAlgorithm?: string // best, hot, or any other algorithm implemented trendingDays?: number user?: MUserAccountId historyOfUser?: MUserId startDate?: string // ISO 8601 endDate?: string // ISO 8601 originallyPublishedStartDate?: string originallyPublishedEndDate?: string durationMin?: number // seconds durationMax?: number // seconds search?: string isCount?: boolean group?: string having?: string } function buildListQuery (model: typeof Model, options: BuildVideosQueryOptions) { const and: string[] = [] const joins: string[] = [] const replacements: any = {} const cte: string[] = [] let attributes: string[] = options.attributes || [ '"video"."id"' ] let group = options.group || '' const having = options.having || '' joins.push( 'INNER JOIN "videoChannel" ON "videoChannel"."id" = "video"."channelId"' + 'INNER JOIN "account" ON "account"."id" = "videoChannel"."accountId"' + 'INNER JOIN "actor" "accountActor" ON "account"."actorId" = "accountActor"."id"' ) and.push('"video"."id" NOT IN (SELECT "videoBlacklist"."videoId" FROM "videoBlacklist")') if (options.serverAccountId) { const blockerIds = [ options.serverAccountId ] if (options.user) blockerIds.push(options.user.Account.id) const inClause = createSafeIn(model, blockerIds) and.push( 'NOT EXISTS (' + ' SELECT 1 FROM "accountBlocklist" ' + ' WHERE "accountBlocklist"."accountId" IN (' + inClause + ') ' + ' AND "accountBlocklist"."targetAccountId" = "account"."id" ' + ')' + 'AND NOT EXISTS (' + ' SELECT 1 FROM "serverBlocklist" WHERE "serverBlocklist"."accountId" IN (' + inClause + ') ' + ' AND "serverBlocklist"."targetServerId" = "accountActor"."serverId"' + ')' ) } // Only list public/published videos if (!options.filter || (options.filter !== 'all-local' && options.filter !== 'all')) { and.push( `("video"."state" = ${VideoState.PUBLISHED} OR ` + `("video"."state" = ${VideoState.TO_TRANSCODE} AND "video"."waitTranscoding" IS false))` ) if (options.user) { and.push( `("video"."privacy" = ${VideoPrivacy.PUBLIC} OR "video"."privacy" = ${VideoPrivacy.INTERNAL})` ) } else { // Or only public videos and.push( `"video"."privacy" = ${VideoPrivacy.PUBLIC}` ) } } if (options.videoPlaylistId) { joins.push( 'INNER JOIN "videoPlaylistElement" "video"."id" = "videoPlaylistElement"."videoId" ' + 'AND "videoPlaylistElement"."videoPlaylistId" = :videoPlaylistId' ) replacements.videoPlaylistId = options.videoPlaylistId } if (options.filter && (options.filter === 'local' || options.filter === 'all-local')) { and.push('"video"."remote" IS FALSE') } if (options.accountId) { and.push('"account"."id" = :accountId') replacements.accountId = options.accountId } if (options.videoChannelId) { and.push('"videoChannel"."id" = :videoChannelId') replacements.videoChannelId = options.videoChannelId } if (options.followerActorId) { let query = '(' + ' EXISTS (' + ' SELECT 1 FROM "videoShare" ' + ' INNER JOIN "actorFollow" "actorFollowShare" ON "actorFollowShare"."targetActorId" = "videoShare"."actorId" ' + ' AND "actorFollowShare"."actorId" = :followerActorId AND "actorFollowShare"."state" = \'accepted\' ' + ' WHERE "videoShare"."videoId" = "video"."id"' + ' )' + ' OR' + ' EXISTS (' + ' SELECT 1 from "actorFollow" ' + ' WHERE "actorFollow"."targetActorId" = "videoChannel"."actorId" AND "actorFollow"."actorId" = :followerActorId ' + ' AND "actorFollow"."state" = \'accepted\'' + ' )' if (options.includeLocalVideos) { query += ' OR "video"."remote" IS FALSE' } query += ')' and.push(query) replacements.followerActorId = options.followerActorId } if (options.withFiles === true) { and.push( '(' + ' EXISTS (SELECT 1 FROM "videoFile" WHERE "videoFile"."videoId" = "video"."id") ' + ' OR EXISTS (' + ' SELECT 1 FROM "videoStreamingPlaylist" ' + ' INNER JOIN "videoFile" ON "videoFile"."videoStreamingPlaylistId" = "videoStreamingPlaylist"."id" ' + ' WHERE "videoStreamingPlaylist"."videoId" = "video"."id"' + ' )' + ')' ) } if (options.tagsOneOf) { const tagsOneOfLower = options.tagsOneOf.map(t => t.toLowerCase()) and.push( 'EXISTS (' + ' SELECT 1 FROM "videoTag" ' + ' INNER JOIN "tag" ON "tag"."id" = "videoTag"."tagId" ' + ' WHERE lower("tag"."name") IN (' + createSafeIn(model, tagsOneOfLower) + ') ' + ' AND "video"."id" = "videoTag"."videoId"' + ')' ) } if (options.tagsAllOf) { const tagsAllOfLower = options.tagsAllOf.map(t => t.toLowerCase()) and.push( 'EXISTS (' + ' SELECT 1 FROM "videoTag" ' + ' INNER JOIN "tag" ON "tag"."id" = "videoTag"."tagId" ' + ' WHERE lower("tag"."name") IN (' + createSafeIn(model, tagsAllOfLower) + ') ' + ' AND "video"."id" = "videoTag"."videoId" ' + ' GROUP BY "videoTag"."videoId" HAVING COUNT(*) = ' + tagsAllOfLower.length + ')' ) } if (options.nsfw === true) { and.push('"video"."nsfw" IS TRUE') } if (options.nsfw === false) { and.push('"video"."nsfw" IS FALSE') } if (options.categoryOneOf) { and.push('"video"."category" IN (:categoryOneOf)') replacements.categoryOneOf = options.categoryOneOf } if (options.licenceOneOf) { and.push('"video"."licence" IN (:licenceOneOf)') replacements.licenceOneOf = options.licenceOneOf } if (options.languageOneOf) { const languages = options.languageOneOf.filter(l => l && l !== '_unknown') const languagesQueryParts: string[] = [] if (languages.length !== 0) { languagesQueryParts.push('"video"."language" IN (:languageOneOf)') replacements.languageOneOf = languages languagesQueryParts.push( 'EXISTS (' + ' SELECT 1 FROM "videoCaption" WHERE "videoCaption"."language" ' + ' IN (' + createSafeIn(model, languages) + ') AND ' + ' "videoCaption"."videoId" = "video"."id"' + ')' ) } if (options.languageOneOf.includes('_unknown')) { languagesQueryParts.push('"video"."language" IS NULL') } if (languagesQueryParts.length !== 0) { and.push('(' + languagesQueryParts.join(' OR ') + ')') } } // We don't exclude results in this so if we do a count we don't need to add this complex clause if (options.isCount !== true) { if (options.trendingDays) { const viewsGteDate = new Date(new Date().getTime() - (24 * 3600 * 1000) * options.trendingDays) joins.push('LEFT JOIN "videoView" ON "video"."id" = "videoView"."videoId" AND "videoView"."startDate" >= :viewsGteDate') replacements.viewsGteDate = viewsGteDate attributes.push('COALESCE(SUM("videoView"."views"), 0) AS "score"') group = 'GROUP BY "video"."id"' } else if ([ 'best', 'hot' ].includes(options.trendingAlgorithm)) { /** * "Hotness" is a measure based on absolute view/comment/like/dislike numbers, * with fixed weights only applied to their log values. * * This algorithm gives little chance for an old video to have a good score, * for which recent spikes in interactions could be a sign of "hotness" and * justify a better score. However there are multiple ways to achieve that * goal, which is left for later. Yes, this is a TODO :) * * notes: * - weights and base score are in number of half-days. * - all comments are counted, regardless of being written by the video author or not * see https://github.com/reddit-archive/reddit/blob/master/r2/r2/lib/db/_sorts.pyx#L47-L58 */ const weights = { like: 3, dislike: -3, view: 1 / 12, comment: 2, // a comment takes more time than a like to do, but can be done multiple times history: -2 } joins.push('LEFT JOIN "videoComment" ON "video"."id" = "videoComment"."videoId"') let attribute = `LOG(GREATEST(1, "video"."likes" - 1)) * ${weights.like} ` + // likes (+) `+ LOG(GREATEST(1, "video"."dislikes" - 1)) * ${weights.dislike} ` + // dislikes (-) `+ LOG("video"."views" + 1) * ${weights.view} ` + // views (+) `+ LOG(GREATEST(1, COUNT(DISTINCT "videoComment"."id"))) * ${weights.comment} ` + // comments (+) '+ (SELECT EXTRACT(epoch FROM "video"."publishedAt") / 47000) ' // base score (in number of half-days) if (options.trendingAlgorithm === 'best' && options.user) { joins.push( 'LEFT JOIN "userVideoHistory" ON "video"."id" = "userVideoHistory"."videoId" AND "userVideoHistory"."userId" = :bestUser' ) replacements.bestUser = options.user.id attribute += `+ POWER(COUNT(DISTINCT "userVideoHistory"."id"), 2.0) * ${weights.history} ` } attribute += 'AS "score"' attributes.push(attribute) group = 'GROUP BY "video"."id"' } } if (options.historyOfUser) { joins.push('INNER JOIN "userVideoHistory" ON "video"."id" = "userVideoHistory"."videoId"') and.push('"userVideoHistory"."userId" = :historyOfUser') replacements.historyOfUser = options.historyOfUser.id } if (options.startDate) { and.push('"video"."publishedAt" >= :startDate') replacements.startDate = options.startDate } if (options.endDate) { and.push('"video"."publishedAt" <= :endDate') replacements.endDate = options.endDate } if (options.originallyPublishedStartDate) { and.push('"video"."originallyPublishedAt" >= :originallyPublishedStartDate') replacements.originallyPublishedStartDate = options.originallyPublishedStartDate } if (options.originallyPublishedEndDate) { and.push('"video"."originallyPublishedAt" <= :originallyPublishedEndDate') replacements.originallyPublishedEndDate = options.originallyPublishedEndDate } if (options.durationMin) { and.push('"video"."duration" >= :durationMin') replacements.durationMin = options.durationMin } if (options.durationMax) { and.push('"video"."duration" <= :durationMax') replacements.durationMax = options.durationMax } if (options.search) { const escapedSearch = model.sequelize.escape(options.search) const escapedLikeSearch = model.sequelize.escape('%' + options.search + '%') cte.push( '"trigramSearch" AS (' + ' SELECT "video"."id", ' + ` similarity(lower(immutable_unaccent("video"."name")), lower(immutable_unaccent(${escapedSearch}))) as similarity ` + ' FROM "video" ' + ' WHERE lower(immutable_unaccent("video"."name")) % lower(immutable_unaccent(' + escapedSearch + ')) OR ' + ' lower(immutable_unaccent("video"."name")) LIKE lower(immutable_unaccent(' + escapedLikeSearch + '))' + ')' ) joins.push('LEFT JOIN "trigramSearch" ON "video"."id" = "trigramSearch"."id"') let base = '(' + ' "trigramSearch"."id" IS NOT NULL OR ' + ' EXISTS (' + ' SELECT 1 FROM "videoTag" ' + ' INNER JOIN "tag" ON "tag"."id" = "videoTag"."tagId" ' + ` WHERE lower("tag"."name") = ${escapedSearch} ` + ' AND "video"."id" = "videoTag"."videoId"' + ' )' if (validator.isUUID(options.search)) { base += ` OR "video"."uuid" = ${escapedSearch}` } base += ')' and.push(base) attributes.push(`COALESCE("trigramSearch"."similarity", 0) as similarity`) } else { attributes.push('0 as similarity') } if (options.isCount === true) attributes = [ 'COUNT(*) as "total"' ] let suffix = '' let order = '' if (options.isCount !== true) { if (exists(options.sort)) { if (options.sort === '-originallyPublishedAt' || options.sort === 'originallyPublishedAt') { attributes.push('COALESCE("video"."originallyPublishedAt", "video"."publishedAt") AS "publishedAtForOrder"') } order = buildOrder(options.sort) suffix += `${order} ` } if (exists(options.count)) { const count = parseInt(options.count + '', 10) suffix += `LIMIT ${count} ` } if (exists(options.start)) { const start = parseInt(options.start + '', 10) suffix += `OFFSET ${start} ` } } const cteString = cte.length !== 0 ? `WITH ${cte.join(', ')} ` : '' const query = cteString + 'SELECT ' + attributes.join(', ') + ' ' + 'FROM "video" ' + joins.join(' ') + ' ' + 'WHERE ' + and.join(' AND ') + ' ' + group + ' ' + having + ' ' + suffix return { query, replacements, order } } function buildOrder (value: string) { const { direction, field } = buildDirectionAndField(value) if (field.match(/^[a-zA-Z."]+$/) === null) throw new Error('Invalid sort column ' + field) if (field.toLowerCase() === 'random') return 'ORDER BY RANDOM()' if ([ 'trending', 'hot', 'best' ].includes(field.toLowerCase())) { // Sort by aggregation return `ORDER BY "score" ${direction}, "video"."views" ${direction}` } let firstSort: string if (field.toLowerCase() === 'match') { // Search firstSort = '"similarity"' } else if (field === 'originallyPublishedAt') { firstSort = '"publishedAtForOrder"' } else if (field.includes('.')) { firstSort = field } else { firstSort = `"video"."${field}"` } return `ORDER BY ${firstSort} ${direction}, "video"."id" ASC` } function wrapForAPIResults (baseQuery: string, replacements: any, options: BuildVideosQueryOptions, order: string) { const attributes = { '"video".*': '', '"VideoChannel"."id"': '"VideoChannel.id"', '"VideoChannel"."name"': '"VideoChannel.name"', '"VideoChannel"."description"': '"VideoChannel.description"', '"VideoChannel"."actorId"': '"VideoChannel.actorId"', '"VideoChannel->Actor"."id"': '"VideoChannel.Actor.id"', '"VideoChannel->Actor"."preferredUsername"': '"VideoChannel.Actor.preferredUsername"', '"VideoChannel->Actor"."url"': '"VideoChannel.Actor.url"', '"VideoChannel->Actor"."serverId"': '"VideoChannel.Actor.serverId"', '"VideoChannel->Actor"."avatarId"': '"VideoChannel.Actor.avatarId"', '"VideoChannel->Account"."id"': '"VideoChannel.Account.id"', '"VideoChannel->Account"."name"': '"VideoChannel.Account.name"', '"VideoChannel->Account->Actor"."id"': '"VideoChannel.Account.Actor.id"', '"VideoChannel->Account->Actor"."preferredUsername"': '"VideoChannel.Account.Actor.preferredUsername"', '"VideoChannel->Account->Actor"."url"': '"VideoChannel.Account.Actor.url"', '"VideoChannel->Account->Actor"."serverId"': '"VideoChannel.Account.Actor.serverId"', '"VideoChannel->Account->Actor"."avatarId"': '"VideoChannel.Account.Actor.avatarId"', '"VideoChannel->Actor->Server"."id"': '"VideoChannel.Actor.Server.id"', '"VideoChannel->Actor->Server"."host"': '"VideoChannel.Actor.Server.host"', '"VideoChannel->Actor->Avatar"."id"': '"VideoChannel.Actor.Avatar.id"', '"VideoChannel->Actor->Avatar"."filename"': '"VideoChannel.Actor.Avatar.filename"', '"VideoChannel->Actor->Avatar"."fileUrl"': '"VideoChannel.Actor.Avatar.fileUrl"', '"VideoChannel->Actor->Avatar"."onDisk"': '"VideoChannel.Actor.Avatar.onDisk"', '"VideoChannel->Actor->Avatar"."createdAt"': '"VideoChannel.Actor.Avatar.createdAt"', '"VideoChannel->Actor->Avatar"."updatedAt"': '"VideoChannel.Actor.Avatar.updatedAt"', '"VideoChannel->Account->Actor->Server"."id"': '"VideoChannel.Account.Actor.Server.id"', '"VideoChannel->Account->Actor->Server"."host"': '"VideoChannel.Account.Actor.Server.host"', '"VideoChannel->Account->Actor->Avatar"."id"': '"VideoChannel.Account.Actor.Avatar.id"', '"VideoChannel->Account->Actor->Avatar"."filename"': '"VideoChannel.Account.Actor.Avatar.filename"', '"VideoChannel->Account->Actor->Avatar"."fileUrl"': '"VideoChannel.Account.Actor.Avatar.fileUrl"', '"VideoChannel->Account->Actor->Avatar"."onDisk"': '"VideoChannel.Account.Actor.Avatar.onDisk"', '"VideoChannel->Account->Actor->Avatar"."createdAt"': '"VideoChannel.Account.Actor.Avatar.createdAt"', '"VideoChannel->Account->Actor->Avatar"."updatedAt"': '"VideoChannel.Account.Actor.Avatar.updatedAt"', '"Thumbnails"."id"': '"Thumbnails.id"', '"Thumbnails"."type"': '"Thumbnails.type"', '"Thumbnails"."filename"': '"Thumbnails.filename"' } const joins = [ 'INNER JOIN "video" ON "tmp"."id" = "video"."id"', 'INNER JOIN "videoChannel" AS "VideoChannel" ON "video"."channelId" = "VideoChannel"."id"', 'INNER JOIN "actor" AS "VideoChannel->Actor" ON "VideoChannel"."actorId" = "VideoChannel->Actor"."id"', 'INNER JOIN "account" AS "VideoChannel->Account" ON "VideoChannel"."accountId" = "VideoChannel->Account"."id"', 'INNER JOIN "actor" AS "VideoChannel->Account->Actor" ON "VideoChannel->Account"."actorId" = "VideoChannel->Account->Actor"."id"', 'LEFT OUTER JOIN "server" AS "VideoChannel->Actor->Server" ON "VideoChannel->Actor"."serverId" = "VideoChannel->Actor->Server"."id"', 'LEFT OUTER JOIN "avatar" AS "VideoChannel->Actor->Avatar" ON "VideoChannel->Actor"."avatarId" = "VideoChannel->Actor->Avatar"."id"', 'LEFT OUTER JOIN "server" AS "VideoChannel->Account->Actor->Server" ' + 'ON "VideoChannel->Account->Actor"."serverId" = "VideoChannel->Account->Actor->Server"."id"', 'LEFT OUTER JOIN "avatar" AS "VideoChannel->Account->Actor->Avatar" ' + 'ON "VideoChannel->Account->Actor"."avatarId" = "VideoChannel->Account->Actor->Avatar"."id"', 'LEFT OUTER JOIN "thumbnail" AS "Thumbnails" ON "video"."id" = "Thumbnails"."videoId"' ] if (options.withFiles) { joins.push('LEFT JOIN "videoFile" AS "VideoFiles" ON "VideoFiles"."videoId" = "video"."id"') joins.push('LEFT JOIN "videoStreamingPlaylist" AS "VideoStreamingPlaylists" ON "VideoStreamingPlaylists"."videoId" = "video"."id"') joins.push( 'LEFT JOIN "videoFile" AS "VideoStreamingPlaylists->VideoFiles" ' + 'ON "VideoStreamingPlaylists->VideoFiles"."videoStreamingPlaylistId" = "VideoStreamingPlaylists"."id"' ) Object.assign(attributes, { '"VideoFiles"."id"': '"VideoFiles.id"', '"VideoFiles"."createdAt"': '"VideoFiles.createdAt"', '"VideoFiles"."updatedAt"': '"VideoFiles.updatedAt"', '"VideoFiles"."resolution"': '"VideoFiles.resolution"', '"VideoFiles"."size"': '"VideoFiles.size"', '"VideoFiles"."extname"': '"VideoFiles.extname"', '"VideoFiles"."filename"': '"VideoFiles.filename"', '"VideoFiles"."fileUrl"': '"VideoFiles.fileUrl"', '"VideoFiles"."torrentFilename"': '"VideoFiles.torrentFilename"', '"VideoFiles"."torrentUrl"': '"VideoFiles.torrentUrl"', '"VideoFiles"."infoHash"': '"VideoFiles.infoHash"', '"VideoFiles"."fps"': '"VideoFiles.fps"', '"VideoFiles"."videoId"': '"VideoFiles.videoId"', '"VideoStreamingPlaylists"."id"': '"VideoStreamingPlaylists.id"', '"VideoStreamingPlaylists"."playlistUrl"': '"VideoStreamingPlaylists.playlistUrl"', '"VideoStreamingPlaylists"."type"': '"VideoStreamingPlaylists.type"', '"VideoStreamingPlaylists->VideoFiles"."id"': '"VideoStreamingPlaylists.VideoFiles.id"', '"VideoStreamingPlaylists->VideoFiles"."createdAt"': '"VideoStreamingPlaylists.VideoFiles.createdAt"', '"VideoStreamingPlaylists->VideoFiles"."updatedAt"': '"VideoStreamingPlaylists.VideoFiles.updatedAt"', '"VideoStreamingPlaylists->VideoFiles"."resolution"': '"VideoStreamingPlaylists.VideoFiles.resolution"', '"VideoStreamingPlaylists->VideoFiles"."size"': '"VideoStreamingPlaylists.VideoFiles.size"', '"VideoStreamingPlaylists->VideoFiles"."extname"': '"VideoStreamingPlaylists.VideoFiles.extname"', '"VideoStreamingPlaylists->VideoFiles"."filename"': '"VideoStreamingPlaylists.VideoFiles.filename"', '"VideoStreamingPlaylists->VideoFiles"."fileUrl"': '"VideoStreamingPlaylists.VideoFiles.fileUrl"', '"VideoStreamingPlaylists->VideoFiles"."torrentFilename"': '"VideoStreamingPlaylists.VideoFiles.torrentFilename"', '"VideoStreamingPlaylists->VideoFiles"."torrentUrl"': '"VideoStreamingPlaylists.VideoFiles.torrentUrl"', '"VideoStreamingPlaylists->VideoFiles"."infoHash"': '"VideoStreamingPlaylists.VideoFiles.infoHash"', '"VideoStreamingPlaylists->VideoFiles"."fps"': '"VideoStreamingPlaylists.VideoFiles.fps"', '"VideoStreamingPlaylists->VideoFiles"."videoStreamingPlaylistId"': '"VideoStreamingPlaylists.VideoFiles.videoStreamingPlaylistId"', '"VideoStreamingPlaylists->VideoFiles"."videoId"': '"VideoStreamingPlaylists.VideoFiles.videoId"' }) } if (options.user) { joins.push( 'LEFT OUTER JOIN "userVideoHistory" ' + 'ON "video"."id" = "userVideoHistory"."videoId" AND "userVideoHistory"."userId" = :userVideoHistoryId' ) replacements.userVideoHistoryId = options.user.id Object.assign(attributes, { '"userVideoHistory"."id"': '"userVideoHistory.id"', '"userVideoHistory"."currentTime"': '"userVideoHistory.currentTime"' }) } if (options.videoPlaylistId) { joins.push( 'INNER JOIN "videoPlaylistElement" as "VideoPlaylistElement" ON "videoPlaylistElement"."videoId" = "video"."id" ' + 'AND "VideoPlaylistElement"."videoPlaylistId" = :videoPlaylistId' ) replacements.videoPlaylistId = options.videoPlaylistId Object.assign(attributes, { '"VideoPlaylistElement"."createdAt"': '"VideoPlaylistElement.createdAt"', '"VideoPlaylistElement"."updatedAt"': '"VideoPlaylistElement.updatedAt"', '"VideoPlaylistElement"."url"': '"VideoPlaylistElement.url"', '"VideoPlaylistElement"."position"': '"VideoPlaylistElement.position"', '"VideoPlaylistElement"."startTimestamp"': '"VideoPlaylistElement.startTimestamp"', '"VideoPlaylistElement"."stopTimestamp"': '"VideoPlaylistElement.stopTimestamp"', '"VideoPlaylistElement"."videoPlaylistId"': '"VideoPlaylistElement.videoPlaylistId"' }) } const select = 'SELECT ' + Object.keys(attributes).map(key => { const value = attributes[key] if (value) return `${key} AS ${value}` return key }).join(', ') return `${select} FROM (${baseQuery}) AS "tmp" ${joins.join(' ')} ${order}` } export { buildListQuery, wrapForAPIResults }