lastfm-nodejs-client 1.0.0

package/.env.example

@@ -0,0 +1,4 @@
+LASTFM_API_BASE_URL=""
+LASTFM_API_KEY=""
+LASTFM_APPNAME=""
+LASTFM_USER=""

package/CHANGELOG.md

@@ -0,0 +1,3 @@
+# 1.0.0
+
+- Initial project setup

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Mannuel Ferreira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# LastFm NodeJs client
+
+A Node JS wrapper client for fetching public data from [LastFm API](https://www.last.fm/api).
+
+## How to use the client
+
+Install the npm package in your project.
+
+```bash
+pnpm install
+```
+
+Consider [PNPM](https://pnpm.io/) ▶️
+
+### Import it
+
+```js
+import { lastFm } from 'lastfm-nodejs-client';
+```
+
+### Use it
+
+```js
+const getUser = async () => {
+  const data = await lastFm.getInfo(
+    config.method.user.getInfo,
+    config.username,
+    'overall',
+    12
+  );
+  const { user } = data;
+  return user;
+};
+
+const user = getUser();
+
+console.log(user.name);
+```
+
+## Developing client
+
+Written in TypeScript and compiles down to ES2015.
+
+### Postman collections
+
+A list of endpoints currently mapped to this client. Still under development, not feature complete.
+
+[View collections](https://documenter.getpostman.com/view/4217/2s8YKJELqJ) ▶️
+
+Clone repo
+
+```bash
+git clone git@github.com:mannuelf/lastfm-nodejs-client.git
+```
+
+create `.env` file in project root.
+Requirements for environment are:
+
+```bash
+LASTFM_API_BASE_URL=""
+LASTFM_API_KEY=""
+LASTFM_APPNAME=""
+LASTFM_USER=""
+```
+
+Get it [here](https://www.last.fm/api/account/create)
+
+Develop
+
+```bash
+pnpm dev
+```
+
+Build
+
+```bash
+pnpm build
+```
+
+## Testing code
+
+```bash
+pnpm test
+```

package/dist/config.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const config = {
+    api_key: `${process.env.LASTFM_API_KEY}`,
+    app_name: `${process.env.LASTFM_APPNAME}`,
+    base_url: `${process.env.LASTFM_API_BASE_URL}`,
+    format: {
+        json: 'json',
+        xml: 'xml',
+    },
+    method: {
+        auth: 'auth.getToken',
+        user: {
+            getInfo: 'user.getInfo',
+            loved_tracks: 'user.getLovedTracks',
+            recent_tracks: 'user.getRecentTracks',
+            top_albums: 'user.getTopAlbums',
+            top_artists: 'user.getTopArtists',
+            top_tracks: 'user.getTopTracks',
+            weekly_album_chart: 'user.getWeeklyAlbumChart',
+            weekly_artist_chart: 'user.getWeeklyArtistChart',
+            weekly_chart_list: 'user.getWeeklyChartList',
+            weekly_track_chart: 'user.getWeeklyTrackChart',
+        },
+    },
+    share_secret: `${process.env.LASTFM_SHARED_SECRET}`,
+    username: `${process.env.LASTFM_USER}`,
+};
+exports.default = config;

package/dist/index.js

@@ -0,0 +1,125 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const request_1 = __importDefault(require("./request"));
+const LastFmApi = function LastFmApi() {
+    /**
+     * POST: Auth - LastFM
+     *
+     * https://www.last.fm/api/show/auth.getToken
+     *
+     * Authentication tokens are API account specific.
+     * They are valid for 60 minutes from the moment they are granted.
+     * Can only used once (they are consumed when a session is created).
+     * @returns Auth token
+     */
+    const auth = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: User profile information - LastFM
+     *
+     * https://www.last.fm/api/show/user.getInfo
+     * @returns User profile data
+     */
+    const getInfo = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Love Tracks - LastFM
+     *
+     * https://www.last.fm/api/show/user.getLovedTracks
+     * @returns Loved Tracks;
+     */
+    const getLovedTracks = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Recent Tracks - LastFM
+     *
+     * https://www.last.fm/api/show/user.getRecentTracks
+     * @returns Recent Tracks
+     */
+    const getRecentTracks = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Top Albums - LastFM
+     *
+     * https://www.last.fm/api/show/user.getTopAlbums
+     * @returns Top Albums
+     */
+    const getTopAlbums = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Top Artist - LastFM
+     *
+     * https://www.last.fm/api/show/user.getTopArtists
+     * @returns Top Artists
+     */
+    const getTopArtists = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Top Tracks - LastFM
+     *
+     * https://www.last.fm/api/show/user.getTopTracks
+     * @returns Top Tracks
+     */
+    const getTopTracks = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Weekly album chart - LastFM
+     *
+     * https://www.last.fm/api/show/user.getWeeklyAlbumChart
+     * @returns Weekly album chart
+     */
+    const getWeeklyAlbumChart = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Weekly artist chart - LastFM
+     *
+     * https://www.last.fm/api/show/user.getWeeklyArtistChart
+     * @returns Weekly artist chart
+     */
+    const getWeeklyArtistChart = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Weekly chart list - LastFM
+     *
+     * https://www.last.fm/api/show/user.getWeeklyChartList
+     * @returns Weekly chart list
+     */
+    const getWeeklyChartList = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    /**
+     * GET: Weekly track chart - LastFM
+     *
+     * https://www.last.fm/api/show/user.getWeeklyTrackChart
+     * @returns Weekly track chart
+     */
+    const getWeeklyTrackChart = (method, user, period, limit) => {
+        return (0, request_1.default)(method, user, period, limit);
+    };
+    return {
+        auth,
+        getInfo,
+        getLovedTracks,
+        getRecentTracks,
+        getTopAlbums,
+        getTopArtists,
+        getTopTracks,
+        getWeeklyAlbumChart,
+        getWeeklyArtistChart,
+        getWeeklyChartList,
+        getWeeklyTrackChart,
+    };
+};
+exports.default = LastFmApi;

package/dist/request.js

@@ -0,0 +1,29 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fetch_1 = __importDefault(require("node-fetch"));
+const config_1 = __importDefault(require("./config"));
+const request = (method, user, period, limit) => __awaiter(void 0, void 0, void 0, function* () {
+    const url = `
+      ${config_1.default.base_url}?method=${method}${user ? '&user=' : ''}${user}${user ? '&user=' : ''}${user}${period ? '&period=' : ''}${period}&${limit ? '&limit=' : ''}${limit}&api_key=${config_1.default.api_key}&format=${config_1.default.format.json}`;
+    return (yield (0, node_fetch_1.default)(url, {
+        headers: {
+            'Content-Type': 'application/json',
+        },
+    })
+        .then((res) => res.json())
+        .then((json) => json)
+        .catch((error) => console.log('🔥 Uh oh...', error)));
+});
+exports.default = request;

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "lastfm-nodejs-client",
+  "version": "1.0.0",
+  "description": "A client for fetching public data with username using the LastFm public API",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "rimraf dist && tsc",
+    "dev": "tsc --watch",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "client",
+    "lastfm",
+    "nodejs",
+    "typescript"
+  ],
+  "author": "Mannuel Ferreira",
+  "license": "MIT",
+  "dependencies": {
+    "node-fetch": "^3.2.10",
+    "rimraf": "^3.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^18.11.7",
+    "typescript": "^4.8.4"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mannuelf/lastfm-nodejs-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mannuelf/lastfm-nodejs-client/issues"
+  },
+  "homepage": "https://github.com/mannuelf/lastfm-nodejs-client#readme"
+}

package/src/config.ts

@@ -0,0 +1,28 @@
+const config = {
+  api_key: `${process.env.LASTFM_API_KEY}`,
+  app_name: `${process.env.LASTFM_APPNAME}`,
+  base_url: `${process.env.LASTFM_API_BASE_URL}`,
+  format: {
+    json: 'json',
+    xml: 'xml',
+  },
+  method: {
+    auth: 'auth.getToken',
+    user: {
+      getInfo: 'user.getInfo',
+      loved_tracks: 'user.getLovedTracks',
+      recent_tracks: 'user.getRecentTracks',
+      top_albums: 'user.getTopAlbums',
+      top_artists: 'user.getTopArtists',
+      top_tracks: 'user.getTopTracks',
+      weekly_album_chart: 'user.getWeeklyAlbumChart',
+      weekly_artist_chart: 'user.getWeeklyArtistChart',
+      weekly_chart_list: 'user.getWeeklyChartList',
+      weekly_track_chart: 'user.getWeeklyTrackChart',
+    },
+  },
+  share_secret: `${process.env.LASTFM_SHARED_SECRET}`,
+  username: `${process.env.LASTFM_USER}`,
+};
+
+export default config;

package/src/index.ts

@@ -0,0 +1,201 @@
+import {
+  AuthResponse,
+  LovedTracksResponse,
+  RecentTracksResponse,
+  TopAlbumsResponse,
+  TopArtistsResponse,
+  TopTrackResponse,
+  UserResponse,
+  WeeklyAlbumChartResponse,
+  WeeklyArtistChartResponse,
+  WeeklyChartListResponse,
+  WeeklyTrackChartResponse,
+} from './types';
+import request from './request';
+
+const LastFmApi = function LastFmApi() {
+  /**
+   * POST: Auth - LastFM
+   *
+   * https://www.last.fm/api/show/auth.getToken
+   *
+   * Authentication tokens are API account specific.
+   * They are valid for 60 minutes from the moment they are granted.
+   * Can only used once (they are consumed when a session is created).
+   * @returns Auth token
+   */
+  const auth = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<AuthResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: User profile information - LastFM
+   *
+   * https://www.last.fm/api/show/user.getInfo
+   * @returns User profile data
+   */
+  const getInfo = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<UserResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Love Tracks - LastFM
+   *
+   * https://www.last.fm/api/show/user.getLovedTracks
+   * @returns Loved Tracks;
+   */
+  const getLovedTracks = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<LovedTracksResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Recent Tracks - LastFM
+   *
+   * https://www.last.fm/api/show/user.getRecentTracks
+   * @returns Recent Tracks
+   */
+  const getRecentTracks = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<RecentTracksResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Top Albums - LastFM
+   *
+   * https://www.last.fm/api/show/user.getTopAlbums
+   * @returns Top Albums
+   */
+  const getTopAlbums = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<TopAlbumsResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Top Artist - LastFM
+   *
+   * https://www.last.fm/api/show/user.getTopArtists
+   * @returns Top Artists
+   */
+  const getTopArtists = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<TopArtistsResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Top Tracks - LastFM
+   *
+   * https://www.last.fm/api/show/user.getTopTracks
+   * @returns Top Tracks
+   */
+  const getTopTracks = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<TopTrackResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Weekly album chart - LastFM
+   *
+   * https://www.last.fm/api/show/user.getWeeklyAlbumChart
+   * @returns Weekly album chart
+   */
+  const getWeeklyAlbumChart = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<WeeklyAlbumChartResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Weekly artist chart - LastFM
+   *
+   * https://www.last.fm/api/show/user.getWeeklyArtistChart
+   * @returns Weekly artist chart
+   */
+  const getWeeklyArtistChart = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<WeeklyArtistChartResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Weekly chart list - LastFM
+   *
+   * https://www.last.fm/api/show/user.getWeeklyChartList
+   * @returns Weekly chart list
+   */
+  const getWeeklyChartList = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<WeeklyChartListResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  /**
+   * GET: Weekly track chart - LastFM
+   *
+   * https://www.last.fm/api/show/user.getWeeklyTrackChart
+   * @returns Weekly track chart
+   */
+  const getWeeklyTrackChart = (
+    method: string,
+    user: string,
+    period: string,
+    limit: number
+  ): Promise<WeeklyTrackChartResponse> => {
+    return request(method, user, period, limit);
+  };
+
+  return {
+    auth,
+    getInfo,
+    getLovedTracks,
+    getRecentTracks,
+    getTopAlbums,
+    getTopArtists,
+    getTopTracks,
+    getWeeklyAlbumChart,
+    getWeeklyArtistChart,
+    getWeeklyChartList,
+    getWeeklyTrackChart,
+  };
+};
+
+export default LastFmApi;

package/src/request.ts

@@ -0,0 +1,27 @@
+import fetch from 'node-fetch';
+import config from './config';
+
+const request = async <Parameters, Response>(
+  method: string,
+  user: string,
+  period?: string,
+  limit?: number
+): Promise<Response> => {
+  const url = `
+      ${config.base_url}?method=${method}${user ? '&user=' : ''}${user}${
+    user ? '&user=' : ''
+  }${user}${period ? '&period=' : ''}${period}&${
+    limit ? '&limit=' : ''
+  }${limit}&api_key=${config.api_key}&format=${config.format.json}`;
+
+  return (await fetch(url, {
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  })
+    .then((res) => res.json())
+    .then((json) => json)
+    .catch((error) => console.log('🔥 Uh oh...', error))) as Response;
+};
+
+export default request;

package/src/types.d.ts

@@ -0,0 +1,295 @@
+export interface AuthResponse {
+  token: string;
+}
+
+export interface LovedTracksResponse {
+  lovedtracks: LovedTracks;
+}
+
+export interface LovedTracks {
+  track: Track[];
+  '@attr': Attr;
+}
+export interface TopAlbumsResponse {
+  topalbums: TopAlbums;
+}
+
+export interface TopTrackResponse {
+  toptracks: TopTracks;
+}
+
+export interface TopTracks {
+  track: Track[];
+  '@attr': Attr2;
+}
+
+export interface UserResponse {
+  user: User;
+}
+
+export interface RecentTracksResponse {
+  recenttracks: RecentTracks;
+}
+
+export interface RecentTracks {
+  track: Track[];
+  '@attr': Attr2;
+}
+
+export interface LoveTracksResponse {
+  lovedtracks: LovedTracks;
+}
+
+export interface LovedTracks {
+  track: Track[];
+  '@attr': Attr;
+}
+export interface FriendsResponse {
+  friends: Friends;
+}
+
+export interface Friends {
+  '@attr': Attr;
+  user: User[];
+}
+
+export interface TopArtistsResponse {
+  topartists: TopArtists;
+}
+
+export interface TopArtists {
+  artist: Artist[];
+  '@attr': Attr2;
+}
+
+export interface WeeklyArtistChartResponse {
+  weeklyartistchart: WeeklyArtistChart;
+}
+
+export interface WeeklyArtistChart {
+  artist: Artist[];
+  '@attr': Attr2;
+}
+
+export interface WeeklyAlbumChartResponse {
+  weeklyalbumchart: WeeklyAlbumChart;
+}
+
+export interface WeeklyAlbumChart {
+  album: WeeklyAlbum[];
+  '@attr': WeeklyalbumChartAttr;
+}
+
+export type WeeklyAlbum = {
+  artist: {
+    mbid: string;
+    '#text': string;
+  };
+  mbid: string;
+  url: string;
+  name: string;
+  '@attr': { rank: string };
+  playcount: string;
+  image?: string;
+};
+
+export interface WeeklyalbumChartAttr {
+  from: string;
+  to: string;
+  user: string;
+}
+
+export interface AlbumAttr {
+  rank: string;
+}
+
+export type Artist = {
+  '@attr': {
+    rank: number;
+  };
+  cover: ArtistImage;
+  image?: string;
+  mbid: string;
+  name: string;
+  playcount: number;
+  streamable: number;
+  url: string;
+  '#text': string;
+};
+
+export interface Attribs {
+  page: number;
+  perPage: number;
+  user: string;
+  total: number;
+  totalPages: number;
+}
+
+export interface ArtistImage {
+  name: string;
+  photo: string;
+  attribution: string;
+  playcount: number;
+}
+
+export interface Album {
+  mbid: string;
+  '#text': string;
+}
+
+export interface Attr {
+  nowplaying: string;
+}
+
+export interface Date {
+  uts: string;
+  '#text': string;
+}
+
+export interface Track {
+  artist: Artist;
+  streamable: string;
+  image: '';
+  mbid: string;
+  album: Album;
+  name: string;
+  '@attr': Attr;
+  url: string;
+  date: Date;
+}
+
+export interface Attr2 {
+  user: string;
+  totalPages: string;
+  page: string;
+  perPage: string;
+  total: string;
+}
+
+export interface RecentTracks {
+  track: Track[];
+  '@attr': Attr2;
+}
+
+export interface Image {
+  size: string;
+  '#text': string;
+}
+
+export interface Registered {
+  unixtime: string;
+  '#text': number;
+}
+
+export interface User {
+  name: string;
+  age: string;
+  subscriber: string;
+  realname: string;
+  bootstrap: string;
+  playcount: string;
+  artist_count: string;
+  playlists: string;
+  track_count: string;
+  album_count: string;
+  image: Image[];
+  registered: Registered;
+  country: string;
+  gender: string;
+  url: string;
+  type: string;
+}
+
+export interface TopAlbums {
+  album: Album[];
+  '@attr': Attr2;
+}
+
+export interface WeeklyArtistChartResponse {
+  weeklyartistchart: WeeklyArtistChart;
+}
+
+export interface WeeklyArtistChart {
+  artist: Artist[];
+  '@attr': Attr2;
+}
+
+export interface Attr1 {
+  rank: string;
+}
+
+export interface Attr2 {
+  from: string;
+  user: string;
+  to: string;
+}
+
+export interface WeeklyChartListResponse {
+  weeklychartlist: WeeklyChartList;
+}
+
+export interface WeeklyChartList {
+  chart: WeeklyChartListChart[];
+  '@attr': WeeklyChartListAttr;
+}
+
+export interface WeeklyChartListChart {
+  '#text': string;
+  from: string;
+  to: string;
+}
+
+export interface WeeklyChartListAttr {
+  user: string;
+}
+
+export interface WeeklyTrackChartResponse {
+  weeklytrackchart: WeeklyTrackChart;
+}
+
+export interface WeeklyTrackChart {
+  track: Track[];
+  '@attr': WeeklyTrackChartAttr2;
+}
+
+export interface WeeklyTrackChartTrack {
+  artist: WeeklyTrackChartArtist;
+  image: Image[];
+  mbid: string;
+  url: string;
+  name: string;
+  '@attr': Attr;
+  playcount: string;
+}
+
+export interface WeeklyTrackChartArtist {
+  mbid: string;
+  '#text': string;
+}
+
+export interface WeeklyTrackChartAttr {
+  rank: string;
+}
+
+export interface WeeklyTrackChartAttr2 {
+  from: string;
+  user: string;
+  to: string;
+}
+
+export enum Errors {
+  'InvalidService' = 2,
+  'InvalidMethod' = 3,
+  'AuthenticationFailed' = 4,
+  'Invalid format' = 5,
+  'Invalid parameters' = 6,
+  'InvalidResourceSpecified' = 7,
+  'OperationFailed' = 8,
+  'Invalid session key' = 9,
+  'InvalidApiKey' = 10,
+  'ServiceOffline' = 11,
+  'InvalidMethodSignatureSupplied' = 13,
+  'TemporaryErrorRequest' = 16,
+  'SuspendedApiKey' = 26,
+  'RateLimitExceeded' = 29,
+}

package/tsconfig.json

@@ -0,0 +1,103 @@
+{
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig to read more about this file */
+
+    /* Projects */
+    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+
+    /* Language and Environment */
+    "target": "ES2015" /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */,
+    // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
+    // "jsx": "preserve",                                /* Specify what JSX code is generated. */
+    // "experimentalDecorators": true,                   /* Enable experimental support for TC39 stage 2 draft decorators. */
+    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+    // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+
+    /* Modules */
+    "module": "Node16" /* Specify what module code is generated. */,
+    "rootDir": "./src" /* Specify the root folder within your source files. */,
+    "moduleResolution": "node" /* Specify how TypeScript looks up a file from a given module specifier. */,
+    // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+    // "resolveJsonModule": true,                        /* Enable importing .json files. */
+    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+
+    /* JavaScript Support */
+    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+
+    /* Emit */
+    // "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+    // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    "outDir": "./dist" /* Specify an output folder for all emitted files. */,
+    // "removeComments": true,                           /* Disable emitting comments. */
+    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+
+    /* Interop Constraints */
+    "isolatedModules": true /* Ensure that each file can be safely transpiled without relying on other imports. */,
+    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+    "esModuleInterop": true /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */,
+    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+    "forceConsistentCasingInFileNames": true /* Ensure that casing is correct in imports. */,
+
+    /* Type Checking */
+    "strict": true /* Enable all strict type-checking options. */,
+    "noImplicitAny": true /* Enable error reporting for expressions and declarations with an implied 'any' type. */,
+    "strictNullChecks": true /* When type checking, take into account 'null' and 'undefined'. */,
+    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
+    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
+    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+
+    /* Completeness */
+    "skipDefaultLibCheck": true /* Skip type checking .d.ts files that are included with TypeScript. */,
+    "skipLibCheck": true /* Skip type checking all .d.ts files. */
+  }
+}