Add support for getting page images

.gitignore

@@ -8,6 +8,8 @@
 
 # testing
 /coverage
+/scripts/
+!/scripts/update-readme-health.ts
 
 # next.js
 /.next/
@@ -33,4 +35,4 @@ yarn-error.log*
 
 # typescript
 *.tsbuildinfo
-next-env.d.ts
+next-env.d.ts

README.md

@@ -87,6 +87,7 @@ npm run dev
 Runs on http://localhost:3000
 
 **Production:**
+
 ```bash
 npm run build
 npm start
@@ -135,6 +136,17 @@ Get chapter list for a manga.
 }
 ```
 
+### POST /api/pages
+
+Get chapter page images
+
+```json
+{
+  "url": "https://kaliscan.me/manga/62786-lying-puppies-get-eaten/chapter-1",
+  "source": "mangapark"  // optional, auto-detected
+}
+```
+
 ### GET /api/health
 
 Check source status. Cached for 5 minutes. Returns `cached` and `cacheAge` fields.
@@ -183,6 +195,7 @@ Fetch frontpage section data from a source.
 ```
 
 **Available sections for Comix:**
+
 - `trending` - Most Recent Popular (supports time filter)
 - `most_followed` - Most Followed New Comics (supports time filter)
 - `latest_hot` - Latest Updates (Hot)
@@ -194,7 +207,7 @@ Fetch frontpage section data from a source.
 
 Proxy requests to AsuraScans and WeebCentral (CORS workaround).
 
-```
+```txt
 GET /api/proxy/html?url=https://asuracomic.net/...
 ```
 

src/app/api/pages/route.ts

@@ -0,0 +1,62 @@
+import { NextRequest, NextResponse } from "next/server";
+import { getScraper, getScraperByName } from "@/lib/scrapers";
+
+export const runtime = "edge";
+
+export async function POST(request: NextRequest) {
+  try {
+    const { url, source } = await request.json();
+
+    if (!url) {
+      return NextResponse.json({ error: "URL is required" }, { status: 400 });
+    }
+
+    let scraper;
+
+    if (source) {
+      scraper = getScraperByName(source);
+    }
+
+    if (!scraper) {
+      scraper = getScraper(url);
+    }
+
+    if (!scraper) {
+      return NextResponse.json(
+        {
+          error:
+            "No scraper found for this URL. Please provide a valid chapter URL or source name.",
+        },
+        { status: 400 },
+      );
+    }
+
+    if (!scraper.supportsChapterImages()) {
+      return NextResponse.json(
+        {
+          error: `${scraper.getName()} does not support fetching chapter images`,
+        },
+        { status: 400 },
+      );
+    }
+
+    const images = await scraper.getChapterImages(url);
+
+    return NextResponse.json({
+      images,
+      source: scraper.getName(),
+      totalPages: images.length,
+    });
+  } catch (error: unknown) {
+    console.error("Chapter images error:", error);
+    return NextResponse.json(
+      {
+        error:
+          error instanceof Error
+            ? error.message
+            : "Failed to fetch chapter images",
+      },
+      { status: 500 },
+    );
+  }
+}

src/app/page.tsx

@@ -102,6 +102,25 @@ const endpoints: EndpointProps[] = [
   ],
   "source": "MangaPark",
   "totalChapters": 179
