Files
speckle-server/packages/server/modules/serverinvites/services/operations.ts
T
Kristaps Fabians Geikins 43e7ec89ea chore(server): auth IoC 14 - localStrategyBuilderFactory (#3036)
* chore(server): auth IoC 3 - getAllAppsCreatedByUserFactory

* minor fix

* chore(server): auth IoC 4 - getAllAppsAuthorizedByUserFactory

* chore(server): auth IoC 5 - createAppFactory

* chore(server): auth IoC 6 - updateAppFactory

* chore(server): auth IoC 7 - deleteAppFactory

* chore(server): auth IoC 8 - revokeExistingAppCredentialsForUserFactory

* chore(server): auth IoC 9 - revokeRefreshTokenFactory

* chore(server): auth IoC 10 - createAuthorizationCodeFactory

* chore(server): auth IoC 11 - createAppTokenFromAccessCodeFactory

* chore(server): auth IoC 12 - refreshAppTokenFactory

* chore(server): auth IoC 13 - index repo

* chore(server): auth IoC 14 - localStrategyBuilderFactory

---------

Co-authored-by: Gergő Jedlicska <gergo@jedlicska.com>
2024-09-19 11:02:43 +02:00

112 lines
3.8 KiB
TypeScript

import { TokenResourceIdentifier } from '@/modules/core/domain/tokens/types'
import { ServerInfo } from '@/modules/core/helpers/types'
import { UserWithOptionalRole } from '@/modules/core/repositories/users'
import { EmailTemplateParams } from '@/modules/emails/services/emailRendering'
import { CreateInviteParams } from '@/modules/serverinvites/domain/operations'
import {
InviteResourceTarget,
InviteResourceTargetType,
PrimaryInviteResourceTarget,
ServerInviteRecord
} from '@/modules/serverinvites/domain/types'
import { ResolvedTargetData } from '@/modules/serverinvites/helpers/core'
import { ServerInviteResourceFilter } from '@/modules/serverinvites/repositories/serverInvites'
import { MaybeAsync, MaybeNullOrUndefined } from '@speckle/shared'
export type InviteResult = {
inviteId: string
token: string
}
export type CreateAndSendInvite = (
params: CreateInviteParams,
inviterResourceAccessLimits: MaybeNullOrUndefined<TokenResourceIdentifier[]>
) => Promise<InviteResult>
export type FinalizeInvite = (params: {
finalizerUserId: string
finalizerResourceAccessLimits: MaybeNullOrUndefined<TokenResourceIdentifier[]>
accept: boolean
token: string
resourceType?: InviteResourceTargetType
/**
* If true, finalization also allows accepting an invite that technically belongs to a different
* email, one that is not yet attached to any user account.
* If the invite is accepted, the email will be attached to the user account as well in a verified state.
*/
allowAttachingNewEmail?: boolean
}) => Promise<void>
export type ResendInviteEmail = (params: {
inviteId: string
resourceFilter?: ServerInviteResourceFilter
}) => Promise<void>
export type CollectAndValidateResourceTargets = (params: {
input: CreateInviteParams
inviter: UserWithOptionalRole
inviterResourceAccessLimits: MaybeNullOrUndefined<TokenResourceIdentifier[]>
target: ResolvedTargetData
targetUser: MaybeNullOrUndefined<UserWithOptionalRole>
serverInfo: ServerInfo
/**
* Primarily these functions are used to validate on invite creation, but they also get ran on invite finalization.
* In those circumstances this flag will be set.
*/
finalizingInvite?: boolean
}) => MaybeAsync<Array<InviteResourceTarget | PrimaryInviteResourceTarget>>
export type BuildInviteEmailContents = (params: {
invite: ServerInviteRecord
serverInfo: ServerInfo
inviter: UserWithOptionalRole
}) => MaybeAsync<{
emailParams: EmailTemplateParams
subject: string
}>
export enum InviteFinalizationAction {
ACCEPT = 'accept',
DECLINE = 'decline',
/**
* Cancel differs from decline in the way that only the resource owner can cancel the invite,
* invite target can only decline
*/
CANCEL = 'cancel'
}
/**
* This function should throw if there's validation issue
*/
export type ValidateResourceInviteBeforeFinalization = (params: {
invite: ServerInviteRecord
finalizerUserId: string
finalizerResourceAccessLimits: MaybeNullOrUndefined<TokenResourceIdentifier[]>
action: InviteFinalizationAction
}) => MaybeAsync<void>
/**
* Actually handle the invite being accepted or declined. The actual invite record
* is already deleted by this point and doesn't require handling.
*/
export type ProcessFinalizedResourceInvite = (params: {
invite: ServerInviteRecord
finalizerUserId: string
action: InviteFinalizationAction.ACCEPT | InviteFinalizationAction.DECLINE
}) => MaybeAsync<void>
export type GetInvitationTargetUsers = (params: {
invites: ServerInviteRecord[]
}) => Promise<{ [key: string]: UserWithOptionalRole }>
export type ValidateServerInvite = (
email?: string,
token?: string
) => Promise<ServerInviteRecord>
export type FinalizeInvitedServerRegistration = (
email: string,
userId: string
) => Promise<void>
export type ResolveAuthRedirectPath = (invite?: ServerInviteRecord) => string