@rynt/sdk 0.9.53

package/src/shared/utils/download-stats-week.ts

@@ -0,0 +1,165 @@
+import type { DownloadDailyStatPoint } from '../api/download-stats';
+
+export type WeekDownloadDay = {
+  date: string;
+  label: string;
+  count: number;
+};
+
+export type WeekDownloadStats = {
+  days: WeekDownloadDay[];
+  weekTotal: number;
+  previousWeekTotal: number;
+  weekDelta: number;
+  weekDeltaPercent: number | null;
+};
+
+function utcDateKey(date: Date): string {
+  return date.toISOString().slice(0, 10);
+}
+
+function addUtcDays(date: Date, days: number): Date {
+  const next = new Date(date);
+  next.setUTCDate(next.getUTCDate() + days);
+  return next;
+}
+
+function normalizeDateKey(raw: string): string {
+  if (/^\d{4}-\d{2}-\d{2}$/.test(raw)) return raw;
+  return utcDateKey(new Date(raw));
+}
+
+function aggregateDownloadPoints(
+  points: DownloadDailyStatPoint[],
+): Map<string, number> {
+  const byDate = new Map<string, number>();
+  for (const point of points) {
+    const dateKey = normalizeDateKey(point.date);
+    const count = Number(point.count) || 0;
+    byDate.set(dateKey, (byDate.get(dateKey) ?? 0) + count);
+  }
+  return byDate;
+}
+
+/** Последние 30 календарных дней UTC включая сегодня. */
+export function getLastMonthUtcRange(): { from: string; to: string } {
+  const today = new Date();
+  const to = utcDateKey(today);
+  const from = utcDateKey(addUtcDays(today, -29));
+  return { from, to };
+}
+
+/**
+ * Диапазон для heatmap в стиле GitHub/GitLab: ~53 недели, начало с понедельника (UTC).
+ */
+export function getHeatmapActivityUtcRange(): { from: string; to: string } {
+  const today = new Date();
+  const to = utcDateKey(today);
+  const weeks = 53;
+  let fromDate = addUtcDays(today, -(weeks * 7 - 1));
+
+  const weekday = fromDate.getUTCDay();
+  const mondayOffset = weekday === 0 ? -6 : 1 - weekday;
+  fromDate = addUtcDays(fromDate, mondayOffset);
+
+  return { from: utcDateKey(fromDate), to };
+}
+
+function formatDayLabel(dateKey: string): string {
+  const date = new Date(`${dateKey}T12:00:00.000Z`);
+  return date.toLocaleDateString('ru-RU', {
+    weekday: 'short',
+    day: 'numeric',
+    month: 'short',
+    timeZone: 'UTC',
+  });
+}
+
+/** Последние 7 календарных дней UTC включая сегодня. */
+export function getLastWeekUtcRange(): { from: string; to: string } {
+  const today = new Date();
+  const to = utcDateKey(today);
+  const from = utcDateKey(addUtcDays(today, -6));
+  return { from, to };
+}
+
+/** Предыдущие 7 дней перед текущей неделей (для сравнения динамики). */
+export function getPreviousWeekUtcRange(): { from: string; to: string } {
+  const today = new Date();
+  const to = utcDateKey(addUtcDays(today, -7));
+  const from = utcDateKey(addUtcDays(today, -13));
+  return { from, to };
+}
+
+function buildDaySeries(
+  from: string,
+  to: string,
+  points: DownloadDailyStatPoint[],
+): WeekDownloadDay[] {
+  const byDate = aggregateDownloadPoints(points);
+  const days: WeekDownloadDay[] = [];
+  let cursor = new Date(`${from}T00:00:00.000Z`);
+  const end = new Date(`${to}T00:00:00.000Z`);
+
+  while (cursor <= end) {
+    const date = utcDateKey(cursor);
+    days.push({
+      date,
+      label: formatDayLabel(date),
+      count: byDate.get(date) ?? 0,
+    });
+    cursor = addUtcDays(cursor, 1);
+  }
+
+  return days;
+}
+
+export function buildDownloadDaySeries(
+  from: string,
+  to: string,
+  points: DownloadDailyStatPoint[],
+): WeekDownloadDay[] {
+  return buildDaySeries(from, to, points);
+}
+
+export function sumDownloadPoints(points: DownloadDailyStatPoint[]): number {
+  let total = 0;
+  for (const count of aggregateDownloadPoints(points).values()) {
+    total += count;
+  }
+  return total;
+}
+
+export function buildWeekDownloadStats(
+  weekPoints: DownloadDailyStatPoint[],
+  previousWeekPoints: DownloadDailyStatPoint[],
+  range = getLastWeekUtcRange(),
+): WeekDownloadStats {
+  const days = buildDaySeries(range.from, range.to, weekPoints);
+  const weekTotal = sumDownloadPoints(weekPoints);
+  const previousWeekTotal = sumDownloadPoints(previousWeekPoints);
+  const weekDelta = weekTotal - previousWeekTotal;
+  const weekDeltaPercent =
+    previousWeekTotal > 0
+      ? Math.round((weekDelta / previousWeekTotal) * 100)
+      : weekTotal > 0
+        ? 100
+        : null;
+
+  return {
+    days,
+    weekTotal,
+    previousWeekTotal,
+    weekDelta,
+    weekDeltaPercent,
+  };
+}
+
+export function formatWeekDynamicsLabel(stats: WeekDownloadStats): string {
+  if (stats.weekDelta === 0) return 'Без изменений';
+  const sign = stats.weekDelta > 0 ? '+' : '';
+  if (stats.weekDeltaPercent == null) {
+    return `${sign}${stats.weekDelta}`;
+  }
+  return `${sign}${stats.weekDelta} (${sign}${stats.weekDeltaPercent}%)`;
+}