+}`,
+  },
+  {
+    method: "POST",
+    path: "/api/pages",
+    description: "Get chapter page images",
+    request: `{
+  "url": "https://kaliscan.com/manga/12345-some-manga/chapter-1",
+  "source": "kaliscan"  // optional
+}`,
+    response: `{
+  "images": [
+    {
+      "url": "https://...",
+      "page": 1
+    }
+  ],
+  "source": "KaliScan",
+  "totalPages": 20
 }`,
   },
   {

src/lib/scrapers/arvencomics.ts

@@ -1,7 +1,7 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import * as cheerio from "cheerio";
 import { BaseScraper } from "./base";
-import { ScrapedChapter, SearchResult, SourceType } from "@/types";
+import { ChapterImage, ScrapedChapter, SearchResult, SourceType } from "@/types";
 
 export class ArvenComicsScraper extends BaseScraper {
   private readonly BASE_URL = "https://arvencomics.com";
@@ -104,6 +104,25 @@ export class ArvenComicsScraper extends BaseScraper {
     return chapters.sort((a, b) => a.number - b.number);
   }
 
+  override supportsChapterImages(): boolean {
+    return true;
+  }
+
+  async getChapterImages(chapterUrl: string): Promise<ChapterImage[]> {
+    const html = await this.fetchWithRetry(chapterUrl);
+    const $ = cheerio.load(html);
+    const images: ChapterImage[] = [];
+
+    $(".reading-content .page-break img, .reading-content img.wp-manga-chapter-img").each((_, el) => {
+      const url = $(el).attr("data-src")?.trim() || $(el).attr("src")?.trim();
+      if (url && !url.includes("loading") && !url.includes("placeholder")) {
+        images.push({ url, page: images.length + 1 });
+      }
+    });
+
+    return images;
+  }
+
   protected extractChapterNumber(
     chapterUrl: string,
     chapterText?: string,

src/lib/scrapers/arya-scans.ts

@@ -1,7 +1,7 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import * as cheerio from "cheerio";
 import { BaseScraper } from "./base";
-import { ScrapedChapter, SearchResult, SourceType } from "@/types";
+import { ChapterImage, ScrapedChapter, SearchResult, SourceType } from "@/types";
 
 export class AryaScansScraper extends BaseScraper {
   private readonly BASE_URL = "https://brainrotcomics.com";
@@ -108,6 +108,25 @@ export class AryaScansScraper extends BaseScraper {
     return chapters.sort((a, b) => a.number - b.number);
   }
 
+  override supportsChapterImages(): boolean {
+    return true;
+  }
+
+  async getChapterImages(chapterUrl: string): Promise<ChapterImage[]> {
+    const html = await this.fetchWithRetry(chapterUrl);
+    const $ = cheerio.load(html);
+    const images: ChapterImage[] = [];
+
+    $(".reading-content .page-break img, .reading-content img.wp-manga-chapter-img").each((_, el) => {
+      const url = $(el).attr("data-src")?.trim() || $(el).attr("src")?.trim();
+      if (url && !url.includes("loading") && !url.includes("placeholder")) {
+        images.push({ url, page: images.length + 1 });
+      }
+    });
+
+    return images;
+  }
+
   protected extractChapterNumber(chapterUrl: string): number {
     const patterns = [
       /chapter[/-](\d+)(?:[.-](\d+))?/i,

src/lib/scrapers/asmotoon.ts

@@ -1,7 +1,7 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import * as cheerio from "cheerio";
 import { BaseScraper } from "./base";
-import { ScrapedChapter, SearchResult, SourceType } from "@/types";
+import { ChapterImage, ScrapedChapter, SearchResult, SourceType } from "@/types";
 
 export class AsmotoonScraper extends BaseScraper {
   private readonly BASE_URL = "https://asmotoon.com";
@@ -107,6 +107,25 @@ export class AsmotoonScraper extends BaseScraper {
     return -1;
   }
 
+  override supportsChapterImages(): boolean {
+    return true;
+  }
+
+  async getChapterImages(chapterUrl: string): Promise<ChapterImage[]> {
+    const html = await this.fetchWithRetry(chapterUrl);
+    const $ = cheerio.load(html);
+    const images: ChapterImage[] = [];
+
+    $("#pages img[uid]").each((_, el) => {
+      const uid = $(el).attr("uid")?.trim();
+      if (uid) {
+        images.push({ url: `https://cdn.meowing.org/uploads/${uid}`, page: images.length + 1 });
+      }
+    });
+
+    return images;
+  }
+
   async search(query: string): Promise<SearchResult[]> {
     try {
       const searchUrl = `${this.BASE_URL}/series?q=${encodeURIComponent(query)}`;