hive-bedrock-api 2.1.8 → 2.1.10-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,136 +1,136 @@
1
- # Hive Bedrock API
2
-
3
- An API wrapper for the Hive Minecraft Bedrock Edition server. Which allows you to get stats for leaderboards, players, cosmetics, unique player counts, maps and metadata.
4
-
5
- ## Getting started
6
-
7
- ```bash
8
- $ npm install hive-bedrock-api
9
- $ yarn add hive-bedrock-api
10
- ```
11
-
12
- ## Usage
13
-
14
- See [API.md](docs/API.md) for detailed documentation.
15
-
16
- ### Fetch Player Infomation
17
-
18
- ```ts
19
- import { getPlayerInformation } from "hive-bedrock-api";
20
-
21
- // Returns player, cosmetics, server statistics and profile infomation
22
- const { data, error } = await getPlayerInformation("player");
23
- ```
24
-
25
- ### Fetch All-Time Player Statistics
26
-
27
- ```ts
28
- import { getAllTimeStatistics, Game } from "hive-bedrock-api";
29
-
30
- // Returns all games
31
- const { data, error } = await getAllTimeStats("player");
32
-
33
- // Returns a single game
34
- const { data, error } = await getAllTimeStats("player", Game.HideAndSeek);
35
- ```
36
-
37
- ### Fetch Season Player Statistics
38
-
39
- ```ts
40
- import { getSeasonStatistics, Game } from "hive-bedrock-api";
41
-
42
- // Returns a game statistics
43
- const { data, error } = await getSeasonStatistics("player", Game.BedWars);
44
- ```
45
-
46
- ### Fetch Monthly Player Statistics
47
-
48
- ```ts
49
- import { getMonthlyStatistics, Game } from "hive-bedrock-api";
50
-
51
- // Returns all games
52
- const { data, error } = await getMonthlyStats("player");
53
-
54
- // Returns a single game
55
- const { data, error } = await getMonthlyStats("player", Game.BlockDrop);
56
-
57
- // Returns a single game in a previous month (can return muliple games)
58
- const { data, error } = await getMonthlyStats("player", Game.BlockDrop, {
59
- year: 2023,
60
- month: 1, // January
61
- });
62
- ```
63
-
64
- ### Fetch All-Time Leaderboard
65
-
66
- ```ts
67
- import { getAllTimeLeaderboard, Game } from "hive-bedrock-api";
68
-
69
- // Returns a single game
70
- const { data, error } = await getAllTimeLeaderboard(Game.TreasureWars);
71
- ```
72
-
73
- ### Fetch Season Leaderboard
74
-
75
- ```ts
76
- import { getSeasonLeaderboard, Game } from "hive-bedrock-api";
77
-
78
- // Returns a single game
79
- const { data, error } = await getSeasonLeaderboard(Game.BedWars);
80
- ```
81
-
82
- ### Fetch Monthly Leaderboard
83
-
84
- ```ts
85
- import { getMonthlyLeaderboard, Game } from "hive-bedrock-api";
86
-
87
- // Returns a single game
88
- const { data, error } = await getMonthlyLeaderboard(Game.TreasureWars);
89
-
90
- // Returns a single game from a previous month
91
- const { data, error } = await getMonthlyLeaderboard(Game.BlockParty, {
92
- year: 2023,
93
- month: 11, // November
94
- amount: 50,
95
- skip: 20, // Sum of skip and amount must be <=100
96
- });
97
- ```
98
-
99
- ### Fetch Global Statistics
100
-
101
- ```ts
102
- import { getGlobalStatistics } from "hive-bedrock-api";
103
-
104
- // Returns unqiue total player counts for different games
105
- const { data, error } = await getGlobalStatistics();
106
- ```
107
-
108
- ### Fetch Maps
109
-
110
- ```ts
111
- import { getMaps, Game } from "hive-bedrock-api";
112
-
113
- // Returns data for a specific game's currently active maps
114
- const { data, error } = await getMaps(Game.TreasureWars);
115
- ```
116
-
117
- ### Fetch Metadata
118
-
119
- ```ts
120
- import { getMetadata, Game } from "hive-bedrock-api";
121
-
122
- // Returns data for a specific game's currently active maps
123
- const { data, error } = await getMetadata(Game.TreasureWars);
124
- ```
125
-
126
- ## API Response Changes
127
-
128
- Different API responses are edited by the wrapper to provide more data:
129
-
130
- - Game responses have a new value "id" showing the parent game
131
- - A new value for "losses" is provided
132
- - A new value for "kdr" is provided
133
- - "xp" is converted and a "level" is provided
134
- - "total_ratings" for just build is provided
135
-
136
- See [API.md](docs/API.md#game-statistics-types) for specific fields and their corresponding types per game.
1
+ # Hive Bedrock API
2
+
3
+ An API wrapper for the Hive Minecraft Bedrock Edition server. Which allows you to get stats for leaderboards, players, cosmetics, unique player counts, maps and metadata.
4
+
5
+ ## Getting started
6
+
7
+ ```bash
8
+ $ npm install hive-bedrock-api
9
+ $ yarn add hive-bedrock-api
10
+ ```
11
+
12
+ ## Usage
13
+
14
+ See [API.md](docs/API.md) for detailed documentation.
15
+
16
+ ### Fetch Player Infomation
17
+
18
+ ```ts
19
+ import { getPlayerInformation } from "hive-bedrock-api";
20
+
21
+ // Returns player, cosmetics, server statistics and profile infomation
22
+ const { data, error } = await getPlayerInformation("player");
23
+ ```
24
+
25
+ ### Fetch All-Time Player Statistics
26
+
27
+ ```ts
28
+ import { getAllTimeStatistics, Game } from "hive-bedrock-api";
29
+
30
+ // Returns all games
31
+ const { data, error } = await getAllTimeStats("player");
32
+
33
+ // Returns a single game
34
+ const { data, error } = await getAllTimeStats("player", Game.HideAndSeek);
35
+ ```
36
+
37
+ ### Fetch Season Player Statistics
38
+
39
+ ```ts
40
+ import { getSeasonStatistics, Game } from "hive-bedrock-api";
41
+
42
+ // Returns a game statistics
43
+ const { data, error } = await getSeasonStatistics("player", Game.BedWars);
44
+ ```
45
+
46
+ ### Fetch Monthly Player Statistics
47
+
48
+ ```ts
49
+ import { getMonthlyStatistics, Game } from "hive-bedrock-api";
50
+
51
+ // Returns all games
52
+ const { data, error } = await getMonthlyStats("player");
53
+
54
+ // Returns a single game
55
+ const { data, error } = await getMonthlyStats("player", Game.BlockDrop);
56
+
57
+ // Returns a single game in a previous month (can return muliple games)
58
+ const { data, error } = await getMonthlyStats("player", Game.BlockDrop, {
59
+ year: 2023,
60
+ month: 1, // January
61
+ });
62
+ ```
63
+
64
+ ### Fetch All-Time Leaderboard
65
+
66
+ ```ts
67
+ import { getAllTimeLeaderboard, Game } from "hive-bedrock-api";
68
+
69
+ // Returns a single game
70
+ const { data, error } = await getAllTimeLeaderboard(Game.TreasureWars);
71
+ ```
72
+
73
+ ### Fetch Season Leaderboard
74
+
75
+ ```ts
76
+ import { getSeasonLeaderboard, Game } from "hive-bedrock-api";
77
+
78
+ // Returns a single game
79
+ const { data, error } = await getSeasonLeaderboard(Game.BedWars);
80
+ ```
81
+
82
+ ### Fetch Monthly Leaderboard
83
+
84
+ ```ts
85
+ import { getMonthlyLeaderboard, Game } from "hive-bedrock-api";
86
+
87
+ // Returns a single game
88
+ const { data, error } = await getMonthlyLeaderboard(Game.TreasureWars);
89
+
90
+ // Returns a single game from a previous month
91
+ const { data, error } = await getMonthlyLeaderboard(Game.BlockParty, {
92
+ year: 2023,
93
+ month: 11, // November
94
+ amount: 50,
95
+ skip: 20, // Sum of skip and amount must be <=100
96
+ });
97
+ ```
98
+
99
+ ### Fetch Global Statistics
100
+
101
+ ```ts
102
+ import { getGlobalStatistics } from "hive-bedrock-api";
103
+
104
+ // Returns unqiue total player counts for different games
105
+ const { data, error } = await getGlobalStatistics();
106
+ ```
107
+
108
+ ### Fetch Maps
109
+
110
+ ```ts
111
+ import { getMaps, Game } from "hive-bedrock-api";
112
+
113
+ // Returns data for a specific game's currently active maps
114
+ const { data, error } = await getMaps(Game.TreasureWars);
115
+ ```
116
+
117
+ ### Fetch Metadata
118
+
119
+ ```ts
120
+ import { getMetadata, Game } from "hive-bedrock-api";
121
+
122
+ // Returns data for a specific game's currently active maps
123
+ const { data, error } = await getMetadata(Game.TreasureWars);
124
+ ```
125
+
126
+ ## API Response Changes
127
+
128
+ Different API responses are edited by the wrapper to provide more data:
129
+
130
+ - Game responses have a new value "id" showing the parent game
131
+ - A new value for "losses" is provided
132
+ - A new value for "kdr" is provided
133
+ - "xp" is converted and a "level" is provided
134
+ - "total_ratings" for just build is provided
135
+
136
+ See [API.md](docs/API.md#game-statistics-types) for specific fields and their corresponding types per game.
@@ -9,8 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
9
9
  });
