ichime-ts-api-client 1.0.3 → 1.0.5

package/dist/index.d.mts

@@ -0,0 +1,293 @@
+import { CookieJar } from "tough-cookie";
+import * as cheerio from "cheerio";
+
+//#region src/http-session.d.ts
+interface RequestOptions extends Omit<RequestInit, "dispatcher"> {
+  timeout?: number;
+}
+declare class HttpSession {
+  readonly jar: CookieJar;
+  readonly baseUrl: string;
+  constructor(baseUrl: string);
+  request(path: string, options?: RequestOptions): Promise<Response>;
+  getCookie(name: string): Promise<string | undefined>;
+  getCookieString(): Promise<string>;
+  setCookie(name: string, value: string): Promise<void>;
+}
+//#endregion
+//#region src/api/types/series-type.d.ts
+type SeriesType = "tv" | "tv_special" | "movie" | "ova" | "music" | "ona" | "special" | "pv" | "cm";
+//#endregion
+//#region src/api/types/series.d.ts
+interface Titles {
+  ru: string | null;
+  romaji: string | null;
+}
+interface Series {
+  id: number;
+  title: string;
+  titles: Titles;
+  posterUrl: string | null;
+  myAnimeListScore: string;
+  season: string;
+  type: SeriesType | null;
+  year: number | null;
+}
+interface SeriesFullGenre {
+  id: number;
+  title: string;
+}
+interface SeriesFullDescription {
+  source: string;
+  value: string;
+}
+interface SeriesFull {
+  id: number;
+  title: string;
+  posterUrl: string | null;
+  myAnimeListScore: string;
+  myAnimeListId: number;
+  isAiring: number;
+  numberOfEpisodes: number;
+  season: string;
+  type: SeriesType | null;
+  titles: Titles;
+  genres: SeriesFullGenre[] | null;
+  descriptions: SeriesFullDescription[] | null;
+  episodes: Episode[] | null;
+}
+//#endregion
+//#region src/api/types/translation.d.ts
+interface Translation {
+  id: number;
+  activeDateTime: Date;
+  addedDateTime: Date;
+  isActive: number;
+  qualityType: string;
+  typeKind: string;
+  typeLang: string;
+  authorsSummary: string;
+  height: number;
+}
+interface TranslationFull {
+  episode: Episode;
+  series: Series;
+}
+interface TranslationEmbedStream {
+  height: number;
+  urls: string[];
+}
+interface TranslationEmbed {
+  stream: TranslationEmbedStream[];
+  subtitlesUrl: string | null;
+  subtitlesVttUrl: string | null;
+}
+//#endregion
+//#region src/api/types/episode.d.ts
+interface Episode {
+  id: number;
+  episodeFull: string;
+  episodeInt: string;
+  episodeType: string;
+  firstUploadedDateTime: Date;
+  isActive: number;
+  isFirstUploaded: number;
+}
+interface EpisodeFull extends Episode {
+  seriesId: number;
+  translations: Translation[];
+}
+//#endregion
+//#region src/api/api-client.d.ts
+interface ListSeriesOptions {
+  query?: string;
+  limit?: number;
+  offset?: number;
+  chips?: Record<string, string>;
+  myAnimeListId?: number;
+}
+interface ListEpisodesOptions {
+  seriesId?: number;
+  limit?: number;
+  offset?: number;
+}
+declare class ApiClient {
+  private readonly session;
+  constructor(session: HttpSession);
+  sendRequest<T>(endpoint: string, queryItems?: Record<string, string>): Promise<T>;
+  private isApiErrorResponse;
+  private isApiSuccessfulResponse;
+  getSeries(seriesId: number): Promise<SeriesFull>;
+  getEpisode(episodeId: number): Promise<EpisodeFull>;
+  listSeries(options?: ListSeriesOptions): Promise<Series[]>;
+  listEpisodes(options?: ListEpisodesOptions): Promise<Episode[]>;
+  getTranslation(translationId: number): Promise<TranslationFull>;
+  getTranslationEmbed(translationId: number): Promise<TranslationEmbed>;
+}
+//#endregion
+//#region src/api/date-decoder.d.ts
+/**
+ * Парсит даты в формате API Anime365: "yyyy-MM-dd HH:mm:ss" в московской таймзоне.
+ */
+declare function parseApiDate(dateString: string): Date;
+/**
+ * Проверяет, является ли дата "пустой" датой-заглушкой API (2000-01-01 00:00:00).
+ */
+declare function isEmptyDate(date: Date): boolean;
+//#endregion
+//#region src/api/errors.d.ts
+declare class ApiError extends Error {
+  readonly code: number;
+  constructor(code: number, message: string);
+  static authenticationRequired(): ApiError;
+  static notFound(): ApiError;
+  static other(code: number, message: string): ApiError;
+}
+declare class ApiClientError extends Error {
+  readonly cause?: (ApiError | Error) | undefined;
+  constructor(message: string, cause?: (ApiError | Error) | undefined);
+  static canNotDecodeResponseJson(error?: Error): ApiClientError;
+  static apiError(error: ApiError): ApiClientError;
+  static requestFailed(error?: Error): ApiClientError;
+}
+//#endregion
+//#region src/web/errors.d.ts
+declare class WebClientError extends Error {
+  constructor(message: string);
+  static couldNotConvertResponseToHttpResponse(): WebClientError;
+  static couldNotConvertResponseDataToString(): WebClientError;
+  static badStatusCode(statusCode: number): WebClientError;
+  static authenticationRequired(): WebClientError;
+  static couldNotParseHtml(): WebClientError;
+  static unknownError(error: Error): WebClientError;
+}
+declare class WebClientTypeNormalizationError extends Error {
+  constructor(message: string);
+  static failedCreatingDTOFromHTMLElement(message: string): WebClientTypeNormalizationError;
+}
+//#endregion
+//#region src/web/helpers.d.ts
+/**
+ * Извлекает ID сериала и эпизода из URL вида /catalog/{seriesId}-{slug}/{episodeId}-{slug}
+ */
+declare function extractIdentifiersFromUrl(url: URL): {
+  seriesId: number | null;
+  episodeId: number | null;
+};
+/**
+ * Парсит строку длительности формата "mm:ss" или "hh:mm:ss" в секунды.
+ */
+declare function parseDurationString(durationString: string): number | null;
+/**
+ * Парсит дату в формате "dd.MM.yyyy HH:mm" в московской таймзоне.
+ */
+declare function parseWebDate(dateString: string): Date | null;
+//#endregion
+//#region src/web/types/anime-list-status.d.ts
+type AnimeListEntryStatus = "watching" | "completed" | "onHold" | "dropped" | "planned" | "notInList";
+declare const AnimeListEntryStatusNumericId: Record<AnimeListEntryStatus, number>;
+declare function animeListEntryStatusFromNumericId(id: number): AnimeListEntryStatus | null;
+type AnimeListCategory = "watching" | "completed" | "onHold" | "dropped" | "planned";
+declare const AnimeListCategoryWebPath: Record<AnimeListCategory, string>;
+declare const AnimeListCategoryNumericId: Record<AnimeListCategory, number>;
+declare function animeListCategoryFromNumericId(id: number): AnimeListCategory | null;
+//#endregion
+//#region src/web/types/anime-list.d.ts
+interface AnimeListEntry {
+  seriesId: number;
+  seriesTitleFull: string;
+  episodesWatched: number;
+  episodesTotal: number | null;
+  score: number | null;
+}
+interface AnimeListEditableEntry {
+  episodesWatched: number;
+  status: AnimeListEntryStatus;
+  score: number | null;
+  commentary: string | null;
+}
+interface EditAnimeListResult {
+  id: number;
+  status: string;
+  score: string;
+  episodes: string;
+}
+//#endregion
+//#region src/web/types/moment.d.ts
+interface MomentPreview {
+  momentId: number;
+  coverUrl: string;
+  momentTitle: string;
+  sourceDescription: string;
+  /** Duration in seconds */
+  durationSeconds: number;
+}
+interface MomentDetails {
+  seriesId: number;
+  seriesTitle: string;
+  episodeId: number;
+}
+interface VideoSource {
+  height: number;
+  urls: string[];
+}
+interface MomentEmbed {
+  videoUrl: string;
+}
+type MomentSorting = "new" | "old" | "popular";
+//#endregion
+//#region src/web/types/personal-episode.d.ts
+interface NewPersonalEpisode {
+  seriesId: number;
+  seriesPosterUrl: string;
+  seriesTitleRu: string;
+  seriesTitleRomaji: string;
+  episodeId: number;
+  episodeNumberLabel: string;
+  episodeUpdateType: string;
+}
+interface NewRecentEpisode {
+  seriesId: number;
+  seriesPosterUrl: string;
+  seriesTitleRu: string;
+  seriesTitleRomaji: string;
+  episodeId: number;
+  episodeNumberLabel: string;
+  episodeUploadedAt: Date;
+}
+//#endregion
+//#region src/web/types/profile.d.ts
+interface Profile {
+  id: number;
+  name: string;
+  avatarUrl: string;
+}
+//#endregion
+//#region src/web/web-client.d.ts
+declare class WebClient {
+  private readonly session;
+  constructor(session: HttpSession);
+  get baseUrl(): string;
+  sendRequest(path: string, queryItems?: Record<string, string>): Promise<string>;
+  sendPostRequest(path: string, queryItems?: Record<string, string>, formData?: Record<string, string>): Promise<string>;
+  parseHtml(html: string): cheerio.CheerioAPI;
+  login(username: string, password: string): Promise<void>;
+  getProfile(): Promise<Profile>;
+  getPersonalEpisodes(page: number): Promise<NewPersonalEpisode[]>;
+  private parsePersonalEpisode;
+  getRecentEpisodes(page: number): Promise<NewRecentEpisode[]>;
+  private parseRecentEpisode;
+  getAnimeList(userId: number, category: AnimeListCategory): Promise<AnimeListEntry[]>;
+  private parseAnimeListEntry;
+  getAnimeListEditableEntry(seriesId: number): Promise<AnimeListEditableEntry>;
+  editAnimeListEntry(seriesId: number, score: number, episodes: number, status: number, comment: string): Promise<void>;
+  markEpisodeAsWatched(translationId: number): Promise<void>;
+  getMoments(page: number, sort?: MomentSorting): Promise<MomentPreview[]>;
+  getMomentsBySeries(seriesId: number, page: number): Promise<MomentPreview[]>;
+  private parseMomentPreview;
+  getMomentDetails(momentId: number): Promise<MomentDetails>;
+  getMomentEmbed(momentId: number): Promise<MomentEmbed>;
+}
+//#endregion
+export { type AnimeListCategory, AnimeListCategoryNumericId, AnimeListCategoryWebPath, type AnimeListEditableEntry, type AnimeListEntry, type AnimeListEntryStatus, AnimeListEntryStatusNumericId, ApiClient, ApiClientError, ApiError, type EditAnimeListResult, type Episode, type EpisodeFull, HttpSession, type ListEpisodesOptions, type ListSeriesOptions, type MomentDetails, type MomentEmbed, type MomentPreview, type MomentSorting, type NewPersonalEpisode, type NewRecentEpisode, type Profile, type RequestOptions, type Series, type SeriesFull, type SeriesFullDescription, type SeriesFullGenre, type SeriesType, type Titles, type Translation, type TranslationEmbed, type TranslationEmbedStream, type TranslationFull, type VideoSource, WebClient, WebClientError, WebClientTypeNormalizationError, animeListCategoryFromNumericId, animeListEntryStatusFromNumericId, extractIdentifiersFromUrl, isEmptyDate, parseApiDate, parseDurationString, parseWebDate };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/http-session.ts","../src/api/types/series-type.ts","../src/api/types/series.ts","../src/api/types/translation.ts","../src/api/types/episode.ts","../src/api/api-client.ts","../src/api/date-decoder.ts","../src/api/errors.ts","../src/web/errors.ts","../src/web/helpers.ts","../src/web/types/anime-list-status.ts","../src/web/types/anime-list.ts","../src/web/types/moment.ts","../src/web/types/personal-episode.ts","../src/web/types/profile.ts","../src/web/web-client.ts"],"mappings":"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"}