nhentai-client 0.0.1

package/README.md

@@ -0,0 +1 @@
+# nhentai-client

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "nhentai-client",
+  "version": "0.0.1",
+  "description": "A TypeScript client for the nhentai API",
+  "author": "Krettsy",
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "import": "./src/index.ts",
+      "types": "./src/index.ts"
+    }
+  },
+  "files": [
+    "src"
+  ],
+  "keywords": [
+    "nhentai",
+    "api",
+    "client"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Walter-Sparrow/nhentai-client"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  }
+}

package/src/client.ts

@@ -0,0 +1,47 @@
+import { findWorkingUrl } from "./utils/findWorkingUrl";
+import {
+  API_URL,
+  MAP_IMAGE_TYPE_TO_EXTENSION,
+  T_IMAGE_URL,
+  type Book,
+  type Page,
+  type Sort,
+} from "./client.types";
+
+export const getCoverImageUrl = async (book: Book) => {
+  const baseUrl = `${T_IMAGE_URL}/galleries/${book.media_id}/cover`;
+  const ext = MAP_IMAGE_TYPE_TO_EXTENSION[book.images.cover.t];
+
+  if (ext !== "webp") {
+    return `${baseUrl}.${ext}`;
+  }
+
+  const candidates = Object.values(MAP_IMAGE_TYPE_TO_EXTENSION).map(
+    (ext) => `${baseUrl}.${ext}.webp`
+  );
+  return await findWorkingUrl(candidates);
+};
+
+export const getBookUrl = (id: number) => {
+  return `${API_URL}/gallery/${id}`;
+};
+
+export const getSearchUrl = (query: string, page: number, sort: Sort) => {
+  return `${API_URL}/galleries/search?query=${query}&page=${page}&sort=${sort}`;
+};
+
+export const getBook = async (id: number) => {
+  const response = await fetch(getBookUrl(id));
+  const data = await response.json();
+  return data as Book;
+};
+
+export const getSearch = async (
+  query: string,
+  page: number,
+  sort: Sort = "recent"
+) => {
+  const response = await fetch(getSearchUrl(query, page, sort));
+  const data = await response.json();
+  return data as Page<Book>;
+};

package/src/client.types.ts

@@ -0,0 +1,68 @@
+export type ImageType = "j" | "p" | "g" | "w";
+
+export type Image = {
+  t: ImageType;
+  w: number;
+  h: number;
+};
+
+export type Tag = {
+  id: number;
+  type:
+    | "artist"
+    | "circle"
+    | "language"
+    | "category"
+    | "parody"
+    | "character"
+    | "group"
+    | "tag";
+  name: string;
+  url: string;
+  count: number;
+};
+
+export type Book = {
+  id: number;
+  media_id: string;
+  title: {
+    english: string;
+    japanese: string;
+    pretty: string;
+  };
+  images: {
+    pages: Image[];
+    cover: Image;
+    thumbnail: Image;
+  };
+  scanlator: string;
+  upload_date: number;
+  tags: Tag[];
+  num_pages: number;
+  num_favorites: number;
+};
+
+export type Sort =
+  | "recent"
+  | "popular"
+  | "popular-today"
+  | "popular-week"
+  | "popular-month";
+
+export type Page<T> = {
+  result: T[];
+  num_pages: number;
+  per_page: number;
+};
+
+export const API_URL = "https://nhentai.net/api";
+
+export const I_IMAGE_URL = "https://i1.nhentai.net";
+export const T_IMAGE_URL = "https://t1.nhentai.net";
+
+export const MAP_IMAGE_TYPE_TO_EXTENSION = {
+  j: "jpg",
+  p: "png",
+  g: "gif",
+  w: "webp",
+} as const;

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./client";
+export * from "./client.types";

package/src/utils/findWorkingUrl.ts

@@ -0,0 +1,11 @@
+export const findWorkingUrl = async (urls: string[]): Promise<string> => {
+  const results = await Promise.allSettled(
+    urls.map(async (url) => {
+      const res = await fetch(url, { method: "HEAD" });
+      if (!res.ok) throw new Error("not found");
+      return url;
+    })
+  );
+  const found = results.find((r) => r.status === "fulfilled");
+  return found?.value ?? urls[0]!;
+};