10
10
  };
11
11
  var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
13
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
14
  function verb(n) { return function (v) { return step([n, v]); }; }
15
15
  function step(op) {
16
16
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -9,8 +9,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
9
9
  });
10
10
  };
11
11
  var __generator = (this && this.__generator) || function (thisArg, body) {
12
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
13
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
12
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
13
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
14
14
  function verb(n) { return function (v) { return step([n, v]); }; }
15
15
  function step(op) {
16
16
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
20
20
  });
21
21
  };
22
22
  var __generator = (this && this.__generator) || function (thisArg, body) {
23
- var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
24
- return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
23
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
24
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
25
25
  function verb(n) { return function (v) { return step([n, v]); }; }
26
26
  function step(op) {
27
27
  if (f) throw new TypeError("Generator is already executing.");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hive-bedrock-api",
3
- "version": "2.1.8",
3
+ "version": "2.1.10-alpha.0",
4
4
  "description": "An API wrapper for the Hive Minecraft Bedrock Edition server.",
5
5
  "main": "lib/index.js",
6
6
  "types": "lib/index.d.ts",
@@ -11,7 +11,7 @@
11
11
  "license": "MIT",
12
12
  "author": "Cubeedge Studios",
13
13
  "dependencies": {
14
- "hive-bedrock-data": "^1.2.5"
14
+ "hive-bedrock-data": "^1.2.6-alpha.0"
15
15
  },
16
16
  "scripts": {
17
17
  "build": "tsc"
@@ -22,5 +22,6 @@
22
22
  "devDependencies": {
23
23
  "ts-node": "^10.9.1",
24
24
  "typescript": "^5.1.3"
25
- }
25
+ },
26
+ "gitHead": "ff428fe165eb3035cb801ffc9613d669c5437437"
26
27
  }