@xnlc/mods: клиент Modrinth, CurseForge и FTB для Minecraft

import { modrinthSearch } from "@xnlc/mods";

const response = await modrinthSearch("jei", {
  contentType: "mod",        // "mod" | "modpack" | "resourcepack" | "shader" | "datapack"
  gameVersion: "1.20.4",
  modLoader: "neoforge",     // "vanilla" | "forge" | "fabric" | "quilt" | "neoforge"
  sortBy: "downloads",       // "relevance" | "downloads" | "follows" | "newest" | "updated" | "featured" | "rating"
  page: 0,
  categories: ["utility"],
});

console.log(response.results);   // ModSearchResult[]
console.log(response.totalCount);

import { modrinthGetDetails, modrinthGetVersions } from "@xnlc/mods";

const details = await modrinthGetDetails("jei");
// details.versions: полный список версий (пагинация по страницам внутри)

const versions = await modrinthGetVersions("jei");

import { modrinthCheckUpdates } from "@xnlc/mods";

const updates = await modrinthCheckUpdates(
  ["sha1hash1", "sha1hash2"],
  ["neoforge"],
  ["1.20.4"]
);
// Record<sha1, ModVersion>

import { curseforgeSearch } from "@xnlc/mods";

const response = await curseforgeSearch("jei", {
  contentType: "mod",
  gameVersion: "1.20.4",
  modLoader: "neoforge",
  sortBy: "downloads",
  page: 0,
});

import { curseforgeGetDetails, curseforgeGetFileDownloadUrl } from "@xnlc/mods";

const details = await curseforgeGetDetails(238222); // numeric modId
const url = await curseforgeGetFileDownloadUrl(1234567, 238222); // fileId, modId

import { curseforgeGetFiles } from "@xnlc/mods";

const files = await curseforgeGetFiles([1234567, 1234568]);
// Record<fileId, { id, modId, fileName, downloadUrl, fileLength }>

import { curseforgeGetFingerprintsMatches } from "@xnlc/mods";

const matches = await curseforgeGetFingerprintsMatches([12345678, 87654321]);
// { exactMatches: [{ fileFingerprint, modId, fileId, sha1 }] }

import { ftbSearch, ftbCatalog, ftbCatalogFacets } from "@xnlc/mods";

// Весь каталог FTB (с дисковым кэшем)
const catalog = await ftbCatalog();

// Поиск с фильтрами
const results = await ftbSearch("all", {
  page: 0,
  sortBy: "downloads",
  categories: ["Tech"],
  gameVersion: "1.21.1",
  loader: "neoforge",
});

// Фильтры каталога
const facets = await ftbCatalogFacets();
// { gameVersions: string[], categories: string[], loaders: string[] }

import { ftbGetDetails, ftbGetModpackChangelog } from "@xnlc/mods";

const details = await ftbGetDetails(100); // FTB modpack ID
const changelog = await ftbGetModpackChangelog(100, 1234); // id, versionId

import type {
  ModSearchResult,   // Результат поиска (источник-агностик)
  ModDetails,        // Полная информация о проекте
  ModVersion,        // Конкретная версия с файлами
  ModDependency,     // Зависимость проекта
  ModCategory,       // Категория/тег
  ContentType,       // "mod" | "modpack" | "resourcepack" | "shader" | "datapack" | "plugin" | "world"
  ModSort,           // Варианты сортировки
  ModSource,         // "modrinth" | "curseforge" | "ftb"
} from "@xnlc/mods";