Start to JS library

Author: LinkofOrigin

libraries/javascript/.gitignore

@@ -0,0 +1,5 @@
+# Ignore Node installs
+node_modules/
+
+# Ignore secrets files
+*secrets*

libraries/javascript/README.md

@@ -0,0 +1,30 @@
+# JavaScript Library for IGDB
+
+A JavaScript library for interacting with IGDB - a database of video game data. This implementation utilizes the Apicalypse module provided by IGDB to assist with request building.
+
+## Testing Setup
+
+You can test the library out-of-the-box with some simple setup.
+
+1. Install the latest stable versions of Node and NPM.
+2. Clone/Download the project.
+3. From the root directory of the library, run `npm install`.
+4. Store client credentials (details below).
+5. From the project directory, run `node app.js`.
+6. Observe output data.
+
+## Client Credentials
+
+You will need to create a file for storing your client credentials. Typically these secrets would be handled through your server environment, but for basic testing you can create this secrets file to immediately test the library.
+
+Reminder: DON'T COMMIT SECRETS TO VERSION CONTROL!
+
+### Twitch Account for Authentication
+
+IGDB is owned and operated by Twitch.tv. In order to authenticate with the api, you will need an active Twitch account and register a developer application with it to acquire a Client ID and Client Secret. See IGDB's documentation here for details: [IGDB Account Creation](https://api-docs.igdb.com/#account-creation)
+
+### Create Secrets File
+
+1. Create a `secrets.json` file at the project root.
+2. Add two fields called `clientId` and `clientSecret`.
+3. Set those values to their respective values from your Twitch Developer App.

libraries/javascript/app.js

@@ -0,0 +1,53 @@
+import IGDB_Helper from "./src/igdb/igdb_api.js";
+import TwitchAPI from "./src/twitch_oauth/twitch_oauth.js";
+import fs from 'fs';
+
+function getCredentials() {
+    console.log("Retrieving client ID and client secret");
+    const secrets = fs.readFileSync("./secrets.json");
+    const secretsJSON = JSON.parse(secrets);
+    return secretsJSON;
+}
+
+async function getAPIToken(clientId, clientSecret) {
+    console.log("Requesting API token from Twitch");
+    const twichApi = new TwitchAPI();
+    const apiTokenResult = await twichApi.requestOauthToken(clientId, clientSecret);
+    return apiTokenResult.access_token;
+}
+
+async function getGameData(clientId, apiToken) {
+    console.log("Pulling game data from IGDB");
+    const igdb = new IGDB_Helper();
+    const igdbRequest = igdb.createRequest(clientId, apiToken);
+
+    igdbRequest
+        .fields("name, release_dates")
+        .limit(1);
+
+    const responseData = await igdbRequest.request("/games")
+        .then(async (result) => {
+            if (result.status !== 200) {
+                console.log("Unexpected response from IGDB! Received: " + await result.text());
+                throw new Error("Received bad result from IGDB API!");
+            }
+
+            return result.data;
+        })
+        .then((data) => {
+            console.log("Successfully retrieved data from IGDB API.");
+            return data;
+        });
+
+    return responseData;
+}
+
+const credentials = getCredentials();
+const token = await getAPIToken(credentials.clientId, credentials.clientSecret);
+const gameData = await getGameData(credentials.clientId, token);
+
+const firstGame = gameData[0];
+const firstGameName = firstGame.name;
+let firstGameRelease = new Date(firstGame.release_dates[0]);
+firstGameRelease = firstGameRelease.toLocaleDateString();
+console.log(`Retrieved game ${firstGameName} released at ${firstGameRelease}`);