package/src/shared/utils/entity-api-to-cache.ts

@@ -0,0 +1,84 @@
+import type { Build } from '../api/builds';
+import type { Map } from '../api/maps';
+import type { EntityBuild, EntityMap, EntityUser } from '../types/entities';
+
+/** Фрагмент автора из GraphQL (id + username). */
+export type EntityAuthorSnippet = Pick<EntityUser, 'id' | 'username'>;
+
+export type BuildCachePayload = Omit<Partial<EntityBuild>, 'author' | 'authorPublic'> &
+  Pick<EntityBuild, 'id' | 'name'> & {
+    author?: EntityAuthorSnippet | null;
+    authorPublic?: EntityAuthorSnippet | null;
+  };
+
+export type MapCachePayload = Omit<Partial<EntityMap>, 'author' | 'authorPublic'> &
+  Pick<EntityMap, 'id' | 'name'> & {
+    author?: EntityAuthorSnippet | null;
+    authorPublic?: EntityAuthorSnippet | null;
+  };
+
+/**
+ * Payload для `buildsCache.merge`: только поля из ответа API, без fallback-значений.
+ */
+export function buildApiToCache(b: Build): BuildCachePayload {
+  const payload: BuildCachePayload = {
+    id: b.id,
+    name: b.name,
+    description: b.description,
+    isPublic: b.isPublic,
+  };
+
+  if (b.image !== undefined) payload.image = b.image;
+  if (b.minecraftVersion !== undefined) payload.minecraftVersion = b.minecraftVersion;
+  if (b.loader !== undefined) payload.loader = b.loader;
+  if (b.downloads !== undefined) payload.downloads = b.downloads;
+  if (b.rating !== undefined) payload.rating = b.rating;
+  if (b.author) payload.author = { id: b.author.id, username: b.author.username };
+
+  return payload;
+}
+
+/**
+ * Payload для `mapsCache.merge`: только поля из ответа API, без fallback-значений.
+ */
+export function mapApiToCache(m: Map): MapCachePayload {
+  const manifest = m.manifest as Record<string, unknown> | undefined;
+  const buildId =
+    (m.buildId || (manifest?.buildId as string) || '').trim() || undefined;
+  const buildName =
+    (m.buildName || (manifest?.buildName as string) || '').trim() || undefined;
+  const minecraftVersion =
+    (m.minecraftVersion || (manifest?.minecraftVersion as string) || '').trim() ||
+    undefined;
+  const mapType =
+    (m.mapType || (manifest?.mapType as Map['mapType']) || 'any') as Map['mapType'];
+
+  const payload: MapCachePayload = {
+    id: m.id,
+    name: m.name,
+    description: m.description,
+    minecraftVersion: minecraftVersion ?? m.minecraftVersion,
+    mapType,
+    version: m.version,
+    sha1: m.sha1,
+    size: m.size,
+    s3Url: m.s3Url,
+    isPublic: m.isPublic,
+    downloads: m.downloads,
+  };
+
+  if (m.image !== undefined) payload.image = m.image;
+  if (buildId) payload.buildId = buildId;
+  if (buildName) payload.buildName = buildName;
+  if (m.manifest !== undefined) payload.manifest = m.manifest;
+  if (m.createdAt !== undefined) payload.createdAt = m.createdAt;
+  if (m.author) payload.author = { id: m.author.id, username: m.author.username };
+
+  return payload;
+}
+
+/** @deprecated Используйте {@link buildApiToCache} */
+export const entityBuildFromApiBuild = buildApiToCache;
+
+/** @deprecated Используйте {@link mapApiToCache} */
+export const entityMapFromApiMap = mapApiToCache;

