glchat/web/src/lib/identity.ts

/** Инициалы для аватара-заглушки: до двух первых букв значимых слов. */
export function initials(name: string): string {
  const parts = name
    .trim()
    .split(/\s+/u)
    .filter((part) => part.length > 0);
  if (parts.length === 0) {
    return '?';
  }
  const first = parts[0] ?? '';
  if (parts.length === 1) {
    return [...first].slice(0, 2).join('').toLocaleUpperCase();
  }
  const second = parts[1] ?? '';
  return `${[...first][0] ?? ''}${[...second][0] ?? ''}`.toLocaleUpperCase();
}

/** Стабильный оттенок для заглушки сервера/пользователя. */
export function hueFromId(id: string): number {
  let hash = 0;
  for (let index = 0; index < id.length; index += 1) {
    hash = (hash * 31 + id.charCodeAt(index)) % 360;
  }
  return hash;
}

/**
 * Ссылка на файл аватара. Файловый сервис отдаётся тем же origin
 * (`/files/{id}`), поэтому отдельный хост не нужен.
 */
export function avatarUrl(fileId: string | undefined): string | null {
  return fileId === undefined || fileId === '' ? null : `/files/${encodeURIComponent(fileId)}`;
}

/**
 * Права приходят с сервера списком имён (`permissions.Names` в Go):
 * например `["VIEW_GUILD", "MANAGE_CHANNELS"]`. Проверяем вхождение имени.
 */
export const PERMISSION_ADMINISTRATOR = 'ADMINISTRATOR';
export const PERMISSION_MANAGE_GUILD = 'MANAGE_GUILD';
export const PERMISSION_MANAGE_CHANNELS = 'MANAGE_CHANNELS';

/** Есть ли у пользователя право с указанным именем. */
export function hasPermission(permissions: readonly string[], name: string): boolean {
  return permissions.includes(name);
}

/** Может ли пользователь управлять сервером (создавать комнаты и т.п.). */
export function canManageGuild(
  permissions: readonly string[],
  ownerId: string,
  userId: string | undefined,
): boolean {
  if (userId !== undefined && userId === ownerId) {
    return true;
  }
  return (
    hasPermission(permissions, PERMISSION_ADMINISTRATOR) ||
    hasPermission(permissions, PERMISSION_MANAGE_GUILD) ||
    hasPermission(permissions, PERMISSION_MANAGE_CHANNELS)
  );
}

/** Человекочитаемая дата/время для списков (сессии, аудит). */
export function formatDateTime(value: string, locale: string): string {
  const date = new Date(value);
  if (Number.isNaN(date.getTime())) {
    return value;
  }
  return new Intl.DateTimeFormat(locale, {
    dateStyle: 'medium',
    timeStyle: 'short',
  }).format(date);
}