Lord of the Rings SDK

This is an SDK for working with The One API To Rule Them all which provides facts and trivia concerning the Lord of The Rings franchise. The SDK currently supports a subset of the API's endpoints including those related to movies and quotes.

Installation

Add the SDK to your project using your favorite package manager:

npm i @maebog/lotr-sdk

OR

yarn add @maebog/lotr-sdk

OR

pnpm install @maebog/lotr-sdk

In order to use this SDK, you will need an API key which can be obtained from the API's website here. Remember to store it in a safe place, like in a .env file!

Usage

The SDK is written to be simple and typesafe. Refer to the following for examples of basic usage.

import { Client } from "@maebog/lotr-sdk";

const client = new Client({
  apiKey: "123",
});

// Fetch all movies using the API's default pagination settings
const response = await client.getMovies();

// response.data contains the exact response from the API
const movies = response.ok ? response.data.docs : [];

import { Client } from "@maebog/lotr-sdk";

const client = new Client({
  apiKey: "123",
});

// Fetch all movies matching the given regex sorted by name in ascending order
const response = await client.getMovies({
  sort: {
    field: "name",
    direction: "asc",
  },
  filter: [
    {
      field: "name",
      comparator: FilterType.REGEX,
      value: "/th/",
    },
  ],
});

const movies = response.ok ? response.data.docs : [];

import { Client } from "@maebog/lotr-sdk";

const client = new Client({
  apiKey: "123",
});

// Fetch a single movie by ID
const response = await client.getMovie("5cd95395de30eff6ebccde56");

const movie = response.ok ? response.data.docs[0] : undefined;

Testing

The SDK repository contains both unit and integration tests. In order to run integration tests, you will need to have an API key (see above) present in a .env file in the project root with the following contents:

API_KEY=<YOUR_API_KEY>

To run unit tests:

git clone https://github.com/hatchways-community/b37e95d01a0644f591f9c1314534bb55

npm install

npm run test:unit

To run integration tests:

git clone https://github.com/hatchways-community/b37e95d01a0644f591f9c1314534bb55

npm install

npm run test:integration

To run all tests:

git clone https://github.com/hatchways-community/b37e95d01a0644f591f9c1314534bb55

npm install

npm run test