package/src/shared/utils/entity-build-from-api.ts

@@ -0,0 +1 @@
+export { buildApiToCache, entityBuildFromApiBuild } from './entity-api-to-cache';

package/src/shared/utils/entity-display.ts

@@ -0,0 +1,27 @@
+import type {
+  EntityBuildBase,
+  EntityMapBase,
+  EntityUser,
+} from '../types/entities';
+
+/** Имя автора для UI: authorPublic → author. */
+export function entityAuthorName(
+  entity: {
+    author?: EntityUser | null;
+    authorPublic?: EntityUser | null;
+  },
+): string | null {
+  return entity.authorPublic?.username ?? entity.author?.username ?? null;
+}
+
+export function entityBuildDownloadsForDisplay(
+  build: Pick<EntityBuildBase, 'downloads'>,
+): number {
+  return build.downloads ?? 0;
+}
+
+export function entityMapDownloadsForDisplay(
+  map: Pick<EntityMapBase, 'downloads'>,
+): number {
+  return map.downloads ?? 0;
+}

package/src/shared/utils/entity-map-from-api.ts

@@ -0,0 +1 @@
+export { mapApiToCache, entityMapFromApiMap } from './entity-api-to-cache';

package/src/shared/utils/file-hash.ts

@@ -0,0 +1,65 @@
+/**
+ * Утилиты для работы с хешами файлов
+ */
+
+/**
+ * Вычисляет SHA1 хеш файла в NW.js окружении
+ */
+export async function calculateFileSHA1(filePath: string): Promise<string> {
+  // Проверяем, что мы в NW.js окружении
+  if (typeof window === 'undefined' || !(window as any).nw) {
+    throw new Error('File operations are only available in NW.js environment');
+  }
+
+  const nw = (window as any).nw;
+  const fs = nw.require('fs');
+  const crypto = nw.require('crypto');
+
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha1');
+    const stream = fs.createReadStream(filePath);
+
+    stream.on('data', (data: Buffer) => {
+      hash.update(data);
+    });
+
+    stream.on('end', () => {
+      resolve(hash.digest('hex'));
+    });
+
+    stream.on('error', (error: Error) => {
+      reject(error);
+    });
+  });
+}
+
+/**
+ * Получает размер файла в байтах
+ */
+export function getFileSize(filePath: string): number {
+  if (typeof window === 'undefined' || !(window as any).nw) {
+    throw new Error('File operations are only available in NW.js environment');
+  }
+
+  const nw = (window as any).nw;
+  const fs = nw.require('fs');
+
+  const stats = fs.statSync(filePath);
+  return stats.size;
+}
+
+/**
+ * Читает файл в буфер
+ */
+export function readFileBuffer(filePath: string): Buffer {
+  if (typeof window === 'undefined' || !(window as any).nw) {
+    throw new Error('File operations are only available in NW.js environment');
+  }
+
+  const nw = (window as any).nw;
+  const fs = nw.require('fs');
+
+  return fs.readFileSync(filePath);
+}
+
+

package/src/shared/utils/formatSize.ts

