multporn-api-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,233 @@
+type ListingItem = {
+    title: string;
+    url: string;
+    thumb?: string;
+    proxiedThumb?: string;
+};
+type ExposedOption = {
+    value: string;
+    label: string;
+    selected?: boolean;
+};
+type ExposedSelect = {
+    name: string;
+    label?: string;
+    options: ExposedOption[];
+};
+interface SortingUI {
+    actionPath: string;
+    selects: ExposedSelect[];
+    appliedParams: Record<string, string>;
+}
+type Page<T> = {
+    page: number;
+    items: T[];
+    hasNext: boolean;
+    totalPages?: number;
+    pageSize?: number;
+    alphabet?: AlphabetBlock;
+    sorting?: SortingUI;
+};
+type Post = {
+    title: string;
+    url: string;
+    images: string[];
+    tags: string[];
+    author: string | null;
+};
+type ViewName = 'new_mini' | 'user_upload_front' | 'updated_manga' | 'updated_manga_promoted' | 'updated_games' | 'random_top_comics' | 'top_random_characters';
+type UpdatesResult = {
+    items: ListingItem[];
+    first: number;
+    last: number;
+    html: string;
+    viewName: string;
+};
+type MultpornUpdatesParams = {
+    first?: number;
+    last?: number;
+    view_args?: string;
+    view_path?: string;
+    view_base_path?: string;
+    view_display_id?: string;
+    view_name?: ViewName | string;
+    jcarousel_dom_id?: string | number;
+};
+type ResolvedListingRoute = {
+    route: 'listing';
+    data: Page<ListingItem> & {
+        absoluteUrl: string;
+        path: string;
+    };
+};
+type ResolvedViewerRoute = {
+    route: 'viewer';
+    data: {
+        absoluteUrl: string;
+        viewer: {
+            kind: 'images' | 'video' | 'other';
+            images?: Array<{
+                original?: string;
+                large?: string;
+                medium?: string;
+                small?: string;
+                thumb?: string;
+                proxied?: string;
+            }>;
+            video?: {
+                poster?: string;
+                sources: Array<{
+                    url?: string;
+                    proxied?: string;
+                    type?: string;
+                    label?: string;
+                }>;
+            };
+            meta?: Record<string, unknown>;
+        };
+        recommendations?: ListingItem[];
+    };
+};
+type ResolvedRoute = ResolvedListingRoute | ResolvedViewerRoute;
+type AlphabetSection = 'comics' | 'category_comic' | 'characters' | 'authors_comics' | 'pipictures' | 'porn_gifs' | 'manga' | 'authors_hentai';
+type AlphabetLetter = {
+    label: string;
+    value: string;
+    href: string;
+    count?: number;
+    active?: boolean;
+};
+interface AlphabetBlock {
+    section: string;
+    letters: AlphabetLetter[];
+}
+type LinkItem = {
+    title: string;
+    url: string;
+};
+type ViewerKind = 'manga' | 'comics' | 'pictures' | 'humor' | 'video' | 'game' | 'other' | 'images';
+interface ViewerImage {
+    original: string;
+    large?: string;
+    medium?: string;
+    small?: string;
+    thumb?: string;
+    proxied?: string;
+}
+interface ViewerVideoSource {
+    url: string;
+    type?: string;
+    label?: string;
+    proxied?: string;
+}
+interface ViewerVideo {
+    poster?: string;
+    sources: ViewerVideoSource[];
+}
+interface ViewerMeta {
+    nodeId: number | null;
+    fieldSys: string | null;
+    title: string;
+    kind: ViewerKind;
+    breadcrumbs: LinkItem[];
+    authors: LinkItem[];
+    sections: LinkItem[];
+    tags: LinkItem[];
+    characters: LinkItem[];
+    userTags: LinkItem[];
+    rating?: number;
+    votes?: number;
+    views?: number;
+    related?: LinkItem[];
+}
+interface ViewerResult {
+    kind: ViewerKind;
+    meta: ViewerMeta;
+    images?: ViewerImage[];
+    video?: ViewerVideo;
+}
+type ListingPayload = {
+    page: Page<ListingItem>;
+    absoluteUrl: string;
+    path: string;
+    title?: string;
+    breadcrumbs?: LinkItem[];
+};
+type ViewerPayload = {
+    viewer: ViewerResult;
+    absoluteUrl: string;
+    path: string;
+    recommendations?: ListingItem[];
+};
+interface ResolveOptions {
+    proxyImage?: (url: string) => string;
+    proxyVideo?: (url: string) => string;
+    signal?: AbortSignal;
+}
+type ListingQuery = Record<string, string | number | boolean | undefined>;
+
+type RetryPolicy = {
+    retries: number;
+    factor: number;
+    minDelayMs: number;
+    maxDelayMs: number;
+    retryOn: (status?: number) => boolean;
+};
+declare const defaultRetryPolicy: RetryPolicy;
+declare class HttpError extends Error {
+    status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+type HttpClientOptions = {
+    baseURL: string;
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    retry?: Partial<RetryPolicy>;
+    userAgent?: string;
+};
+declare class HttpClient {
+    private baseURL;
+    private headers;
+    private timeoutMs;
+    private retry;
+    private userAgent;
+    constructor(opts: HttpClientOptions);
+    private buildURL;
+    getHtml(pathOrUrl: string, attempt?: number): Promise<string>;
+    getJson<T = any>(pathOrUrl: string, attempt?: number): Promise<T>;
+    postForm<T = any>(pathOrUrl: string, form: Record<string, string | string[]>, attempt?: number): Promise<T>;
+}
+
+declare function parseHubListing(html: string, baseURL: string, page: number): Page<ListingItem>;
+
+declare function parsePost(html: string, baseURL: string, url: string): Post;
+
+type MultpornClientOptions = Omit<HttpClientOptions, 'baseURL'> & {
+    baseURL?: string;
+};
+declare class MultpornClient {
+    private http;
+    private baseURL;
+    constructor(opts?: MultpornClientOptions);
+    latest(page?: number, params?: ListingQuery): Promise<Page<ListingItem>>;
+    listByPath(path: string, page?: number, params?: ListingQuery & {
+        letter?: string;
+    }): Promise<Page<ListingItem>>;
+    search(query: string, page?: number): Promise<Page<ListingItem>>;
+    getPost(urlOrSlug: string): Promise<Post>;
+    resolve(urlOrSlug: string, opts?: ResolveOptions): Promise<ViewerResult>;
+    resolveSmart(urlOrSlug: string, opts?: ResolveOptions): Promise<ResolvedRoute>;
+    updates(params?: MultpornUpdatesParams): Promise<UpdatesResult>;
+    viewUpdates(viewName: ViewName, params?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    updatesNewMini(p?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    userUploadFront(p?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    updatedManga(p?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    updatedMangaPromoted(p?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    updatedGames(p?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    randomTopComics(p?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    topRandomCharacters(p?: Omit<MultpornUpdatesParams, 'view_name'>): Promise<UpdatesResult>;
+    alphabetLetters(section: AlphabetSection): Promise<AlphabetLetter[]>;
+    alphabet(section: AlphabetSection, letter: string, page?: number): Promise<Page<ListingItem>>;
+}
+
+export { type AlphabetBlock, type AlphabetLetter, type AlphabetSection, type ExposedOption, type ExposedSelect, HttpClient, type HttpClientOptions, HttpError, type LinkItem, type ListingItem, type ListingPayload, type ListingQuery, MultpornClient, type MultpornClientOptions, type MultpornUpdatesParams, type Page, type Post, type ResolveOptions, type ResolvedListingRoute, type ResolvedRoute, type ResolvedViewerRoute, type RetryPolicy, type SortingUI, type UpdatesResult, type ViewName, type ViewerImage, type ViewerKind, type ViewerMeta, type ViewerPayload, type ViewerResult, type ViewerVideo, type ViewerVideoSource, defaultRetryPolicy, parseHubListing as parseListing, parsePost };