npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@nathangasc/kp-anidb-ts

v1.0.3

Published

AniDB API client for TypeScript with cache and limit rate

Downloads

10

Readme

KP AniDB TS

Strict TypeScript Checked

This is a Typescript library for the AniDB API. First, read the AniDB API documentation to understand how the API works and what you can do with it.

Run demo

[!IMPORTANT] To use this library, you need to have a client name and a client version. You can get them by registering your client on the animeDB website.

Create a .config file in the root of the project and add the following lines

[Client]
name=your-client-name
version=1

After that, run the following command to install the dependencies

npm i

And finally, run the demo

npm run demo

Installation

To install the library, run the following command

npm install @nathangasc/kp-anidb-ts

And then import it in your code

import { KSAniDB } from "@nathangasc/kp-anidb-ts"

const main = async () => {
    let db = KSAniDB.builder()
        .setClient("your-client-name")
        .setClientVer(1) //your client version
        .build()

    await db.init()

    const titles = db.searchTitle("utawareru")
    console.log(titles)
}

main()

[!CAUTION] Your client name and version are sensitive information. Do not share them, use them in public repositories, or expose them in a web application. Use this library in a server-side application where you can keep your client name and version safe.

Usage

This library abstracts the AniDB API and provides a simple way to interact with it by giving you a set of utility functions.

Titles

Titles are downloaded by the library and stored in disk to avoid unnecessary requests to the API (as requested by the API documentation). The list will be updated every 24 hours.

To download the titles, you need to call the init method first. If you don't call this method, the library will throw an error when you try to access the titles. If the titles are already downloaded, the library will not download them again.

db.init()

Get titles

Get titles returns the list of titles downloaded by the library.

const titles = db.getTitles

Get titles by AID

Get titles by AID returns the titles of an anime by its AID.

const titles = db.getTitlesByAid(1)

Get titles by title (exact match)

Get titles by title returns the titles that match the exact title.

const titles = db.getTitlesByTitle("utawarerumono")

Search for title (partial match)

Search for title returns the titles that partially match the title with a matching score.

const titles = db.searchTitle("utawareru")

Suggest titles based on the given entry (partial match)

Suggest titles returns the titles that are similar to the given title.

const titles = db.suggestTitle("utawarerumono")

Anime

Anime is the main feature of the AniDB API. It allow to search animes by different criteria. Those are impacted by the rate limits of the API. To avoid too many requests, the library caches the responses from the API for 24 hours (as requested by the API documentation).

Get anime details

Get anime details returns the details of an anime by its AID.

const title = db.searchTitle("utawareru")[0]
const anime = await title.fetchDetails()

Get anime hot anime

Get anime hot anime returns the list of hot animes.

const hotAnimes = await db.fetchHotAnime()

Get random anime

Get anime random anime returns a random anime.

const randomAnime = await db.fetchRecommendation()

Get random similar anime

Get random anime similar anime list

const similarAnimes = await db.fetchRandomSimilar()

Get anime on main page

Get anime on displayed on the main page

const mainPageAnimes = await db.fetchMain()

User

I've not implemented user related features because it requires to put the user's credentials in an URL which can be retrieved by a man-in-the-middle attack. If you want to use this feature, you can implement it yourself by extending the KSAniDB class but I strongly advise against it.

Abstraction features

  • Caching: The library caches the responses from the API to avoid unnecessary requests. This cache is updated every 24 hours.
  • Rate limiting: The library respects the rate limits of the API and will wait for the necessary time before making a new request. If the rate limit is reached, the library will throw an error. You can handle it like this:
try {
    const anime = await db.fetchDetails()
} catch (e) {
    if (e instanceof RateLimitError) {
        console.log("Rate limit reached. Waiting for the necessary time.")
    }
}