@rynt/sdk 0.9.53

package/src/shared/minecraft-types/build-manifest.ts

@@ -0,0 +1,611 @@
+/**
+ * Build Version Manifest Types
+ * 
+ * Типы для манифеста сборки (version-manifest.json).
+ * Эти типы описывают структуру кастомных сборок с модами, ресурс-паками и метаданными.
+ */
+
+/**
+ * Публичная часть манифеста сборки (корневой version-manifest.json)
+ * Не содержит assetIndex и downloads (они наследуются через inheritsFrom)
+ */
+export interface BuildVersionManifest {
+    id: string;
+    type: string;
+    inheritsFrom?: string;
+    minecraftArguments?: string;
+    /**
+     * Custom build assets that should live inside the version/build directory.
+     */
+    versionAssets: VersionAsset[];
+    arguments?: {
+        game: (string | { rules?: Rule[]; value: string | string[] })[];
+        jvm: (string | { rules?: Rule[]; value: string | string[] })[];
+    };
+    libraries: Library[];
+    javaVersion?: {
+        component: string;
+        majorVersion: number;
+    };
+    minimumLauncherVersion?: number;
+    mainClass?: string; // Опционально, обычно наследуется
+
+    /**
+     * Моды, включенные в сборку
+     */
+    mods: Mod[];
+
+    /**
+     * Ресурс-паки, включенные в сборку
+     */
+    resourcePacks: ResourcePack[];
+
+    /**
+     * Шейдер-паки, включенные в сборку
+     */
+    shaderPacks: ShaderPack[];
+
+    /**
+     * Выбранные файлы для включения в сборку (пути относительно директории сборки)
+     * Используется для whitelist-подхода: только выбранные файлы будут включены в сборку
+     */
+    selectedFiles?: Array<{
+        path: string;
+        skipHash?: boolean;
+    }>;
+
+    /**
+     * Локальные метаданные сборки (не передаются другим пользователям)
+     */
+    _meta: BuildMetadata;
+}
+
+/**
+ * Правило для аргументов (OS-specific, feature-based)
+ */
+export interface Rule {
+    action: 'allow' | 'disallow';
+    os?: {
+        name?: 'windows' | 'osx' | 'linux';
+        version?: string;
+        arch?: string;
+    };
+    features?: {
+        [key: string]: boolean;
+    };
+}
+
+/**
+ * Библиотека Minecraft
+ */
+export interface Library {
+    name: string;
+    downloads?: {
+        artifact?: Download;
+        classifiers?: {
+            [key: string]: Download;
+        };
+    };
+    rules?: Rule[];
+    natives?: {
+        [key: string]: string;
+    };
+    extract?: {
+        exclude: string[];
+    };
+    url?: string;
+}
+
+/**
+ * Информация о загрузке файла
+ */
+export interface Download {
+    sha1: string;
+    size: number;
+    url: string;
+    path?: string;
+}
+
+/**
+ * Custom per-build/per-version file (e.g. configs) stored inside versions/<buildName>/...
+ */
+export interface VersionAsset {
+    /**
+     * Display name (for logs/UI)
+     */
+    name: string;
+    /**
+     * Relative path inside the build directory (e.g. "config/modmenu.json" or "/config/modmenu.json")
+     */
+    path: string;
+    /**
+     * SHA1 hash (required unless skipHashCheck=true)
+     */
+    sha1?: string;
+    /**
+     * URL to download from
+     */
+    url: string;
+    /**
+     * If true and file exists, do not re-check hash and do not overwrite.
+     * Useful for user-editable configs.
+     */
+    skipHashCheck?: boolean;
+}
+
+/**
+ * Источник мода или ресурс-пака
+ */
+export type ModSource = 'curseforge' | 'modrinth' | 'optifine' | 'direct';
+
+/**
+ * Мод в сборке
+ */
+export interface Mod {
+    /**
+     * Источник мода (curseforge, modrinth, direct)
+     */
+    source: ModSource;
+
+    /**
+     * ID мода (внутренний идентификатор)
+     */
+    id: string;
+
+    /**
+     * Display name for UI/logs
+     */
+    name: string;
+
+    /**
+     * Slug проекта (для CurseForge/Modrinth)
+     */
+    projectSlug: string;
+
+    /**
+     * URL изображения мода
+     */
+    image?: string;
+
+    /**
+     * Версия мода
+     */
+    version: string;
+
+    /**
+     * Ограничения совместимости
+     */
+    constraints: ModConstraints;
+
+    /**
+     * Файлы мода
+     */
+    files: ModFile[];
+
+    /**
+     * Зависимости мода
+     */
+    dependencies?: ModDependency[];
+
+    /**
+     * Отключен ли мод (файл имеет расширение .disabled)
+     */
+    disabled?: boolean;
+}
+
+/**
+ * Ограничения совместимости мода
+ */
+export interface ModConstraints {
+    /**
+     * Версия Minecraft
+     */
+    minecraft: string;
+
+    /**
+     * Загрузчик (fabric, quilt, forge, etc.)
+     */
+    loader: string;
+
+    /**
+     * Диапазон версий загрузчика (например, ">=0.14.0")
+     */
+    loaderVersionRange?: string;
+}
+
+/**
+ * Файл мода
+ */
+export interface ModFile {
+    /**
+     * Тип файла (primary, optional, etc.)
+     */
+    type: 'primary' | 'secondary';
+
+    /**
+     * Имя файла
+     */
+    filename: string;
+
+    /**
+     * Relative path inside the instance root (e.g. "mods/<filename>")
+     * Used by runtime to place the file deterministically.
+     */
+    path: string;
+
+    /**
+     * Размер файла в байтах
+     */
+    size: number;
+
+    /**
+     * Хеши файла
+     */
+    hashes: {
+        sha1: string;
+    };
+
+    /**
+     * URLs для скачивания (может быть несколько зеркал)
+     */
+    urls: string[];
+
+    /**
+     * Сторона (client, server, both)
+     */
+    side: 'client' | 'server' | 'both';
+}
+
+/**
+ * Зависимость мода
+ */
+export interface ModDependency {
+    /**
+     * Тип зависимости (required, optional, incompatible, etc.)
+     */
+    type: 'required' | 'incompatible';
+
+    /**
+     * Источник зависимости (для резолва через API)
+     */
+    source: ModSource;
+
+    /**
+     * Provider-specific project ID (для резолва через API)
+     * Modrinth: project_id, CurseForge: modId (number as string)
+     */
+    modId: string;
+
+    /**
+     * Slug проекта (для проверки наличия мода в манифесте)
+     * Используется для проверки, установлен ли мод с таким slug
+     */
+    slug: string;
+
+    /**
+     * Версия зависимости (для проверки совместимости)
+     * Может быть конкретной версией или версионным диапазоном (например, ">=0.83.0")
+     */
+    version: string;
+}
+
+/**
+ * Ресурс-пак в сборке
+ */
+export interface ResourcePack {
+    /**
+     * Источник ресурс-пака (curseforge, modrinth, direct)
+     */
+    source: ModSource;
+
+    /**
+     * ID ресурс-пака (внутренний идентификатор)
+     */
+    id: string;
+
+    /**
+     * Display name for UI/logs
+     */
+    name: string;
+
+    /**
+     * Slug проекта (для CurseForge/Modrinth)
+     */
+    projectSlug: string;
+
+    /**
+     * Версия ресурс-пака
+     */
+    version: string;
+
+    /**
+     * URL изображения ресурс-пака
+     */
+    image?: string;
+
+    /**
+     * Ограничения совместимости (только версия Minecraft для ресурс-паков)
+     */
+    constraints?: {
+        minecraft: string;
+    };
+
+    /**
+     * Файлы ресурс-пака
+     */
+    files: ResourcePackFile[];
+
+    /**
+     * Отключен ли ресурс-пак (файл имеет расширение .disabled)
+     */
+    disabled?: boolean;
+}
+
+/**
+ * Файл ресурс-пака
+ */
+export interface ResourcePackFile {
+    /**
+     * Имя файла
+     */
+    filename: string;
+
+    /**
+     * Relative path inside the instance root (e.g. "resourcepacks/<filename>")
+     */
+    path: string;
+
+    /**
+     * Размер файла в байтах
+     */
+    size: number;
+
+    /**
+     * Хеши файла
+     */
+    hashes: {
+        sha1: string;
+    };
+
+    /**
+     * URLs для скачивания (может быть несколько зеркал)
+     */
+    urls: string[];
+
+    /**
+     * Формат ресурс-пака (версия pack.mcmeta)
+     */
+    format?: number;
+
+    /**
+     * Позиция в списке ресурс-паков (чем выше, тем раньше загружается)
+     */
+    position?: number;
+}
+
+/**
+ * Шейдер-пак в сборке
+ */
+export interface ShaderPack {
+    /**
+     * Источник шейдер-пака (curseforge, modrinth, direct)
+     */
+    source: ModSource;
+
+    /**
+     * ID шейдер-пака (внутренний идентификатор)
+     */
+    id: string;
+
+    /**
+     * Display name for UI/logs
+     */
+    name: string;
+
+    /**
+     * Slug проекта (для CurseForge/Modrinth)
+     */
+    projectSlug: string;
+
+    /**
+     * Версия шейдер-пака
+     */
+    version: string;
+
+    /**
+     * URL изображения шейдер-пака
+     */
+    image?: string;
+
+    /**
+     * Ограничения совместимости (только версия Minecraft для шейдер-паков)
+     */
+    constraints?: {
+        minecraft: string;
+    };
+
+    /**
+     * Файлы шейдер-пака
+     */
+    files: ShaderPackFile[];
+
+    /**
+     * Отключен ли шейдер-пак (файл имеет расширение .disabled)
+     */
+    disabled?: boolean;
+}
+
+/**
+ * Файл шейдер-пака
+ */
+export interface ShaderPackFile {
+    /**
+     * Имя файла
+     */
+    filename: string;
+
+    /**
+     * Relative path inside the instance root (e.g. "shaderpacks/<filename>")
+     */
+    path: string;
+
+    /**
+     * Размер файла в байтах
+     */
+    size: number;
+
+    /**
+     * Хеши файла
+     */
+    hashes: {
+        sha1: string;
+    };
+
+    /**
+     * URLs для скачивания (может быть несколько зеркал)
+     */
+    urls: string[];
+}
+
+/**
+ * Метаданные сборки (локальные, только для UI)
+ * Эти данные не передаются другим пользователям при экспорте/публикации
+ */
+export interface BuildMetadata {
+    /**
+     * Уникальный идентификатор сборки (UUID)
+     */
+    uuid: string;
+
+    /**
+     * Отображаемое имя сборки
+     */
+    name: string;
+
+    /**
+     * Описание сборки
+     */
+    description: string;
+
+    /**
+     * Путь к изображению/иконке сборки
+     */
+    image: string;
+
+    /**
+     * Версия сборки (строка, например "1.0.0")
+     */
+    version?: string;
+
+    /**
+     * Время создания и релиза (локальные метаданные)
+     */
+    releaseTime: string;
+    time: string;
+
+    /**
+     * Настройки запуска (локальные, для автозаполнения)
+     */
+    settings: BuildSettings;
+
+    /**
+     * Статистика использования (локальная)
+     */
+    stats: BuildStats;
+
+    /**
+     * Информация об авторе (для маркетплейса)
+     */
+    author: BuildAuthor;
+
+    /**
+     * Базовый манифест (информация о версии Minecraft и загрузчике)
+     */
+    manifest: BuildManifestInfo;
+
+    /**
+     * Информация о сервере (если сборка была скачана для конкретного сервера)
+     */
+    server?: {
+        /**
+         * ID сервера, для которого была скачана сборка
+         */
+        id: string;
+    };
+}
+
+/**
+ * Настройки запуска сборки
+ */
+export interface BuildSettings {
+    /**
+     * Путь к Java исполняемому файлу
+     */
+    javaPath: string;
+
+    /**
+     * JVM аргументы
+     */
+    jvmArgs: string;
+
+    /**
+     * Максимальный объем RAM в MB
+     */
+    maxRam: number;
+}
+
+/**
+ * Статистика использования сборки
+ */
+export interface BuildStats {
+    /**
+     * Время последнего запуска (ISO 8601)
+     */
+    lastPlayed: string;
+
+    /**
+     * Время игры в секундах
+     */
+    playTime: number;
+}
+
+/**
+ * Информация об авторе сборки
+ */
+export interface BuildAuthor {
+    /**
+     * ID автора в общей базе
+     */
+    id: string;
+
+    /**
+     * Username автора
+     */
+    username: string;
+
+    /**
+     * Отображаемое имя (опционально; в UI может отличаться от username)
+     */
+    name?: string;
+}
+
+/**
+ * Базовый манифест (информация о версии Minecraft и загрузчике)
+ */
+export interface BuildManifestInfo {
+    /**
+     * Версия Minecraft
+     */
+    minecraftVersion: string;
+
+    /**
+     * Загрузчик (fabric, quilt, vanilla, etc.)
+     */
+    loader: string;
+
+    /**
+     * Версия загрузчика
+     */
+    loaderVersion: string;
+}
+

package/src/shared/minecraft-types/index.ts

@@ -0,0 +1,3 @@
+export * from './build-manifest';
+export * from './launcher-versions';
+export * from './minecraft-launcher-types';

package/src/shared/minecraft-types/launcher-versions.ts

@@ -0,0 +1,32 @@
+/**
+ * Общие типы для UI-моделей версий Minecraft и загрузчиков
+ * (клиент, SDK-shared, @rynt/minecraft-launcher через реэкспорт).
+ */
+
+export interface MinecraftVersionManifest {
+  latest: {
+    release: string;
+    snapshot: string;
+  };
+  versions: MinecraftVersion[];
+}
+
+export interface MinecraftVersion {
+  id: string;
+  type: 'release' | 'snapshot' | 'old_beta' | 'old_alpha';
+  url: string;
+  time: string;
+  releaseTime: string;
+}
+
+/** Generic loader game-version info (for UI). */
+export interface LoaderGameVersion {
+  version: string;
+  stable: boolean;
+}
+
+/** Generic loader version info for a given game-version (for UI). */
+export interface LoaderVersionSummary {
+  version: string;
+  stable: boolean;
+}