budibase/packages/worker/src/utilities/redis.ts

154 lines
4.9 KiB
TypeScript
Raw Normal View History

2022-11-16 19:13:34 +01:00
import { redis, utils } from "@budibase/backend-core"
2022-11-16 19:13:34 +01:00
function getExpirySecondsForDB(db: string) {
switch (db) {
2022-11-16 19:13:34 +01:00
case redis.utils.Databases.PW_RESETS:
// a hour
return 3600
2022-11-16 19:13:34 +01:00
case redis.utils.Databases.INVITATIONS:
// a day
return 604800
}
}
2022-11-16 19:13:34 +01:00
let pwResetClient: any, invitationClient: any
2022-11-16 19:13:34 +01:00
function getClient(db: string) {
switch (db) {
2022-11-16 19:13:34 +01:00
case redis.utils.Databases.PW_RESETS:
return pwResetClient
2022-11-16 19:13:34 +01:00
case redis.utils.Databases.INVITATIONS:
return invitationClient
}
}
2022-11-16 19:13:34 +01:00
async function writeACode(db: string, value: any) {
const client = await getClient(db)
2022-11-16 19:13:34 +01:00
const code = utils.newid()
await client.store(code, value, getExpirySecondsForDB(db))
return code
}
2023-02-23 11:38:03 +01:00
async function updateACode(db: string, code: string, value: any) {
const client = await getClient(db)
await client.store(code, value, getExpirySecondsForDB(db))
}
/**
* Given an invite code and invite body, allow the update an existing/valid invite in redis
* @param {string} inviteCode The invite code for an invite in redis
* @param {object} value The body of the updated user invitation
*/
export async function updateInviteCode(inviteCode: string, value: string) {
await updateACode(redis.utils.Databases.INVITATIONS, inviteCode, value)
}
2022-11-16 19:13:34 +01:00
async function getACode(db: string, code: string, deleteCode = true) {
const client = await getClient(db)
const value = await client.get(code)
if (!value) {
throw "Invalid code."
}
if (deleteCode) {
await client.delete(code)
}
return value
}
2022-11-16 19:13:34 +01:00
export async function init() {
pwResetClient = new redis.Client(redis.utils.Databases.PW_RESETS)
invitationClient = new redis.Client(redis.utils.Databases.INVITATIONS)
await pwResetClient.init()
await invitationClient.init()
}
/**
* make sure redis connection is closed.
*/
2022-11-16 19:13:34 +01:00
export async function shutdown() {
2021-05-28 11:09:32 +02:00
if (pwResetClient) await pwResetClient.finish()
if (invitationClient) await invitationClient.finish()
// shutdown core clients
await redis.clients.shutdown()
console.log("Redis shutdown")
}
/**
* Given a user ID this will store a code (that is returned) for an hour in redis.
* The user can then return this code for resetting their password (through their reset link).
* @param {string} userId the ID of the user which is to be reset.
* @param {object} info Info about the user/the reset process.
* @return {Promise<string>} returns the code that was stored to redis.
*/
2022-11-16 19:13:34 +01:00
export async function getResetPasswordCode(userId: string, info: any) {
return writeACode(redis.utils.Databases.PW_RESETS, { userId, info })
}
/**
* Given a reset code this will lookup to redis, check if the code is valid and delete if required.
* @param {string} resetCode The code provided via the email link.
* @param {boolean} deleteCode If the code is used/finished with this will delete it - defaults to true.
* @return {Promise<string>} returns the user ID if it is found
*/
2022-11-16 19:13:34 +01:00
export async function checkResetPasswordCode(
resetCode: string,
deleteCode = true
) {
try {
2022-11-16 19:13:34 +01:00
return getACode(redis.utils.Databases.PW_RESETS, resetCode, deleteCode)
} catch (err) {
throw "Provided information is not valid, cannot reset password - please try again."
}
}
/**
* Generates an invitation code and writes it to redis - which can later be checked for user creation.
* @param {string} email the email address which the code is being sent to (for use later).
* @param {object|null} info Information to be carried along with the invitation.
* @return {Promise<string>} returns the code that was stored to redis.
*/
2022-11-16 19:13:34 +01:00
export async function getInviteCode(email: string, info: any) {
return writeACode(redis.utils.Databases.INVITATIONS, { email, info })
2021-05-05 13:11:31 +02:00
}
/**
* Checks that the provided invite code is valid - will return the email address of user that was invited.
* @param {string} inviteCode the invite code that was provided as part of the link.
* @param {boolean} deleteCode whether or not the code should be deleted after retrieval - defaults to true.
* @return {Promise<object>} If the code is valid then an email address will be returned.
*/
2022-11-16 19:13:34 +01:00
export async function checkInviteCode(
inviteCode: string,
deleteCode: boolean = true
) {
try {
2022-11-16 19:13:34 +01:00
return getACode(redis.utils.Databases.INVITATIONS, inviteCode, deleteCode)
} catch (err) {
throw "Invitation is not valid or has expired, please request a new one."
}
}
2023-02-23 11:38:03 +01:00
/**
Get all currently available user invitations.
2023-02-28 10:37:03 +01:00
@return {Object[]} A list of all objects containing invite metadata
2023-02-23 11:38:03 +01:00
**/
2023-02-28 10:37:03 +01:00
export async function getInviteCodes(tenantIds?: string[]) {
2023-02-23 11:38:03 +01:00
const client = await getClient(redis.utils.Databases.INVITATIONS)
const invites: any[] = await client.scan()
const results = invites.map(invite => {
return {
...invite.value,
code: invite.key,
}
})
return results.reduce((acc, invite) => {
if (tenantIds?.length && tenantIds.includes(invite.info.tenantId)) {
acc.push(invite)
} else {
acc.push(invite)
}
return acc
}, [])
}