Original files. Subject to change.

Author: Ethan Davis

.gitignore

@@ -0,0 +1,48 @@
+.eslintrc.json
+.DS_Store
+*.tgz
+
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Only dev-dependencies
+package-lock.json
+
+# Env information / sensitive data
+.env
+pids
+*.pid
+*.seed
+*.pid.lock
+sftp-config.json
+
+# Don't include dep directories.
+node_modules/
+jspm_packages/
+
+# NPM cache
+.npm
+
+# Node REPL history
+.node_repl_history
+
+*.tmlanguage.cache
+*.tmPreferences.cache
+*.stTheme.cache
+
+*.sublime-workspace
+
+# Sublime Package Control files
+Package Control.last-run
+Package Control.ca-list
+Package Control.ca-bundle
+Package Control.system-ca-bundle
+Package Control.cache/
+Package Control.ca-certs/
+Package Control.merged-ca-bundle
+Package Control.user-ca-bundle
+oscrypto-ca-bundle.crt
+bh_unicode_properties.cache

.npmignore

@@ -0,0 +1,20 @@
+# NPM, Yarn, Travis ignores
+
+.eslintrc.json
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pids
+*.pid
+*.seed
+*.pid.lock
+.npm
+*.tgz
+.travis.yml
+
+# Core resource ignores
+
+docs/
+media/

.travis.yml

@@ -0,0 +1,6 @@
+language: node_js
+node_js:
+  - "node"
+  - "8"
+  - "7"
+  - "6"

LICENSE.md

@@ -0,0 +1,7 @@
+License information: https://github.com/omnent/omnent-licenses/blob/master/licenses/OMv2-FO.txt
+
+Copyright 2017 Ethan Davis
+
+Permission is hereby granted, for free, to any person obtaining a copy of this software and associated documentation files (collectively "the Software" or "THE SOFTWARE"), to (without restriction) use, modify, copy, publish, execute, distribute, sublicense, and sell the Software and to allow people who gain access to the Software to do the same as long as this entire license and the above copyright notice are included in all copies or portions of the Software.
+
+NOTWITHSTANDING ANYTHING IN CONTRADICTION, THE AUTHORS AND COPYRIGHT HOLDERS OF THE SOFTWARE SHALL UNDER NO CIRCUMSTANCES BE HELD LIABLE FOR ANY DAMAGES, CLAIM, OR OTHER LIABILITY RELATED TO, IN CONNECTION WITH, OR CAUSED BY USE OR DISTRIBUTION OF THE SOFTWARE. THE SOFTWARE IS PROVIDED "AS-IS" AND IS NOT PROVIDED WITH WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NONINFRINGEMENT, AND ANY WARRANTY ARISING OUR OF PRIOR COURSE OF DEALING AND USAGE OF TRADE.

README.md

@@ -1,2 +1,13 @@
-# hypixel-api
-A light Hypixel Public API client for Node
+<p align="center" style="text-align: center;"><img src="https://api.hypixel.net/assets/images/logo.png" width="300" alt="Hypixel logo"/></p>
+
+---
+
+> A light Hypixel Public API client for Node
+
+[Full documentation](https://ethanent.github.io/hypixel-api/) | [GitHub](https://github.com/ethanent/hypixel-api) | [NPM](https://www.npmjs.com/package/hypixel-api)
+
+## Installation
+
+```shell
+npm install --save hypixel-api
+```

class/Client.js

@@ -0,0 +1,58 @@
+const path = require('path')
+const pp = require('phin').promisified
+
+const Player = require(path.join(__dirname, 'Player.js'))
+
+/**
+* Main Client class. API keys are used to create client instances.
+*/
+class Client {
+	constructor (key) {
+		this.key = key
+	}
+
+	/**
+	* Get a Player instance for a player.
+	* @param {string} [targetType=uuid] - Target type. 'name' or 'uuid'
+	* @param {string} identifier - Identifier for the target. (Either a name or UUID, based on targetType.)
+	*/
+	async getPlayer(p1, p2) {
+		const targetType = (p2 ? p1 : 'uuid')
+		const identifier = (p2 ? p2 : p1)
+
+		if (targetType === 'name') {
+			let playerResolution = await pp({
+				'url': 'https://api.mojang.com/profiles/minecraft',
+				'method': 'POST',
+				'data': JSON.stringify([identifier])
+			})
+
+			if (playerResolution.statusCode === 200) {
+				let body
+				try {
+					body = JSON.parse(playerResolution.body)
+
+					if (!Array.isArray(body)) throw 'Not array'
+				}
+				catch (err) {
+					throw new Error('Invalid response recieved from Mojang UUID resolution endpoint.')
+				}
+
+				if (body.length > 0) {
+					return new Player(body[0].id, this.key)
+				}
+				else {
+					throw new Error('Player does not exist.')
+				}
+			}
+			else {
+				throw new Error('Unexpected status code from Mojang UUID resolution endpoint.')
+			}
+		}
+		else {
+			return new Player(identifier, this.key)
+		}
+	}
+}
+
+module.exports = Client

class/Player.js

@@ -0,0 +1,49 @@
+const path = require('path')
+const p = require('phin')
+
+/**
+* Player class, used to represent players.
+*/
+class Player {
+	constructor (uuid, key) {
+		this.uuid = uuid
+		this.key = key
+	}
+
+	/**
+	* Get the player's name using Mojang's API
+	*/
+	get name() {
+		p({
+			'url': 'https://api.mojang.com/users/profiles/minecraft/' + encodeURIComponent(this.uuid),
+			'method': 'GET'
+		}, (err, res) => {
+			if (err) throw err
+
+			if (res.statusCode === 200) {
+				return JSON.parse(res.body).name
+			}
+			else {
+				throw new Error('Mojang name resolution endpoint failed to respond as expected.')
+			}
+		})
+	}
+
+	async getData() {
+		p({
+			'url': 'https://api.hypixel.net/player?uuid=' + encodeURIComponent(this.uuid) + '&key=' + encodeURIComponent(this.key),
+			'method': 'GET'
+		}, (err, res) => {
+			if (err) throw err
+
+			if (res.statusCode === 200) {
+				return JSON.parse(res.body.toString()).player
+			}
+			else {
+				throw new Error('API endpoint gave unexpected response.')
+			}
+		})
+	}
+}
+
+module.exports = Player

index.js

@@ -0,0 +1,3 @@
+const path = require('path')
+
+module.exports = require(path.join(__dirname, 'class', 'Client.js'))

package.json

@@ -0,0 +1,30 @@
+{
+  "name": "hypixel-api",
+  "version": "1.0.0",
+  "description": "A light Hypixel Public API client for Node",
+  "main": "index.js",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ethanent/hypixel-api.git"
+  },
+  "keywords": [
+    "hypixel",
+    "hypixel-api",
+    "api-client",
+    "client",
+    "api",
+    "minecraft"
+  ],
+  "author": "Ethan Davis",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "bugs": {
+    "url": "https://github.com/ethanent/hypixel-api/issues"
+  },
+  "homepage": "https://github.com/ethanent/hypixel-api#readme",
+  "dependencies": {
+    "phin": "^2.4.18"
+  }
+}