betterstackmanager 0.0.1 → 0.2.0

package/README.md

@@ -9,8 +9,8 @@ There is a required node version, and it is `>= 6.0.0`.
 You must clone this repository (or, at least, the `src` directory) and require the Client object.
 
 ```js
-const BSM = require('./src/client/index');
-const client = new BSM();
+const BSM = require('betterstackmanager');
+const client = new BSM.Client();
 const config = require('./config.json');
 
 client.login(config.token);
@@ -31,10 +31,15 @@ The documentation for this project is contained within the `docs` directory.
 ## Links
 
 - [Documentation](https://codeberg.org/Cyanic76/BSM.js/src/branch/main/docs)
-- [Discord server](https://cyanic.me/next)
+- [Source Code](https://codeberg.org/Cyanic76/BSM.js/)
+- [Discord server](https://cyanic.me/discord)
+
+Get the package on
+[Codeberg](https://codeberg.org/Cyanic76/-/packages/npm/betterstackmanager/) or on
+[NPM](https://www.npmjs.com/package/betterstackmanager).
 
 ## Contributing & Help
 
 As always, if you're in need of help, don't hesitate to create a new issue or to [join my Discord server](https://cyanic.me/discord).
 
-This project abides by the CCoC.
+This project abides by the [CCoC](https://codeberg.org/Cyanic76/pages/src/branch/pages/CODE_OF_CONDUCT.md).

package/docs/classes/Client.md

@@ -6,7 +6,15 @@ The `Client` interface is the main entry point to interact with BetterStack.
 
 ## `client`
 
-`new Client(token)`
+This function defines your BetterStack API client.
+
+`new Client()`
+
+## client.login(token)
+
+`client.login(token)`
+
+This function is the point where your token is first used.
 
 | Value | Type | Required | About |
 |-|-|-|-|
@@ -14,4 +22,12 @@ The `Client` interface is the main entry point to interact with BetterStack.
 
 ## Classes
 
-The Client constructor includes the `incidents` class.
+The Client constructor includes the following classes.
+
+- `incidentComments`
+- `incidents`,
+- `monitors`
+
+## Event listeners
+
+The Client constructor does not currently listen to any upstream event.

package/docs/classes/Error.md

@@ -14,14 +14,14 @@ The errors generated via this module fall in 3 categories:
 | status | HTTP Response code (usually 4XX or 5XX) |
 | data | The error data. |
 
-# NetworkError
+## NetworkError
 
 | Value | Type |
 |-|-|
 | name | `NetworkError` |
 | message | The error message. |
 
-# RequestError
+## RequestError
 
 | Value | Type |
 |-|-|

package/docs/classes/IncidentComment.md

@@ -6,6 +6,8 @@ This is the point from which all incident comments can be managed.
 
 > **Markdown is supported within comments.**
 
+Methods: `create`, `get`, `getAll`, `update`.
+
 ## create(incidentId, incidentCommentText)
 
 Add a comment to an existing incident.
@@ -33,6 +35,30 @@ This can return:
 - HTTP 200 with the comment object if it was successful.
 - HTTP 404 if the given comment or incident doesn't exist.
 
+## getAll(incidentId)
+
+Fetch all comments from an incident.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `incidentId` | Number | true | Specify the ID of the incident. |
+
+This can return:
+- HTTP 200 with an array of incident comments if it was successful.
+- HTTP 404 if the given incident doesn't exist.
+
+## remove(incidentId, incidentCommentId)
+
+Delete a comment from an incident.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `incidentId` | Number | true | Specify the ID of the incident. |
+| `incidentCommentId` | Number | true | Specify the ID of the incident comment. |
+
+This can return:
+- HTTP 204 if it was successful.
+
 ## update(incidentId, incidentCommentId, incidentCommentText)
 
 Edit an existing comment on an incident.

package/docs/classes/Incidents.md

@@ -6,6 +6,8 @@ This is the point from which all incidents can be managed.
 
 Status updates can't be managed from here.
 
+Methods: `acknowledge`, `create`, `escalate`, `get`, `remove`, `resolve`.
+
 ## `acknowledge`
 
 `acknowledge(incidentId)`
@@ -17,9 +19,8 @@ Acknowledge an existing incident.
 | `incidentId` | Number | true | Specify the ID of the incident. |
 
 This can return:
-
-- HTTP 200 if it was successful,
-- HTTP 409 if that incident was already acknowledged.
+- If successful: HTTP 200 with the incident data,
+- If already acknowledged: HTTP 409 with the error message.
 
 ## `create`
 
@@ -41,9 +42,7 @@ Create a new incident. `incidentData` is an object with the following properties
 | `policy_id` | String | false | Policy escalation ID with which the incident should be escalated. |
 
 This can return:
-
-- HTTP 201 if the incident was successfully created,
-- HTTP 404 if the token was not provided.
+- If successful: HTTP 201 and the Incident object containing its data.
 
 Most optional options can also be found in the [upstream](https://betterstack.com/docs/uptime/api/create-a-new-incident/) documentation.
 
@@ -72,9 +71,8 @@ Some properties in the `escalationData` value are only required depending on wha
 Other properties of this value can be found in the [upstream](https://betterstack.com/docs/uptime/api/escalate-an-ongoing-incident/) documentation, though they're not required.
 
 This can return:
-
-- HTTP 200 if the incident was successfully escalated,
-- HTTP 409 if the incident was already resolved.
+- If successful: HTTP 200 with the incident data,
+- If already escalated: HTTP 409 with the error message.
 
 ## `get`
 
@@ -85,8 +83,7 @@ Fetch an existing incident.
 | `incidentId` | Number | true | Specify the ID of the incident. |
 
 This can return:
-
-- HTTP 200 with the incident data as an Object if it was successful.
+- If successful: HTTP 200 with the incident data.
 
 ## `remove`
 
@@ -99,8 +96,7 @@ Delete an existing incident.
 | `incidentId` | Number | true | Specify the ID of the incident. |
 
 This can return:
-
-- HTTP 204 if it was successful.
+- If successful: HTTP 204 and an empty body.
 
 ## `resolve`
 
@@ -113,6 +109,27 @@ Resolve and close an existing incident.
 | `incidentId` | Number | true | Specify the ID of the incident. |
 
 This can return:
+- If successful: HTTP 200 with the incident data.
+- If already resolved: HTTP 409 with the error message.
+
+## `search`
 
-- HTTP 200 if it was successful,
-- HTTP 409 if that incident was already resolved.
+`search(perPage, page, from, to, monitorId, heartbeatId, resolved, acknowledged, metadata)`
+
+> Each value must be set, either as the required corresponding type, as `null` or `undefined`.
+
+> This method supports **pagination**!
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `perPage` | Number | true | Number of results to show. Maximum is 250. |
+| `page` | Number | true | Page of results to show. |
+| `from` | String | false | Specify the start date. |
+| `to` | String | false | Specify the end date. |
+| `monitorId` | Number | false | Specify the monitor ID. |
+| `heartbeatId` | Number | false | Specify the heartbeat ID. |
+| `resolved` | Boolean | false | Whether to query only resolved or unresolved incidents. |
+| `acknowledged` | Boolean | false | Whether to query only incidents that are acknowledged or not. |
+
+This can return:
+- If successful: HTTP 200 with a list of Incidents objects.

package/docs/classes/Monitor.md

@@ -0,0 +1,115 @@
+# Monitors
+
+Class: `client.monitors`
+
+This is the point from which all monitors can be managed.
+
+Methods: `create`, `edit`, `get`, `getAll`, `getHistory`, `getSLA`, `remove`.
+
+## `create`
+
+`create(monitorData)`
+
+Create a new monitor.
+
+> You should refer to [upstream documentation](https://betterstack.com/docs/uptime/api/create-a-new-monitor/) to learn more about this call.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorData` | Object | true | The monitor data. |
+| `monitorData.team_name` | String | true | The team which owns the monitor. |
+
+This can return:
+- If successful: HTTP 201 and the Monitor object containing the data.
+- If it fails: HTTP 422 with the error message.
+
+> Once you've created a monitor, you should expect its ID in the `data.id` value as a String.
+
+## `edit`
+
+`edit(id, monitorData)`
+
+Edit an existing monitor.
+
+> You should refer to [upstream documentation](https://betterstack.com/docs/uptime/api/update-an-existing-monitor/) to learn more about this call.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `id` | Number | true | The monitor ID. |
+| `monitorData` | Object | true | The monitor data. |
+
+This can return:
+- If successful: HTTP 200 and the Monitor object containing the new data.
+- If it fails: HTTP 422 with the error message.
+
+## `get`
+
+`get(id)`
+
+Get a single monitor.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `id` | Number | true | The monitor ID. |
+
+This can return:
+- If successful: HTTP 200 and the Monitor object containing the data.
+
+## `getAll`
+
+`getAll(perPage, page, name, url)`
+
+Query bulk monitors.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `perPage` | Number | false | Amount of monitors per page. Default value is 50. |
+| `page` | Number | false | Results page number. Default value is 1. |
+| `name` | String | false | Pronounceable name of monitors. |
+| `url` | String | false | URL of monitors. |
+
+> This method supports **pagination**!
+
+This can return:
+- If successful: HTTP 200 and a list of Monitors.
+
+## `getHistory`
+
+`getHistory(monitorId)`
+
+Get the response time history of an existing monitor.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorId` | Number | true | Specify the ID of the monitor. |
+
+This can return:
+- If successful: HTTP 200 and a Monitor Response Time History object.
+
+## `getSLA`
+
+`getSLA(monitorId, from, to)`
+
+Get the availability summary of an existing monitor.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorId` | Number | true | Specify the ID of the monitor. |
+| `from` | String `YYYY-MM-DD` | false | Start date. |
+| `to` | String `YYYY-MM-DD` | false | End date. |
+
+This can return:
+- If successful: HTTP 200 and a [Monitor Availability](//codeberg.org/Cyanic76/BSM.js/src/branch/main/docs/objects/Monitor.md#availability) object containing the data.
+
+## `remove`
+
+`remove(monitorId)`
+
+Delete an existing monitor.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorId` | Number | true | Specify the ID of the monitor. |
+
+This can return:
+- If successful: HTTP 204 and an empty body.

package/docs/etc/Util.md

@@ -0,0 +1,29 @@
+# Utils
+
+This group of functions is never exported.
+
+Functions: `checkDateFormat`, `validateMonitorData`.
+
+## `checkDateFormat(date)`
+
+Test a date string against the `YYYY-MM-DD` format.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `date` | String | true | Date string. |
+
+Returns:
+- `true` if the check succeeds.
+- `false` if the check fails.
+
+## `validateMonitorData(data)`
+
+Check for most values of a Monitor.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `data` | Object | true | Monitor object. |
+
+Returns:
+- `true` if the check succeeds.
+- An Error and its reason if the check fails.

package/docs/objects/IncidentComment.md

@@ -17,12 +17,12 @@ The `data` property has many sub-properties, including the following:
 
 | Property | Type | Description |
 |-|-|-|
-| `id` | String | The ID of the incident comment. |
-| `comment` | String | The comment. |
-| `user_id` | Number | The ID of the author. |
-| `user_email` | String | The email address of the author. |
-| `created_at` | String | The ISO-formatted timestamp at which the incident comment was created. |
-| `updated_at` | String | The ISO-formatted timestamp at which the incident comment was last edited. |
+| `attributes.id` | String | The ID of the incident comment. |
+| `attributes.comment` | String | The comment. |
+| `attributes.user_id` | Number | The ID of the author. |
+| `attributes.user_email` | String | The email address of the author. |
+| `attributes.created_at` | String | The ISO-formatted timestamp at which the incident comment was created. |
+| `attributes.updated_at` | String | The ISO-formatted timestamp at which the incident comment was last edited. |
 
 ## Example
 

package/docs/objects/Monitor.md

@@ -5,3 +5,133 @@ A Monitor object has the following properties.
 > The namespace is `data`.
 
 Get the attributes on the [upstream documentation](https://betterstack.com/docs/uptime/api/monitors-api-response-params/).
+
+## List
+
+An Array of monitors.
+
+You should refer to the [upstream documentation](https://betterstack.com/docs/uptime/api/list-all-existing-monitors/).
+
+## Availability
+
+### attributes
+
+The following depend whether you're looking for data since the monitor was created or for data within a given date range.
+
+| Property | Type | Description |
+|-|-|-|
+| `attributes.availability` | Number | Percentage of uptime. |
+| `attributes.total_downtime` | Number | Number of seconds of downtime. |
+| `attributes.number_of_incidents` | Number | Number of incidents. |
+| `attributes.longest_incident` | Number | Duration of the longest incident in seconds. |
+| `attributes.average_incident` | Number | Duration of the average incident in seconds. |
+
+### Example
+
+```json
+{
+  "data": {
+    "id": "1",
+    "type": "monitor_sla",
+    "attributes": {
+      "availability": 99.98,
+      "total_downtime": 600, // => 10 min
+      "number_of_incidents": 3,
+      "longest_incident": 300, // => 5 min
+      "average_incident": 200, // => 3 min 20 seconds
+    }
+  }
+}
+```
+
+## Response Time
+
+### attributes
+
+| Property | Type | Description |
+|-|-|-|
+| `id` | String | Monitor ID. |
+| `type` | String | "monitor_response_times". |
+| `attributes.regions` | Array | List of times by regions. |
+| `attributes.regions.region` | String | Region. |
+| `attributes.regions.response_times` | Array | List of times. |
+| `attributes.regions.response_times[item]` | Object | Response data. |
+| `attributes.regions.response_times[item].at` | String | Timestamp of the response. |
+| `attributes.regions.response_times[item].response_time` | Number | Time of the response in seconds. |
+| `attributes.regions.response_times[item].name_lookup_time` | Number | Time of the DNS lookup in seconds. |
+| `attributes.regions.response_times[item].connection_time` | Number | Time of the connection in seconds. |
+| `attributes.regions.response_times[item].tls_handshake_time` | Number | Time of the TLS handshake in seconds. |
+| `attributes.regions.response_times[item].data_transfer_time` | Number | Time of the data transfer in seconds. |
+
+### Example
+
+```json
+{
+  "data": {
+    "id": "270985",
+    "type": "monitor_response_times",
+    "attributes": {
+      "regions": [
+        {
+          "region": "us",
+          "response_times": [
+            {
+              "at": "2025-04-03T11:00:57.000Z",
+              "response_time": 0.47273,
+              "name_lookup_time": 0.00002,
+              "connection_time": 0.14187,
+              "tls_handshake_time": 0.19929,
+              "data_transfer_time": 0.13154
+            },
+            {
+              "at": "2025-04-03T11:01:27.000Z",
+              "response_time": 0.41211,
+              "name_lookup_time": 0.00002,
+              "connection_time": 0.13058,
+              "tls_handshake_time": 0.17109,
+              "data_transfer_time": 0.11042
+            },
+            {
+              "at": "2025-04-03T11:04:27.000Z",
+              "response_time": 0.41943,
+              "name_lookup_time": 0.00002,
+              "connection_time": 0.10908,
+              "tls_handshake_time": 0.19844,
+              "data_transfer_time": 0.11188
+            }
+          ]
+        },
+        {
+          "region": "eu",
+          "response_times": [
+            {
+              "at": "2025-04-03T11:13:27.000Z",
+              "response_time": 0.60383,
+              "name_lookup_time": 0.00002,
+              "connection_time": 0.15449,
+              "tls_handshake_time": 0.31218,
+              "data_transfer_time": 0.13714
+            },
+            {
+              "at": "2025-04-03T11:13:57.000Z",
+              "response_time": 0.36093,
+              "name_lookup_time": 0.00002,
+              "connection_time": 0.12147,
+              "tls_handshake_time": 0.12925,
+              "data_transfer_time": 0.11019
+            },
+            {
+              "at": "2025-04-03T11:17:27.000Z",
+              "response_time": 0.34252,
+              "name_lookup_time": 0.00002,
+              "connection_time": 0.10989,
+              "tls_handshake_time": 0.1224,
+              "data_transfer_time": 0.11021
+            }
+          ]
+        }
+      ]
+    }
+  }
+}
+```

package/docs/readme.md

@@ -4,7 +4,19 @@ Manage your Better Stack incidents & more using the API with this library.
 
 You're in the **user-facing documentation**.
 
+## Directories
+
+- `classes/`
+- `etc/`
+- `objects/`
+- `upstream/`
+
 ## Links
 
-- [Source code](https://codeberg.org/Cyanic76/BSM.js)
-- [Discord server](https://cyanic.me/next)
+- [Documentation](https://codeberg.org/Cyanic76/BSM.js/src/branch/main/docs)
+- [Source Code](https://codeberg.org/Cyanic76/BSM.js/)
+- [Discord server](https://cyanic.me/discord)
+
+Get the package on
+[Codeberg](https://codeberg.org/Cyanic76/-/packages/npm/betterstackmanager/) or on
+[NPM](https://www.npmjs.com/package/betterstackmanager).

package/docs/upstream/Pagination.md

@@ -0,0 +1,12 @@
+# Pagination
+
+When getting a result from an method that support pagination, you may check the following properties.
+
+| Property | Type | Description |
+|-|-|-|
+| `pagination.first` | String | URL to the first page of results. |
+| `pagination.last` | String | URL to the last page of results. |
+| `pagination.prev` | String/null | URL to the previous page of results. If you're on the first page, you'll get `null`. |
+| `pagination.next` | String/null | URL to the next page of results. If you're on the last page, you'll get `null`. |
+
+You may as well refer to the [upstream documentation](https://betterstack.com/docs/uptime/api/pagination).

package/examples/acknowledgeIncident.js

@@ -1,4 +1,4 @@
-const BSM = require('../src/index');
+const BSM = require('betterstackmanager');
 const config = require('./config.json');
 
 const client = new BSM.Client(config.token);

package/examples/createIncident.js

@@ -1,4 +1,4 @@
-const BSM = require('../src/index');
+const BSM = require('betterstackmanager');
 const config = require('./config.json');
 
 const client = new BSM.Client(config.token);

package/examples/createIncidentComment.js

@@ -1,4 +1,4 @@
-const BSM = require('../src/index');
+const BSM = require('betterstackmanager');
 const config = require('./config.json');
 
 const client = new BSM.Client(config.token);

package/examples/getSingleIncident.js

@@ -1,4 +1,4 @@
-const BSM = require('../src/index');
+const BSM = require('betterstackmanager');
 const config = require('./config.json');
 
 const client = new BSM.Client(config.token);

package/examples/readme.md

@@ -32,5 +32,10 @@ This example resolves an existing incident with the given ID.
 
 ## Links
 
-- [Source code](https://codeberg.org/Cyanic76/BSM.js)
-- [Discord server](https://cyanic.me/next)
+- [Documentation](https://codeberg.org/Cyanic76/BSM.js/src/branch/main/docs)
+- [Source Code](https://codeberg.org/Cyanic76/BSM.js/)
+- [Discord server](https://cyanic.me/discord)
+
+Get the package on
+[Codeberg](https://codeberg.org/Cyanic76/-/packages/npm/betterstackmanager/) or on
+[NPM](https://www.npmjs.com/package/betterstackmanager).

package/examples/resolveIncident.js

@@ -1,4 +1,4 @@
-const BSM = require('../src/index');
+const BSM = require('betterstackmanager');
 const config = require('./config.json');
 
 const client = new BSM.Client(config.token);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "betterstackmanager",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Interact with Better Stack in Node.JS",
   "license": "GPL-3.0-only",
   "author": "Cyanic76",

package/src/client/index.js

@@ -2,6 +2,7 @@ const axios = require('axios');
 
 const Incidents = require('../etc/Incident');
 const IncidentComments = require('../etc/IncidentComment');
+const Monitors = require('../etc/Monitor');
 
 const { handleError } = require('../errors/Error');
 
@@ -21,6 +22,7 @@ class Client {
     // Get the right classes as found in the folder.
     this.incidents = new Incidents(this);
     this.incidentComments = new IncidentComments(this);
+    this.monitors = new Monitors(this);
   }
 
   async delete (endpoint) {

package/src/client/utils.js

@@ -0,0 +1,63 @@
+/**
+ * Function used to validate date formatting.
+ * @param {String} date 
+ * @returns 
+ */
+function checkDateFormat(date) {
+  const dateRegex = new RegExp(/^\d{4}\-(0[1-9]|1[012])\-(0[1-9]|[12][0-9]|3[01])$/);
+  return date.match(dateRegex);
+}
+
+/**
+ * Function used to validate monitor data.
+ * @param {Object} data 
+ * @returns
+ */
+function validateMonitorData(data) {
+  
+  // Validate common properties first
+  if(data.monitor_type && typeof(data.monitor_type) != "string") throw new Error("monitor_type must be a String.");
+  if(data.url && typeof(data.url) != "string") throw new Error("monitor_url must be a String.");
+  if(data.pronounceable_name && typeof(data.pronounceable_name) != "string") throw new Error("pronounceable_name must be a String.");
+  if(data.email && typeof(data.email) != "boolean") throw new Error("email must be a Boolean.");
+  if(data.sms && typeof(data.sms) != "boolean") throw new Error("sms must be a Boolean.");
+  if(data.call && typeof(data.call) != "boolean") throw new Error("call must be a Boolean.");
+  if(data.critical_alert && typeof(data.critical_alert) != "boolean") throw new Error("critical_alert must be a Boolean.");
+  if(data.check_frequency && isNaN(data.check_frequency)) throw new Error("check_frequency must be a Number.");
+  if(data.domain_expiration && isNaN(data.domain_expiration)) throw new Error("domain_expiration must be a Number.");
+  if(data.ssl_expiration && isNaN(data.ssl_expiration)) throw new Error("ssl_expiration must be a Number.");
+  if(data.expiration_policy_id && isNaN(data.expiration_policy_id)) throw new Error("expiration_policy_id must be a Number.");
+  if(data.follow_redirects && typeof(data.follow_redirects) != "boolean") throw new Error("follow_redirects must be a Boolean.");
+  if(data.team_wait && isNaN(data.team_wait)) throw new Error("team_wait must be a Number.");
+  if(data.paused && typeof(data.paused) != "boolean") throw new Error("paused must be a Boolean.");
+  if(data.recovery_period && isNaN(data.recovery_period)) throw new Error("recovery_period must be a Number.");
+  if(data.verify_ssl && typeof(data.verify_ssl) != "boolean") throw new Error("verify_ssl must be a Boolean.");
+  if(data.confirmation_period && isNaN(data.confirmation_period)) throw new Error("confirmation_period must be a Number.");
+  if(data.request_timeout && isNaN(data.request_timeout)) throw new Error("request_timeout must be a Number.");
+  if(data.remember_cookies && typeof(data.remember_cookies) != "boolean") throw new Error("remember_cookies must be a Boolean.");
+
+  // Validate HTTP method
+  if(data.http_method){
+    const allowedMethods = ["GET", "HEAD", "PATCH", "POST", "PUT"];
+    if(!allowedMethods.includes(data.http_method)) throw new Error("http_method must be GET, HEAD, PATCH, POST or PUT (case-sensitive).");
+  };
+
+  // Validate headers
+  if(data.request_headers && typeof(data.request_headers) != "object") throw new Error("request_headers must be an Array of Object.");
+
+  // Validate status codes
+  if(data.expected_status_codes){
+    if(typeof(data.expected_status_codes) != "object") throw new Error("expected_status_codes must be an Array of Numbers.");
+    data.expected_status_codes.forEach(i => {
+      if(isNaN(i)) throw new Error(`expected_status_codes: All values must be Numbers. ${i} is not a Number.`);
+    });
+  };
+
+  // Here, we send "true" in any case. Or else, we'd get errors.
+  return true;
+}
+
+module.exports = {
+  checkDateFormat,
+  validateMonitorData
+};

package/src/etc/Incident.js

@@ -1,3 +1,5 @@
+const util = require('../client/utils');
+
 class Incidents {
   /**
    * @param {string} token
@@ -68,6 +70,52 @@ class Incidents {
     }
   };
 
+  /**
+   * Query bulk incidents.
+   * @param {Number} perPage
+   * @param {Number} page
+   * @param {String} from 
+   * @param {String} to 
+   * @param {Number} monitorId 
+   * @param {Number} heartbeatId 
+   * @param {Boolean} resolved 
+   * @param {Boolean} acknowledged 
+   * @param {Object} metadata 
+   * @returns 
+   */
+  async search(perPage, page, from, to, monitorId, heartbeatId, resolved, acknowledged, metadata) {
+
+    // Test both timestamps against the YYYY-MM-DD format.
+    if(from != null && from != undefined && !util.checkDateFormat(from) ||
+       to != null && to != undefined && !util.checkDateFormat(to)) throw new Error("Incident search: Both timestamps must be formatted as YYYY-MM-DD.");
+
+    // Both following values are only boolean values.
+    if(monitorId != null && monitorId != undefined && isNaN(monitorId)) throw new Error("Incident search: Monitor ID must be a number.");
+    if(heartbeatId != null && heartbeatId != undefined && heartbeatId(monitorId)) throw new Error("Incident search: Monitor ID must be a number.");
+
+    // Both following values are only numbers.
+    if(perPage != null && perPage != undefined && isNaN(perPage) || page != null && page != null && isNaN(page)) throw new Error("Incident search: Page number and results must both be numbers.");
+    if(perPage != null && perPage != undefined && perPage < 1 || perPage != null && perPage != undefined && perPage > 250) throw new Error("Incident search: Can only get between 1 and 250 results.");
+    if(page != null && page != undefined && perPage < 1) throw new Error("Incident search: Page number must be a number.");
+
+    // Build our query with the params by only passing provided params.
+    const query = new URLSearchParams();
+    if(from != null && from != undefined) query.append('from', from);
+    if(to != null && to != undefined) query.append('to', to);
+    if(monitorId != null && monitorId != undefined) query.append('monitor_id', monitorId);
+    if(heartbeatId != null && heartbeatId != undefined) query.append('heartbeat_id', heartbeatId);
+    if(resolved == false || resolved == true) query.append('resolved', resolved);
+    if(acknowledged == false || acknowledged == true) query.append('acknowledged', acknowledged);
+    if(metadata != null && metadata != undefined) query.append('metadata', metadata);
+
+    try {
+      return await this.client.get(`/v3/incidents/?${query}`);
+    } catch(error) {
+      throw error;
+    }
+
+  }
+
   /**
    * Resolve an existing incident.
    * @param {Number} incidentId 
@@ -134,7 +182,7 @@ class Incidents {
     if(isNaN(incidentId)) throw new Error("Incident acknowledgement: incidentId is not a Number.");
 
     try {
-      return await this.client.remove(`/v3/incidents/${incidentId}`);
+      return await this.client.delete(`/v3/incidents/${incidentId}`);
     } catch(error) {
       throw error;
     }

package/src/etc/IncidentComment.js

@@ -16,7 +16,7 @@ class IncidentComments {
   async create(incidentId, incidentCommentText) {
 
     if(!incidentId || !incidentCommentText) throw new Error("Incident comment creation: incidentId and incidentCommentText are required options.");
-    if(isNaN(incidentId)) throw new Error("Incident comment creation: incidentId must be a Number.");
+    if(isNaN(incidentId) || incidentId < 1) throw new Error("Incident comment creation: incidentId must be a Number greater than 0.");
     
     try {
       return await this.client.post(`/v2/incidents/${incidentId}/comments`, {
@@ -35,8 +35,9 @@ class IncidentComments {
    */
   async get(incidentId, incidentCommentId) {
 
-    if(!incidentId || !incidentCommentId) throw new Error("Incident comment fetch: incidentId, incidentCommentId are required options.");
+    if(!incidentId || !incidentCommentId) throw new Error("Incident comment fetch: incidentId and incidentCommentId are required options.");
     if(isNaN(incidentId) || isNaN(incidentCommentId)) throw new Error("Incident comment fetch: incidentId and incidentCommentId must both be Numbers.");
+    if(incidentId < 1 || incidentCommentId < 1) throw new Error("Incident comment fetch: incidentId and incidentCommentId must be greater than 0.");
 
     try {
       return await this.client.get(`/v2/incidents/${incidentId}/comments/${incidentCommentId}`);
@@ -46,6 +47,37 @@ class IncidentComments {
 
   }
 
+  /**
+   * Get all comments on an incident.
+   * @param {Number} incidentId 
+   * @returns 
+   */
+  async getAll(incidentId) {
+
+    if(!incidentId) throw new Error("Incident comment fetch: incidentId is a required options.");
+    if(isNaN(incidentId) || incidentId < 1) throw new Error("Incident comment fetch: incidentId must be a Number greater than 0.");
+
+    try {
+      return await this.client.get(`/v2/incidents/${incidentId}/comments`);
+    } catch(error) {
+      throw error;
+    }
+
+  }
+
+  async remove(incidentId, incidentCommentId) {
+
+    if(!incidentId || !incidentCommentId || incidentId && isNaN(incidentId) || incidentCommentId && isNaN(incidentCommentId)) throw new Error("Incident comment removal: incidentId and incidentCommentId must be Numbers.");
+    if(incidentId < 1 || incidentCommentId < 1) throw new Error("Incident comment removal: incidentId and incidentCommentId must be greater than 0.");
+
+    try {
+      return await this.client.delete(`/v2/incidents/${incidentId}/comments/${incidentCommentId}`);
+    } catch(error) {
+      throw error;
+    }
+
+  }
+
   /**
    * Edit an existing incident comment.
    * @param {Number} incidentId 
@@ -57,6 +89,7 @@ class IncidentComments {
     
     if(!incidentId || !incidentCommentId || !incidentCommentText ) throw new Error("Incident comment update: incidentId, incidentCommentId, incidentCommentText are required options.");
     if(isNaN(incidentId) || isNaN(incidentCommentId)) throw new Error("Incident comment update: incidentId and incidentCommentId must both be Numbers.");
+    if(incidentId < 1 || incidentCommentId < 1) throw new Error("Incident comment update: incidentId and incidentCommentId must be greater than 0.");
 
     try {
       return await this.client.patch(`/v2/incidents/${incidentId}/comments/${incidentCommentId}`, {

package/src/etc/Monitor.js

@@ -0,0 +1,153 @@
+const util = require('../client/utils');
+
+class Monitor {
+  /**
+   * @param {string} token
+   * @param {string} baseURL
+   */
+  constructor(client) {
+    this.client = client;
+  };
+
+  /**
+   * Create a monitor.
+   * @param {String} teamName 
+   * @param {Object} monitorData 
+   * @returns 
+   */
+  async create(monitorData) {
+    if(!monitorData) throw new Error("Monitor creation: data must be passed as an Object.");
+    if(!monitorData.team_name) throw new Error("Monitor creation: data.team_name must be passed as a String.");
+
+    // Validate our new monitor first.
+    try {
+      util.validateMonitorData(monitorData);
+    } catch(error) {
+      throw error;
+    }
+
+    try {
+      return await this.client.post('/v2/monitors/', monitorData);
+    } catch(error) {
+      throw error;
+    }
+  }
+
+  async edit(id, monitorData) {
+    if(!id || id && isNaN(id)) throw new Error("Monitor update: id must be a Number.");
+    if(id < 0) throw new Error("Monitor update: id must be greater than 0.");
+
+    // Validate our new monitor first.
+    try {
+      util.validateMonitorData(monitorData);
+    } catch(error) {
+      throw error;
+    }
+
+    try {
+      return await this.client.patch(`/v2/monitors/${id}`, monitorData);
+    } catch(error) {
+      throw error;
+    }
+  }
+
+  /**
+   * Get a monitor.
+   * @param {Number} id 
+   */
+  async get(id) {
+    if(!id || id && isNaN(id)) throw new Error("Monitor: id must be a Number.");
+    if(id < 0) throw new Error("Monitor: id must be greater than 0.")
+
+    try {
+      return await this.client.get(`/v2/monitors/${id}`);
+    } catch(error) {
+      throw error;
+    }
+  }
+
+  /**
+   * Get all the monitors.
+   * @param {Number} perPage 
+   * @param {Number} page
+   * @param {String} name 
+   * @param {String} url 
+   */
+  async getAll(perPage, page, name, url){
+    if(page && isNaN(page) || page && !isNaN(page) && page < 1) throw new Error("Monitor List: pageId must be a number greater than or equal to 0.");
+    if(perPage && isNaN(perPage) || perPage && perPage > 250 || perPage && perPage < 1) throw new Error("Monitor List: perPage must be a number between 1 and 250.");
+
+    let endpoint = '/v2/monitors?';
+
+    // Build query from passed parameters
+    let parameters = {
+      "perPage": perPage ? perPage : 50,
+      "page": page ? page : 1,
+      "name": name ? name : null,
+      "url": url ? url : null
+    }
+    for (let key in parameters) {
+      let value = parameters[key];
+      if(value != null) endpoint += `${key}=${value}&`;
+    };
+
+    try {
+      return await this.client.get(endpoint);
+    } catch(error) {
+      throw error;
+    }
+  }
+
+  async getResponseHistory(monitorId) {
+    if(!monitorId || monitorId && isNaN(monitorId)) throw new Error("Monitor History: monitorId must be a Number.");
+    if(monitorId < 0) throw new Error("Monitor History: monitorId must be greater than 0.")
+    
+    try {
+      return await this.client.get(`/v2/monitors/${monitorId}/response-times`);
+    } catch(error) {
+      throw error;
+    }
+  }
+
+  /**
+   * Get the availability summary of the monitor.
+   * @param {Number} monitorId 
+   * @param {String} from 
+   * @param {String} to 
+   * @returns
+   */
+  async getSLA(monitorId, from, to){
+    if(!monitorId || monitorId && isNaN(monitorId)) throw new Error("Monitor SLA: monitorId must be a Number.");
+    if(monitorId < 0) throw new Error("Monitor SLA: monitorId must be greater than 0.")
+
+    if(!util.checkDateFormat(from) || !util.checkDateFormat(to)) throw new Error("Monitor SLA: Bad date format.");
+
+    try {
+      return await this.client.get(`/v2/monitors/${monitorId}/sla`, {
+        from: from,
+        to: to
+      });
+    } catch(error) {
+      throw error;
+    }
+  }
+
+  /**
+   * Delete an existing monitor.
+   * @param {Number} monitorId 
+   * @returns 
+   */
+  async remove(monitorId) {
+    if(!monitorId || monitorId && isNaN(monitorId)) throw new Error("Monitor deletion: monitorId must be a Number.");
+    if(monitorId < 0) throw new Error("Monitor deletion: monitorId must be greater than 0.");
+
+    try {
+      return await this.client.delete(`/v3/monitors/${monitorId}`);
+    } catch(error) {
+      throw error;
+    }
+  };
+
+}
+
+module.exports = { Monitor };

package/src/index.js

@@ -1,8 +1,13 @@
 const { Client } = require('./client');
 const { Incidents } = require('./etc/Incident');
+const { IncidentComments } = require('./etc/IncidentComment');
+const { Monitor } = require('./etc/Monitor');
 
 module.exports = {
   Client,
 
   Incidents,
+  IncidentComments,
+
+  Monitor
 };