Function handleUserChange

server/src/slack/events.ts:206–243

(event: SlackUserChangeEvent)

 * Updates our database with the new profile data
 */
export async function handleUserChange(event: SlackUserChangeEvent): Promise<void> {
  const user = event.user;

  if (!user?.id) {
    logger.warn('user_change event missing user data');
    return;
  }

  logger.debug(
    { userId: user.id, email: user.profile?.email, name: user.profile?.real_name },
    'Slack user profile changed'
  );

  try {
    const email = user.profile?.email || null;
    const displayName = user.profile?.display_name || user.profile?.display_name_normalized || null;
    const realName = user.profile?.real_name || user.real_name || null;

    // Upsert the user into our database with updated profile
    await slackDb.upsertSlackUser({
      slack_user_id: user.id,
      slack_email: email,
      slack_display_name: displayName,
      slack_real_name: realName,
      slack_is_bot: user.is_bot || false,
      slack_is_deleted: user.deleted || false,
      slack_tz_offset: user.tz_offset ?? null,
    });

    // Invalidate caches since user data changed
    invalidateUnifiedUsersCache();
    invalidateMemberContextCache(user.id);

    logger.debug({ userId: user.id }, 'Slack user profile updated');
  } catch (error) {
    logger.error({ error, userId: user.id }, 'Failed to process user_change event');
  }
}

/**
 * Try to auto-map a Slack user to a web user by email