A free and open source instant messaging and VoIP chat app built for friends, groups, and communities.
feat(api): let unclaimed accounts claim an email address
Hampusf5f4e8813e2c
diff --git a/fluxer_api/src/api/rate_limit_configs/UserRateLimitConfig.ts b/fluxer_api/src/api/rate_limit_configs/UserRateLimitConfig.tsindex 64b36d392..dc7a7e655 100644--- a/fluxer_api/src/api/rate_limit_configs/UserRateLimitConfig.ts+++ b/fluxer_api/src/api/rate_limit_configs/UserRateLimitConfig.ts@@ -256,4 +256,20 @@ export const UserRateLimitConfigs = {bucket: 'user:entrance_sound:mutate',config: {limit: 20, windowMs: ms('1 minute')},} as RouteRateLimitConfig,+ USER_DATE_OF_BIRTH: {+ bucket: 'user:date_of_birth',+ config: {limit: 5, windowMs: ms('1 hour')},+ } as RouteRateLimitConfig,+ USER_CLAIM: {+ bucket: 'user:claim',+ config: {limit: 5, windowMs: ms('1 hour')},+ } as RouteRateLimitConfig,+ USER_EMAIL_VERIFICATION: {+ bucket: 'user:email_verification',+ config: {limit: 3, windowMs: ms('15 minutes')},+ } as RouteRateLimitConfig,+ USER_EMAIL_VERIFICATION_CONFIRM: {+ bucket: 'user:email_verification:confirm',+ config: {limit: 10, windowMs: ms('1 minute')},+ } as RouteRateLimitConfig,} as const;diff --git a/fluxer_api/src/api/user/AccountClaim.ts b/fluxer_api/src/api/user/AccountClaim.tsnew file mode 100644index 000000000..1b25de7a2--- /dev/null+++ b/fluxer_api/src/api/user/AccountClaim.ts@@ -0,0 +1,241 @@+// SPDX-License-Identifier: AGPL-3.0-or-later++import type {ApiContext} from '@app/api/ApiContext';+import {+ assertEmailSendAllowed,+ budgetEnvFor,+ chargeAddressLookup,+ recordAddressCodeFailure,+ recordEmailSend,+ requesterNetworkKey,+} from '@app/api/auth/AccountBudgets';+import {generateCode, hashCode, normalizeEmailKey} from '@app/api/auth/AccountCodes';+import {emitCodeSent} from '@app/api/auth/AuthIdentify';+import * as AuthPassword from '@app/api/auth/AuthPassword';+import {assertInstanceAcceptsEmailDomain, assertRegistrationEmailDeliverable} from '@app/api/auth/AuthRegistration';+import {checkEmailCode, storeEmailCode} from '@app/api/auth/EmailCodeStore';+import {confirmEmailOwnership} from '@app/api/auth/EmailOwnership';+import {emailCodesCanBeSent, getEmailCodeAvailability} from '@app/api/auth/services/SudoEmailCode';+import type {UserRow} from '@app/api/database/types/UserTypes';+import {emitActivity} from '@app/api/infrastructure/activity/ActivityEvents';+import {getCachedAccountIdentityMode} from '@app/api/instance/AccountIdentityModeCache';+import {getEffectiveVerificationBasis, getEmailDeliveryState} from '@app/api/instance/AccountsConfigCache';+import type {User} from '@app/api/models/User';+import {getAccountTier, getLocalCredential} from '@app/api/user/AccountTier';+import {mapUserToPrivateResponse} from '@app/api/user/UserMappers';+import {hashPassword} from '@app/api/utils/PasswordUtils';+import {+ ClaimAccountNextSteps,+ type EmailDeliveryState,+ EmailDeliveryStates,+ VerificationBases,+} from '@fluxer/constants/src/AccountConfigConstants';+import {type AccountIdentityMode, AccountIdentityModes} from '@fluxer/constants/src/AccountIdentityConstants';+import {AccountTiers, LocalCredentialKinds} from '@fluxer/constants/src/AccountTierConstants';+import {ValidationErrorCodes} from '@fluxer/constants/src/ValidationErrorCodes';+import {AccountAlreadyClaimedError} from '@fluxer/errors/src/domains/auth/AccountAlreadyClaimedError';+import {EmailCodesUnavailableError} from '@fluxer/errors/src/domains/auth/EmailCodesUnavailableError';+import {InvalidSignInCodeError} from '@fluxer/errors/src/domains/auth/InvalidSignInCodeError';+import {+ PasswordRequiredToClaimError,+ type PasswordRequiredToClaimReason,+ PasswordRequiredToClaimReasons,+} from '@fluxer/errors/src/domains/auth/PasswordRequiredToClaimError';+import {SignInCodeExpiredError} from '@fluxer/errors/src/domains/auth/SignInCodeExpiredError';+import {UseClaimRouteError} from '@fluxer/errors/src/domains/auth/UseClaimRouteError';+import {InputValidationError} from '@fluxer/errors/src/domains/core/InputValidationError';+import type {ClaimAccountResponse, EmailVerificationCodeResponse} from '@fluxer/schema/src/domains/user/AccountSchemas';+import type {UserPrivateResponse} from '@fluxer/schema/src/domains/user/UserResponseSchemas';+import {seconds} from 'itty-time';++const CODE_TTL_SECONDS = seconds('10 minutes');+const RESEND_COOLDOWN_MS = 30_000;+const CODE_SCOPE = 'email_verification';++interface VerificationCodeRecord {+ email: string;+ code_hash: string;+ network: string;+}++function verificationKey(user: User): string {+ return `user:email_verification:${user.id}`;+}++async function dispatchUserUpdate(ctx: ApiContext, user: User): Promise<void> {+ await ctx.services.gateway.dispatchPresence({+ userId: user.id,+ event: 'USER_UPDATE',+ data: mapUserToPrivateResponse(user),+ });+}++async function sendCode(+ ctx: ApiContext,+ params: {user: User; email: string; request: Request; clientIp: string},+): Promise<EmailVerificationCodeResponse> {+ const {user, email, request} = params;+ const network = requesterNetworkKey(params.clientIp);+ const env = budgetEnvFor(ctx.services, request);+ const emailKey = normalizeEmailKey(email);+ const now = Date.now();+ const expiresAt = new Date(now + CODE_TTL_SECONDS * 1000);+ const code = generateCode();+ await storeEmailCode<VerificationCodeRecord>(ctx, {+ key: verificationKey(user),+ record: {email: email.toLowerCase(), code_hash: hashCode(code, CODE_SCOPE), network},+ ttlSeconds: CODE_TTL_SECONDS,+ });+ await ctx.services.email.send('email_verification_code', email, {code, expiresAt}, user.locale);+ await recordEmailSend(env, {emailKey, requester: 'unknown'});+ return codeTimes(now);+}++function codeTimes(now: number): EmailVerificationCodeResponse {+ return {+ code_expires_at: new Date(now + CODE_TTL_SECONDS * 1000).toISOString(),+ resend_available_at: new Date(now + RESEND_COOLDOWN_MS).toISOString(),+ };+}++async function assertCodeSendAllowed(+ ctx: ApiContext,+ params: {email: string; request: Request; clientIp: string},+): Promise<void> {+ await assertEmailSendAllowed(budgetEnvFor(ctx.services, params.request), {+ emailKey: normalizeEmailKey(params.email),+ requester: 'unknown',+ clientIp: params.clientIp,+ });+}++function claimCredentialReason(+ identityMode: AccountIdentityMode,+ deliveryState: EmailDeliveryState,+): PasswordRequiredToClaimReason | null {+ if (identityMode === AccountIdentityModes.USERNAME) return PasswordRequiredToClaimReasons.USERNAME_IDENTITY;+ if (deliveryState !== EmailDeliveryStates.ON) return PasswordRequiredToClaimReasons.EMAIL_DELIVERY_OFF;+ return getEffectiveVerificationBasis() === VerificationBases.LOCAL_CREDENTIAL+ ? PasswordRequiredToClaimReasons.LOCAL_CREDENTIAL_BASIS+ : null;+}++export async function claimAccount(+ ctx: ApiContext,+ params: {user: User; email: string | undefined; password: string | undefined; request: Request; clientIp: string},+): Promise<ClaimAccountResponse> {+ const {user, password, request, clientIp} = params;+ if (getAccountTier(user) !== AccountTiers.UNCLAIMED) throw new AccountAlreadyClaimedError();+ const identityMode = getCachedAccountIdentityMode();+ const deliveryState = getEmailDeliveryState();+ if (!password && getLocalCredential(user) === LocalCredentialKinds.NONE) {+ const reason = claimCredentialReason(identityMode, deliveryState);+ if (reason !== null) throw new PasswordRequiredToClaimError(reason);+ }+ if (password && (await AuthPassword.isPasswordPwned(ctx, password))) {+ throw InputValidationError.fromCode('password', ValidationErrorCodes.PASSWORD_IS_TOO_COMMON);+ }+ const passwordPatch = password+ ? {password_hash: await hashPassword(password), password_last_changed_at: new Date()}+ : {};+ if (identityMode === AccountIdentityModes.USERNAME) {+ return await completeClaim(ctx, {user, patch: passwordPatch, withPassword: password !== undefined});+ }+ const email = params.email;+ if (!email) throw InputValidationError.fromCode('email', ValidationErrorCodes.EMAIL_IS_REQUIRED);+ await assertInstanceAcceptsEmailDomain(email, 'email');+ await assertRegistrationEmailDeliverable(email, ctx.services.emailDnsValidation);+ await assertAddressFree(ctx, {user, email, clientIp, request});+ if (deliveryState !== EmailDeliveryStates.ON) {+ return await completeClaim(ctx, {+ user,+ patch: {email, email_verified: true, email_bounced: false, ...passwordPatch},+ withPassword: password !== undefined,+ });+ }+ await assertCodeSendAllowed(ctx, {email, request, clientIp});+ const updated = await ctx.services.users.patchUpsert(+ user.id,+ {email, email_verified: false, email_bounced: false, ...passwordPatch},+ user.toRow(),+ );+ const delivery = await sendCode(ctx, {user: updated, email, request, clientIp});+ await dispatchUserUpdate(ctx, updated);+ emitClaimed(updated, password !== undefined);+ emitCodeSent(updated.id.toString(), 'claim', email);+ return {next_step: ClaimAccountNextSteps.CONFIRM_EMAIL, user: mapUserToPrivateResponse(updated), ...delivery};+}++async function assertAddressFree(+ ctx: ApiContext,+ params: {user: User; email: string; clientIp: string; request: Request},+): Promise<void> {+ const owner = await ctx.services.users.findByEmail(params.email);+ if (owner === null || owner.id === params.user.id) return;+ await chargeAddressLookup(budgetEnvFor(ctx.services, params.request), {+ clientIp: params.clientIp,+ emailKey: normalizeEmailKey(params.email),+ requester: 'unknown',+ });+ throw InputValidationError.fromCode('email', ValidationErrorCodes.EMAIL_ALREADY_IN_USE);+}++async function completeClaim(+ ctx: ApiContext,+ params: {user: User; patch: Partial<UserRow>; withPassword: boolean},+): Promise<ClaimAccountResponse> {+ const updated = await ctx.services.users.patchUpsert(params.user.id, params.patch, params.user.toRow());+ await dispatchUserUpdate(ctx, updated);+ emitClaimed(updated, params.withPassword);+ return {next_step: ClaimAccountNextSteps.NONE, user: mapUserToPrivateResponse(updated)};+}++function emitClaimed(user: User, withPassword: boolean): void {+ void emitActivity('account_claimed', user.id.toString(), {user_id: user.id.toString(), with_password: withPassword});+}++export async function sendEmailVerificationCode(+ ctx: ApiContext,+ params: {user: User; request: Request; clientIp: string},+): Promise<EmailVerificationCodeResponse> {+ const {user} = params;+ const tier = getAccountTier(user);+ if (tier === AccountTiers.UNCLAIMED || user.email === null) throw new UseClaimRouteError();+ if (!emailCodesCanBeSent(getEmailCodeAvailability(user))) throw new EmailCodesUnavailableError();+ if (tier === AccountTiers.VERIFIED) {+ throw user.emailVerified ? new AccountAlreadyClaimedError() : new EmailCodesUnavailableError();+ }+ await assertCodeSendAllowed(ctx, {email: user.email, request: params.request, clientIp: params.clientIp});+ const result = await sendCode(ctx, {+ user,+ email: user.email,+ request: params.request,+ clientIp: params.clientIp,+ });+ emitCodeSent(user.id.toString(), 'verify', user.email);+ return result;+}++export async function confirmEmailVerification(+ ctx: ApiContext,+ params: {user: User; code: string; request: Request},+): Promise<UserPrivateResponse> {+ const {user, code, request} = params;+ const email = user.email?.toLowerCase() ?? null;+ const check = await checkEmailCode<VerificationCodeRecord>(ctx, {+ key: verificationKey(user),+ code,+ scope: CODE_SCOPE,+ ttlSeconds: CODE_TTL_SECONDS,+ accepts: (record) => email !== null && record.email === email,+ });+ if (check.kind === 'wrong') {+ await recordAddressCodeFailure(budgetEnvFor(ctx.services, request), {+ emailKey: normalizeEmailKey(email!),+ network: check.record.network,+ });+ throw new InvalidSignInCodeError();+ }+ if (check.kind !== 'ok') throw new SignInCodeExpiredError();+ return mapUserToPrivateResponse(await confirmEmailOwnership(ctx, user));+}diff --git a/fluxer_api/src/api/user/controllers/UserAccountController.ts b/fluxer_api/src/api/user/controllers/UserAccountController.tsindex 47b7c9617..ef1495ff2 100644--- a/fluxer_api/src/api/user/controllers/UserAccountController.ts+++ b/fluxer_api/src/api/user/controllers/UserAccountController.ts@@ -2,12 +2,14 @@import {deleteRecoveryKit} from '@app/api/auth/AuthRecoveryKit';import * as AuthSession from '@app/api/auth/AuthSession';+import {userHasMfa} from '@app/api/auth/services/SudoMethods';import {requireSudoMode} from '@app/api/auth/services/SudoVerificationService';import {createGuildID, createUserID} from '@app/api/BrandedTypes';import {Config} from '@app/api/Config';import {viewerFromCtx} from '@app/api/experiment/ChannelThreadsGate';import {RequireEmailAccountIdentity,+ RequireEmailCodesAvailable,RequireUsernameAccountIdentity,} from '@app/api/middleware/AccountIdentityMiddleware';import {DefaultUserOnly, LoginRequired} from '@app/api/middleware/AuthMiddleware';@@ -15,6 +17,10 @@ import {LocalAuthMiddleware} from '@app/api/middleware/LocalAuthMiddleware';import {requireOAuth2ScopeForBearer} from '@app/api/middleware/OAuth2ScopeMiddleware';import {RateLimitMiddleware} from '@app/api/middleware/RateLimitMiddleware';import {OpenAPI} from '@app/api/middleware/ResponseTypeMiddleware';+import {+ assertCredentialsNotSsoManaged,+ SsoManagedCredentialsMiddleware,+} from '@app/api/middleware/SsoManagedCredentialsMiddleware';import {SudoModeMiddleware} from '@app/api/middleware/SudoModeMiddleware';import {RateLimitConfigs} from '@app/api/RateLimitConfig';import type {HonoApp} from '@app/api/types/HonoEnv';@@ -23,6 +29,7 @@ import {gateChannelOverrideFlags, mapUserGuildSettingsForViewer} from '@app/api/import {isSsoUserWithoutPassword} from '@app/api/user/UserHelpers';import {dispatchUserUpdate, mapUserSettingsToResponse, mapUserToPrivateResponse} from '@app/api/user/UserMappers';import {CHANNEL_THREADS_CLIENT_FEATURE} from '@app/api/utils/featureUtils';+import {requireRequestClientIp} from '@app/api/utils/RequestClientIp';import {Validator} from '@app/api/Validator';import {UserFlags} from '@fluxer/constants/src/UserConstants';import {ValidationErrorCodes} from '@fluxer/constants/src/ValidationErrorCodes';@@ -36,6 +43,10 @@ import {TargetIdParam,UserIdParam,} from '@fluxer/schema/src/domains/common/CommonParamSchemas';+import {+ ProfileBadgePreviewRequest,+ ProfileBadgePreviewResponse,+} from '@fluxer/schema/src/domains/user/ProfileBadgeSchemas';import {BulkDeleteSelfMessagesRequest,DeviceIdParam,@@ -110,7 +121,7 @@ export function UserAccountController(app: HonoApp) {async (ctx) => {const userAccountRequestService = ctx.get('userAccountRequestService');return ctx.json(- userAccountRequestService.getCurrentUserResponse({+ await userAccountRequestService.getCurrentUserResponse({authTokenType: ctx.get('authTokenType'),oauthBearerScopes: ctx.get('oauthBearerScopes'),user: ctx.get('user'),@@ -139,6 +150,9 @@ export function UserAccountController(app: HonoApp) {const userAccountRequestService = ctx.get('userAccountRequestService');const user = ctx.get('user');const rawBody: UserUpdateWithVerificationRequest = ctx.req.valid('json');+ if (rawBody.new_password !== undefined || rawBody.email_token !== undefined) {+ await assertCredentialsNotSsoManaged(ctx.get('ssoService'), user);+ }return ctx.json(await userAccountRequestService.updateCurrentUser({ctx,@@ -155,6 +169,8 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,+ RequireEmailCodesAvailable,Validator('json', EmptyBodyRequest),OpenAPI({operationId: 'start_email_change',@@ -178,6 +194,8 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,+ RequireEmailCodesAvailable,Validator('json', EmailChangeTicketRequest),OpenAPI({operationId: 'resend_original_email_confirmation',@@ -202,6 +220,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmailChangeVerifyOriginalRequest),OpenAPI({operationId: 'verify_original_email_address',@@ -226,6 +245,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmailChangeRequestNewRequest),OpenAPI({operationId: 'request_new_email_address',@@ -242,7 +262,14 @@ export function UserAccountController(app: HonoApp) {const body = ctx.req.valid('json');const result = await ctx.get('emailChangeService')- .requestNewEmail(user, body.ticket, body.new_email, body.original_proof, body.new_password);+ .requestNewEmail(+ user,+ body.ticket,+ body.new_email,+ body.original_proof,+ requireRequestClientIp(ctx),+ body.new_password,+ );return ctx.json(result);},);@@ -252,6 +279,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmailChangeTicketRequest),OpenAPI({operationId: 'resend_new_email_confirmation',@@ -266,7 +294,7 @@ export function UserAccountController(app: HonoApp) {async (ctx) => {const user = ctx.get('user');const body = ctx.req.valid('json');- await ctx.get('emailChangeService').resendNew(user, body.ticket);+ await ctx.get('emailChangeService').resendNew(user, body.ticket, requireRequestClientIp(ctx));return ctx.body(null, 204);},);@@ -276,6 +304,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmailChangeVerifyNewRequest),OpenAPI({operationId: 'verify_new_email_address',@@ -302,6 +331,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,SudoModeMiddleware,Validator('json', EmailChangeApplyRequest),OpenAPI({@@ -334,6 +364,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmailChangeBouncedRequestNewRequest),OpenAPI({operationId: 'request_bounced_email_replacement',@@ -348,7 +379,9 @@ export function UserAccountController(app: HonoApp) {async (ctx) => {const user = ctx.get('user');const body = ctx.req.valid('json');- const result = await ctx.get('emailChangeService').requestBouncedNewEmail(user, body.new_email);+ const result = await ctx+ .get('emailChangeService')+ .requestBouncedNewEmail(user, body.new_email, requireRequestClientIp(ctx));return ctx.json(result);},);@@ -358,6 +391,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmailChangeTicketRequest),OpenAPI({operationId: 'resend_bounced_email_replacement_code',@@ -372,7 +406,7 @@ export function UserAccountController(app: HonoApp) {async (ctx) => {const user = ctx.get('user');const body = ctx.req.valid('json');- await ctx.get('emailChangeService').resendBouncedNew(user, body.ticket);+ await ctx.get('emailChangeService').resendBouncedNew(user, body.ticket, requireRequestClientIp(ctx));return ctx.body(null, 204);},);@@ -382,6 +416,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmailChangeBouncedVerifyNewRequest),OpenAPI({operationId: 'verify_bounced_email_replacement',@@ -413,6 +448,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', EmptyBodyRequest),OpenAPI({operationId: 'start_password_change',@@ -436,6 +472,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', PasswordChangeTicketRequest),OpenAPI({operationId: 'resend_password_change_code',@@ -460,6 +497,7 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,Validator('json', PasswordChangeVerifyRequest),OpenAPI({operationId: 'verify_password_change_code',@@ -484,6 +522,8 @@ export function UserAccountController(app: HonoApp) {LoginRequired,DefaultUserOnly,RequireEmailAccountIdentity,+ SsoManagedCredentialsMiddleware,+ SudoModeMiddleware,Validator('json', PasswordChangeCompleteRequest),OpenAPI({operationId: 'complete_password_change',@@ -493,11 +533,12 @@ export function UserAccountController(app: HonoApp) {security: ['bearerToken', 'sessionToken'],tags: ['Users'],description:- 'Completes the password change after email verification. Requires the verification proof and new password. Invalidates all existing sessions and returns the replacement session token.',+ 'Completes the password change after email verification. Requires the verification proof and new password, and sudo mode verification with the second factor when the account has two-factor authentication. Invalidates all existing sessions and returns the replacement session token.',}),async (ctx) => {const user = ctx.get('user');const body = ctx.req.valid('json');+ if (userHasMfa(user)) await requireSudoMode(ctx, user, body);await ctx.get('passwordChangeService').complete(user, body.ticket, body.verification_proof, body.new_password);const apiContext = ctx.get('apiContext');const authSession = ctx.get('authSession');@@ -636,6 +677,33 @@ export function UserAccountController(app: HonoApp) {withMutualFriends: with_mutual_friends,withMutualGuilds: with_mutual_guilds,requestCache: ctx.get('requestCache'),+ requestLocale: ctx.get('requestLocale'),+ }),+ );+ },+ );+ app.post(+ '/users/@me/profile-badges/preview',+ RateLimitMiddleware(RateLimitConfigs.USER_GET_PROFILE),+ LoginRequired,+ DefaultUserOnly,+ Validator('json', ProfileBadgePreviewRequest),+ OpenAPI({+ operationId: 'preview_profile_badges',+ summary: 'Preview profile badges',+ responseSchema: ProfileBadgePreviewResponse,+ statusCode: 200,+ security: ['bearerToken', 'sessionToken'],+ tags: ['Users'],+ description:+ "Returns the current user's profile badges as other people would see them with the given badge settings applied. Settings left out keep their saved values. Nothing is saved. Labels are localized for the current user.",+ }),+ async (ctx) => {+ return ctx.json(+ await ctx.get('userAccountRequestService').previewProfileBadges({+ user: ctx.get('user'),+ settings: ctx.req.valid('json'),+ requestLocale: ctx.get('requestLocale'),}),);},@@ -1225,7 +1293,7 @@ export function UserAccountController(app: HonoApp) {security: ['bearerToken', 'sessionToken'],tags: ['Users'],description:- 'Immediately deletes messages the caller has authored, subject to optional date-range and per-context filters (DMs, group DMs, guilds, with optional guild exclusions; or an inaccessible-only mode for contexts the caller is no longer a member of). Requires sudo mode verification. The deletion runs asynchronously; the caller receives a system DM with totals when it completes.',+ 'Immediately deletes messages the caller has authored, subject to optional date-range and per-context filters (DMs, group DMs, guilds, with optional guild exclusions; or an inaccessible-only mode for contexts the caller is no longer a member of). Requires sudo mode verification. The deletion runs asynchronously. When it completes, the caller gets the totals in a system DM, or by email when the instance has direct messages turned off and sends email.',}),async (ctx) => {const user = ctx.get('user');@@ -1257,13 +1325,13 @@ export function UserAccountController(app: HonoApp) {Validator('json', EmptyBodyRequest),OpenAPI({operationId: 'accept_updated_terms',- summary: 'Accept updated terms of service and privacy policy',+ summary: 'Accept updated terms of service',responseSchema: UserPrivateResponse,statusCode: 200,security: ['bearerToken', 'sessionToken'],tags: ['Users'],description:- 'Records that the user has read and agreed to the current terms of service and privacy policy. Returns the updated private user object.',+ 'Records that the user agreed to the current terms of service and was shown the current privacy policy. Returns the updated private user object.',}),async (ctx) => {const user = ctx.get('user');