🎌 AniLiberty.js

🚀 Быстрый старт

npm install anilibertyjs

const { AniLibertyClient, isSuccess } = require('anilibertyjs');

// Создаем клиент
const client = new AniLibertyClient();

// Получаем последние обновления
async function getLatestAnime() {
  const updates = await client.getUpdates({ limit: 5 });
  
  if (isSuccess(updates)) {
    updates.data.forEach(anime => {
      console.log(`${anime.title.ru} - ${anime.episodes_released} эп.`);
    });
  }
}

getLatestAnime();

✨ Возможности

📦 Установка

Через npm

npm install anilibertyjs

Через yarn

yarn add anilibertyjs

Требования

• Node.js >= 16.0.0
• npm или yarn

📖 Базовое использование

Создание клиента

const { AniLibertyClient } = require('anilibertyjs');

const client = new AniLibertyClient({
  baseUrl: 'https://aniliberty.top/api/v1',  // опционально
  timeout: 30000,                              // опционально (мс)
  headers: {                                   // опционально
    'User-Agent': 'MyApp/1.0.0'
  }
});

TypeScript

import { AniLibertyClient, Release, isSuccess } from 'anilibertyjs';

const client = new AniLibertyClient();

async function getCatalog() {
  const response = await client.getCatalog({ limit: 20 });
  
  if (isSuccess(response)) {
    const releases: Release[] = response.data;
    console.log(`Найдено релизов: ${releases.length}`);
  }
}

🔒 Авторизация

Логин и пароль

const response = await client.login({
  login: 'username',
  password: 'password'
});

if (isSuccess(response)) {
  console.log('Токен:', response.data.access_token);
  // Токен автоматически сохраняется в клиенте
}

Параметры LoginRequest

OTP (Одноразовый пароль)

// 1. Запросить OTP
const otpResponse = await client.otpGet({
  device_id: 'unique-device-id'
});

// 2. Пользователь вводит код из email/sms

// 3. Авторизация по OTP
const loginResponse = await client.otpLogin({
  code: 123456,
  device_id: 'unique-device-id'
});

Социальные сети

// VK
const vkRedirect = await client.socialAuthVkRedirect();
// Перенаправить пользователя на vkRedirect.data.url

// Discord
const discordRedirect = await client.socialAuthDiscordRedirect();

// Google
const googleRedirect = await client.socialAuthGoogleRedirect();

Управление токеном

// Установить токен вручную
client.setAccessToken('your-token-here');

// Очистить токен
client.clearAccessToken();

// Обновить токен
await client.refreshToken();

// Выход
await client.logout();

📚 Каталог аниме

Получение каталога с фильтрацией

const catalog = await client.getCatalog({
  page: 1,
  limit: 20,
  genres: ['action', 'comedy'],
  types: ['tv'],
  seasons: ['2024'],
  sort: 'rating',
  order: 'desc'
});

Параметры CatalogFilters

Другие методы каталога

const release = await client.getRelease('release-id');

const release = await client.getReleaseByCode('sword-art-online');

const random = await client.getRandomRelease();

const updates = await client.getUpdates({ limit: 10 });

🔍 Поиск

Полнотекстовый поиск

const searchResult = await client.search({
  query: 'Наруто',
  limit: 20,
  types: ['tv'],
  genres: ['action', 'adventure']
});

if (isSuccess(searchResult)) {
  console.log(`Найдено: ${searchResult.data.total}`);
  searchResult.data.releases.forEach(release => {
    console.log(`- ${release.title.ru}`);
  });
}

Быстрый поиск (автодополнение)

const quickResult = await client.quickSearch('One Piece', 5);

👤 Пользовательские возможности

Профиль

// Получить профиль
const profile = await client.getMyProfile();

// Обновить профиль
await client.updateMyProfile({
  login: 'new-login',
  email: 'new@email.com',
  description: 'Моё описание'
});

// Изменить пароль
await client.updateMyPassword({
  old_password: 'old',
  new_password: 'new',
  new_password_confirmation: 'new'
});

Избранное

// Добавить в избранное
await client.addToFavorites({
  release_id: '123',
  status_id: '1'
});

// Получить избранное
const favorites = await client.getMyFavorites();

// Обновить статус
await client.updateFavorite('release-id', {
  status_id: '2'
});

// Удалить из избранного
await client.removeFromFavorites('release-id');

Коллекции

// Создать коллекцию
const collection = await client.createCollection({
  title: 'Моя коллекция',
  description: 'Описание',
  is_public: true
});

// Добавить релиз в коллекцию
await client.addReleaseToCollection(collection.data.id, {
  release_id: 'release-id'
});

// Получить все коллекции
const collections = await client.getMyCollections();

История просмотров

// Обновить позицию просмотра
await client.updateWatchHistory('release-id', {
  episode_id: 'episode-id',
  timestamp: 300,  // секунды
  duration: 1440   // общая длительность
});

// Получить историю
const history = await client.getWatchHistory();

// Очистить историю
await client.clearWatchHistory();

📚 Дополнительные ресурсы

Примеры кода

Смотрите папку examples/ в репозитории для детальных примеров:

• basic.ts - Базовые операции с API
• auth.ts - Авторизация и работа с профилем
• search.ts - Поиск и фильтрация каталога