/** * Copyright (c) 2020 Gitpod GmbH. All rights reserved. * Licensed under the GNU Affero General Public License (AGPL). * See License-AGPL.txt in the project root for license information. */ import { AdditionalUserData, GitpodToken, GitpodTokenType, Identity, IdentityLookup, Token, TokenEntry, User, UserEnvVar, } from "@gitpod/gitpod-protocol"; import { OAuthTokenRepository, OAuthUserRepository } from "@jmondi/oauth2-server"; import { Repository } from "typeorm"; import { DBUser } from "./typeorm/entity/db-user"; export type MaybeUser = User | undefined; export const UserDB = Symbol("UserDB"); export interface UserDB extends OAuthUserRepository, OAuthTokenRepository { transaction(code: (db: UserDB) => Promise): Promise; newUser(): Promise; storeUser(newUser: User): Promise; updateUserPartial(partial: PartialUserUpdate): Promise; findUserById(id: string): Promise; findUserByIdentity(identity: IdentityLookup): Promise; findIdentitiesByName(identity: Pick): Promise; /** * Gets the number of users. * * @param excludeBuiltinUsers substract the builtin-users from the count (currently only the user builtin-workspace-prober), true by default */ getUserCount(excludeBuiltinUsers?: boolean): Promise; getUserRepo(): Promise>; /** * stores the given token and marks any existing tokens in that identity deleted. * * @param identity * @param token */ storeSingleToken(identity: Pick, token: Token): Promise; /** * adds the given token to the identity * * @param identity * @param token */ addToken(identity: Pick, token: Token): Promise; /** * Will mark tokens for the given identity as deleted. * * @param identity * @param shouldDelete optional predicate to suppress deletion of certain entries */ deleteTokens(identity: Identity, shouldDelete?: (entry: TokenEntry) => boolean): Promise; /** * Find TokenEntry by id * * @param uid */ findTokenEntryById(uid: string): Promise; /** * Delete TokenEntry by id * * @param uid */ deleteTokenEntryById(uid: string): Promise; /** * Delete expired TokenEntries * * @param date All tokens with an expiry date before (older than) this ISO8601 formatted date are considered expired and will be deleted. */ deleteExpiredTokenEntries(date: string): Promise; /** * Update TokenEntry by id * * @param tokenEntry */ updateTokenEntry(tokenEntry: Partial & Pick): Promise; /** * @param identity * @throws an error when there is more than one token */ findTokenForIdentity(identity: Identity): Promise; /** * * @param identity * @param includeDeleted whether deleted tokens should be returned as well */ findTokensForIdentity(identity: Identity, includeDeleted?: boolean): Promise; /** * returns all users using the same email * * @param email */ findUsersByEmail(email: string): Promise; setEnvVar(envVar: UserEnvVar): Promise; deleteEnvVar(envVar: UserEnvVar): Promise; getEnvVars(userId: string): Promise; findAllUsers( offset: number, limit: number, orderBy: keyof User, orderDir: "ASC" | "DESC", searchTerm?: string, minCreationDate?: Date, maxCreationDate?: Date, excludeBuiltinUsers?: boolean, ): Promise<{ total: number; rows: User[] }>; findUserByName(name: string): Promise; findUserByGitpodToken( tokenHash: string, tokenType?: GitpodTokenType, ): Promise<{ user: User; token: GitpodToken } | undefined>; findGitpodTokensOfUser(userId: string, tokenHash: string): Promise; findAllGitpodTokensOfUser(userId: string): Promise; storeGitpodToken(token: GitpodToken & { user: DBUser }): Promise; deleteGitpodToken(tokenHash: string): Promise; deleteGitpodTokensNamedLike(userId: string, namePattern: string): Promise; } export type PartialUserUpdate = Partial> & Pick; export const BUILTIN_WORKSPACE_PROBE_USER_ID = "builtin-user-workspace-probe-0000000"; export const BUILTIN_WORKSPACE_USER_AGENT_SMITH = "builtin-user-agent-smith-0000000"; export interface OwnerAndRepo { owner: string; repo: string; } export type UserEmailContact = Pick & { primaryEmail: string } & { additionalData?: Pick; };