@@ -0,0 +1,5 @@
+export const formatSize = (bytes: number) => {
+    if (bytes < 1024) return `${bytes} B`;
+    if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+};

package/src/shared/utils/formatTime.ts

@@ -0,0 +1,157 @@
+/**
+ * Форматирует timestamp в формат времени HH:mm
+ * @param timestamp - ISO строка или timestamp в миллисекундах
+ * @returns Отформатированная строка (например, "14:30")
+ */
+export function formatTime(timestamp: string | number): string {
+  const date = typeof timestamp === 'string' ? new Date(timestamp) : new Date(timestamp);
+  
+  if (isNaN(date.getTime())) {
+    return '--:--';
+  }
+
+  const hours = date.getHours().toString().padStart(2, '0');
+  const minutes = date.getMinutes().toString().padStart(2, '0');
+  
+  return `${hours}:${minutes}`;
+}
+
+/**
+ * Форматирует timestamp (ISO строка или число) в относительное текстовое представление
+ * @param timestamp - ISO строка или timestamp в миллисекундах
+ * @returns Отформатированная строка (например, "2 часа назад", "5 дней назад")
+ */
+export function formatRelativeTime(timestamp: string | number): string {
+  const now = Date.now();
+  const date = typeof timestamp === 'string' ? new Date(timestamp).getTime() : timestamp;
+  
+  if (isNaN(date)) {
+    return 'Неизвестно';
+  }
+
+  const diff = now - date;
+  const seconds = Math.floor(diff / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  const weeks = Math.floor(days / 7);
+  const months = Math.floor(days / 30);
+  const years = Math.floor(days / 365);
+
+  if (seconds < 60) {
+    return 'только что';
+  } else if (minutes < 60) {
+    return `${minutes} ${getMinutesDeclension(minutes)} назад`;
+  } else if (hours < 24) {
+    return `${hours} ${getHoursDeclension(hours)} назад`;
+  } else if (days < 7) {
+    return `${days} ${getDaysDeclension(days)} назад`;
+  } else if (weeks < 4) {
+    return `${weeks} ${getWeeksDeclension(weeks)} назад`;
+  } else if (months < 12) {
+    return `${months} ${getMonthsDeclension(months)} назад`;
+  } else {
+    return `${years} ${getYearsDeclension(years)} назад`;
+  }
+}
+
+function getMinutesDeclension(count: number): string {
+  if (count % 10 === 1 && count % 100 !== 11) return 'минуту';
+  if ([2, 3, 4].includes(count % 10) && ![12, 13, 14].includes(count % 100)) return 'минуты';
+  return 'минут';
+}
+
+function getHoursDeclension(count: number): string {
+  if (count % 10 === 1 && count % 100 !== 11) return 'час';
+  if ([2, 3, 4].includes(count % 10) && ![12, 13, 14].includes(count % 100)) return 'часа';
+  return 'часов';
+}
+
+function getDaysDeclension(count: number): string {
+  if (count % 10 === 1 && count % 100 !== 11) return 'день';
+  if ([2, 3, 4].includes(count % 10) && ![12, 13, 14].includes(count % 100)) return 'дня';
+  return 'дней';
+}
+
+function getWeeksDeclension(count: number): string {
+  if (count % 10 === 1 && count % 100 !== 11) return 'неделю';
+  if ([2, 3, 4].includes(count % 10) && ![12, 13, 14].includes(count % 100)) return 'недели';
+  return 'недель';
+}
+
+function getMonthsDeclension(count: number): string {
+  if (count % 10 === 1 && count % 100 !== 11) return 'месяц';
+  if ([2, 3, 4].includes(count % 10) && ![12, 13, 14].includes(count % 100)) return 'месяца';
+  return 'месяцев';
+}
+
+function getYearsDeclension(count: number): string {
+  if (count % 10 === 1 && count % 100 !== 11) return 'год';
+  if ([2, 3, 4].includes(count % 10) && ![12, 13, 14].includes(count % 100)) return 'года';
+  return 'лет';
+}
+
+/**
+ * Форматирует дату в человекопонятный формат
+ * @param timestamp - ISO строка или timestamp в миллисекундах
+ * @returns Отформатированная строка (например, "Сегодня", "Вчера", "15 января", "15 января 2024")
+ */
+export function formatDate(timestamp: string | number): string {
+  const date = typeof timestamp === 'string' ? new Date(timestamp) : new Date(timestamp);
+  
+  if (isNaN(date.getTime())) {
+    return '';
+  }
+
+  const now = new Date();
+  const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+  const messageDate = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+  const yesterday = new Date(today);
+  yesterday.setDate(yesterday.getDate() - 1);
+
+  // Сравниваем только даты (без времени)
+  const diffTime = messageDate.getTime() - today.getTime();
+  const diffDays = Math.round(diffTime / (1000 * 60 * 60 * 24));
+
+  if (diffDays === 0) {
+    return 'Сегодня';
+  } else if (diffDays === -1) {
+    return 'Вчера';
+  } else if (diffDays === 1) {
+    return 'Завтра';
+  } else {
+    // Форматируем дату: "15 января" или "15 января 2024" (если не текущий год)
+    const day = date.getDate();
+    const monthNames = [
+      'января', 'февраля', 'марта', 'апреля', 'мая', 'июня',
+      'июля', 'августа', 'сентября', 'октября', 'ноября', 'декабря'
+    ];
+    const month = monthNames[date.getMonth()];
+    const year = date.getFullYear();
+    const currentYear = now.getFullYear();
+
+    if (year === currentYear) {
+      return `${day} ${month}`;
+    } else {
+      return `${day} ${month} ${year}`;
+    }
+  }
+}
+
+/**
+ * Получает дату в формате YYYY-MM-DD для сравнения
+ */
+export function getDateKey(timestamp: string | number): string {
+  const date = typeof timestamp === 'string' ? new Date(timestamp) : new Date(timestamp);
+  
+  if (isNaN(date.getTime())) {
+    return '';
+  }
+
+  const year = date.getFullYear();
+  const month = String(date.getMonth() + 1).padStart(2, '0');
+  const day = String(date.getDate()).padStart(2, '0');
+  
+  return `${year}-${month}-${day}`;
+}
+

package/src/shared/utils/getAccountSkinRender.ts

@@ -0,0 +1,32 @@
+/**
+ * Утилита для получения рендера скина аккаунта
+ */
+
+import { getSkinRender } from './skin-render-cache';
+import type { MinecraftAccount } from '../types/account';
+
+/**
+ * Получить рендер скина для аккаунта
+ * Возвращает file:// URL для использования в img src
+ */
+export async function getAccountSkinRender(account: MinecraftAccount): Promise<string | null> {
+    if (!account.avatar) {
+        return null;
+    }
+
+    // Проверяем, что мы в NW.js окружении
+    if (typeof window === 'undefined' || !(window as any).nw) {
+        return account.avatar;
+    }
+
+    try {
+        // Используем SHA1, если он есть, для более быстрого кеширования
+        const render = await getSkinRender(account.avatar, account.skinSha1 || undefined);
+        return render;
+    } catch (error) {
+        console.error('[Account Skin Render] Failed to get skin render:', error);
+        // В случае ошибки возвращаем оригинальный URL скина
+        return account.avatar;
+    }
+}
+

package/src/shared/utils/index.ts

@@ -0,0 +1,34 @@
+export * from './attachments';
+export * from './app-paths';
+export * from './autostart';
+export * from './build-files';
+export * from './build-manifest-init';
+export * from './cloudinary';
+export * from './cn';
+export * from './download-stats-week';
+export * from './member-join-stats';
+export * from './entity-api-to-cache';
+export * from './entity-build-from-api';
+export * from './entity-display';
+export * from './entity-map-from-api';
+export * from './file-hash';
+export * from './formatSize';
+export * from './formatTime';
+export * from './getAccountSkinRender';
+
+export * from './local-mods';
+export * from './local-settings';
+export * from './platform';
+export * from './rich-content';
+export * from './safeRequest';
+export * from './semver';
+export * from './serverPermissions';
+export * from './skin-render-cache';
+export * from './stripMarkdown';
+export * from './transliterate';
+export * from './updateAccountSkinRender';
+export * from './updater';
+export * from './uploadImage';
+export * from './user-status';
+export * from './play-host-slug';
+