betterstackmanager 0.1.0 → 0.2.1

package/README.md

@@ -31,8 +31,12 @@ The documentation for this project is contained within the `docs` directory.
 ## Links
 
 - [Documentation](https://codeberg.org/Cyanic76/BSM.js/src/branch/main/docs)
-- [NPM](https://www.npmjs.com/package/betterstackmanager)
-- [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
 

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

@@ -47,6 +47,18 @@ 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

@@ -19,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`
 
@@ -43,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.
 
@@ -74,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`
 
@@ -87,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`
 
@@ -101,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`
 
@@ -115,9 +109,8 @@ Resolve and close 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 resolved.
+- If successful: HTTP 200 with the incident data.
+- If already resolved: HTTP 409 with the error message.
 
 ## `search`
 
@@ -139,5 +132,4 @@ This can return:
 | `acknowledged` | Boolean | false | Whether to query only incidents that are acknowledged or not. |
 
 This can return:
-
-- HTTP 200 with a list of incidents.
+- 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/classes/MonitorGroup.md

@@ -0,0 +1,75 @@
+# Monitor Groups
+
+Class: `client.monitorGroups`
+
+Methods: `create`, `edit`, `get`, `listMonitors`, `remove`.
+
+## `create`
+
+`create(monitorGroup)`
+
+Create a new monitor group.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorGroup.team_name` | String | true | The team name that will own this group. |
+| `monitorGroup.paused` | Boolean | false | Pause monitoring for all monitors in this group. |
+| `monitorGroup.name` | String | false | The name of this group. |
+| `monitorGroup.sort_index` | Number | false | How to sort this group. |
+
+## `edit`
+
+`edit(id, monitorGroup)`
+
+Edit an existing monitor group.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `id` | Number | true | The monitor group ID. |
+| `monitorGroup.team_name` | String | true | The team name that will own this group. |
+| `monitorGroup.paused` | Boolean | false | Pause monitoring for all monitors in this group. |
+| `monitorGroup.name` | String | false | The name of this group. |
+| `monitorGroup.sort_index` | Number | false | How to sort this group. |
+
+## `get`
+
+`get(monitorGroupId)`
+
+Get a single monitor group.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorGroupId` | Number | true | Specify the ID of the monitor group. |
+
+This can return:
+- If successful: HTTP 200 and the Monitor Group object containing the data.
+
+## `listMonitors`
+
+`listMonitors(monitorGroupId)`
+
+Show monitors that belong to a group.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorGroupId` | Number | true | Specify the ID of the monitor group. |
+| `perPage` | Number | false | Amount of monitors per page. Default value is 50. |
+| `page` | Number | false | Results page number. Default value is 1. |
+
+> This method supports **pagination**!
+
+This can return:
+- If successful: HTTP 200 and a list of Monitors.
+
+## `remove`
+
+`remove(monitorGroupId)`
+
+Delete an existing monitor group.
+
+| Value | Type | Required | About |
+|-|-|-|-|
+| `monitorGroupId` | Number | true | Specify the ID of the monitor group. |
+
+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,8 +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)
-- [NPM](https://www.npmjs.com/package/betterstackmanager)
-- [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

@@ -6,7 +6,7 @@ When getting a result from an method that support pagination, you may check the
 |-|-|-|
 | `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`. |
+| `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`. |
 
-See [upstream documentation](https://betterstack.com/docs/uptime/api/pagination).
+You may as well refer to the [upstream documentation](https://betterstack.com/docs/uptime/api/pagination).

package/examples/{acknowledgeIncident.js → incidents/acknowledge.js}

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

package/examples/{createIncident.js → incidents/create.js}

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

package/examples/{createIncidentComment.js → incidents/createIncidentComment.js}

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

package/examples/{getSingleIncident.js → incidents/getSingleIncident.js}

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

package/examples/{resolveIncident.js → incidents/resolve.js}

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

package/examples/readme.md

@@ -10,28 +10,16 @@ You'll need to have, at least,
 - your **global API** key,
 - a mail address.
 
-## Following examples
+## Examples
 
-All examples show how to get your BSM client up and running.
-
-## acknowledgeIncident.js
-
-This short example acknowledges an incident with the given ID.
-
-## createIncident.js
-
-This short example creates an incident with the given name, summary and explanation.
-
-## createIncidentComment.js
-
-This example appends a new comment to an existing incident.
-
-## resolveIncident.js
-
-This example resolves an existing incident with the given ID.
+You'll find examples in the subfolders. They're grouped by the topic they cover.
 
 ## Links
 
-- [Source code](https://codeberg.org/Cyanic76/BSM.js)
-- [NPM](https://www.npmjs.com/package/betterstackmanager)
-- [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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "betterstackmanager",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "Interact with Better Stack in Node.JS",
   "license": "GPL-3.0-only",
   "author": "Cyanic76",
@@ -12,6 +12,6 @@
     "lib": "src"
   },
   "dependencies": {
-    "axios": "^1.13.2"
+    "axios": "^1.13.4"
   }
 }

package/src/client/index.js

@@ -1,7 +1,9 @@
 const axios = require('axios');
 
-const Incidents = require('../etc/Incident');
-const IncidentComments = require('../etc/IncidentComment');
+const Incidents = require('../etc/Incident'),
+      IncidentComments = require('../etc/IncidentComment'),
+      Monitors = require('../etc/Monitor'),
+      MonitorGroup = require('../etc/MonitorGroup');
 
 const { handleError } = require('../errors/Error');
 
@@ -18,11 +20,14 @@ class Client {
       }
     });
 
-    // Get the right classes as found in the folder.
+    // Get the right classes as found in the /src/etc folder.
     this.incidents = new Incidents(this);
     this.incidentComments = new IncidentComments(this);
+    this.monitors = new Monitors(this);
+    this.monitorGroups = new MonitorGroup(this);
   }
 
+  // Handle HTTP requests to the upstream API.
   async delete (endpoint) {
     try {
       const response = await this.client.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,7 +1,8 @@
+const util = require('../client/utils');
+
 class Incidents {
   /**
-   * @param {string} token
-   * @param {string} baseURL
+   * @param {Client} client 
    */
   constructor(client) {
     this.client = client;
@@ -19,7 +20,7 @@ class Incidents {
     if(!incidentData.name) throw new Error("Incident creation: name is a required incident option.");
     if(!incidentData.summary) throw new Error("Incident creation: summary is a required incident option.");
     if(!incidentData.description) throw new Error("Incident creation: description is a required incident option.");
-    if(!incidentData.email || typeof(incidentData.email) != 'boolean') throw new Error("Incident creation: email is a required boolean incident option.");
+    if(incidentData.email && typeof(incidentData.email) != 'boolean') throw new Error("Incident creation: email is a required boolean incident option.");
 
     // Modify a copy of the provided object.
     const data = { ...incidentData };
@@ -41,8 +42,8 @@ class Incidents {
    */
 
   async acknowledge(incidentId) {
-    if(!incidentId) throw new Error("Incident acknowledgement: incidentId is a required incident option.");
-    if(isNaN(incidentId)) throw new Error("Incident acknowledgement: incidentId is not a Number.");
+    if(!incidentId || incidentId && isNaN(incidentId)) throw new Error("Incident acknowledgement: incidentId must be a Number.");
+    if(incidentId < 1) throw new Error("Incident acknowledgement: incidentId must be greater than 0.");
 
     try {
       return await this.client.post(`/v3/incidents/${incidentId}/acknowledge`);
@@ -58,8 +59,8 @@ class Incidents {
    */
 
   async get(incidentId) {
-    if(!incidentId) throw new Error("Incident fetching: incidentId is a required incident option.");
-    if(isNaN(incidentId)) throw new Error("Incident acknowledgement: incidentId is not a Number.");
+    if(!incidentId || incidentId && isNaN(incidentId)) throw new Error("Incident: incidentId must be a Number.");
+    if(incidentId < 1) throw new Error("Incident: incidentId must be greater than 0.");
 
     try {
       return await this.client.get(`/v3/incidents/${incidentId}`);
@@ -84,8 +85,8 @@ class Incidents {
   async search(perPage, page, from, to, monitorId, heartbeatId, resolved, acknowledged, metadata) {
 
     // Test both timestamps against the YYYY-MM-DD format.
-    const dateRegEx = /(19[7-9]\d|20[0-3]\d)-(0[1-9]|1[0-2])-(0[1-9]|[12][0-9]|3[01])/;
-    if(from != null && from != undefined && !from.match(dateRegEx) || to != null && to != undefined && !to.match(dateRegEx)) throw new Error("Incident search: Both timestamps must be formatted as YYYY-MM-DD.");
+    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.");
@@ -121,8 +122,7 @@ class Incidents {
    */
 
   async resolve(incidentId) {
-    if(!incidentId) throw new Error("Incident resolution: incidentId is a required incident option.");
-    if(isNaN(incidentId)) throw new Error("Incident acknowledgement: incidentId is not a Number.");
+    if(!incidentId || incidentId && isNaN(incidentId) || incidentId && parseInt(incidentId) < 1) throw new Error("Incident resolution: incidentId must be a positive Number.");
 
     try {
       return await this.client.post(`/v3/incidents/${incidentId}/resolve`);
@@ -141,10 +141,10 @@ class Incidents {
   async escalate(incidentId, escalationData){
 
     // Before trying anything, check some things right away.
-    if(!incidentId || !escalationData) throw new Error("Incident resolution: incidentId and escalationData are required incident options.");
-    if(isNaN(incidentId)) throw new Error("Incident acknowledgement: incidentId is not a Number.");
+    if(!escalationData) throw new Error("Incident escalation: escalationData is required.");
+    if(!incidentId || incidentId && isNaN(incidentId) || incidentId && parseInt(incidentId) < 1) throw new Error("Incident escalation: incidentId must be a positive Number.");
     const allowedTypes = ["User", "Team", "Schedule", "Policy", "Organization"];
-    if(!allowedTypes.includes(escalationData.type)) throw new Error("Incident resolution: Escalation Type is invalid.");
+    if(!allowedTypes.includes(escalationData.type)) throw new Error("Incident escalation: Escalation Type is invalid.");
 
     switch(escalationData.type){
       case 'User':
@@ -176,11 +176,10 @@ class Incidents {
    */
   async remove(incidentId){
 
-    if(!incidentId) throw new Error("Incident deletion: incidentId is a required incident option.");
-    if(isNaN(incidentId)) throw new Error("Incident acknowledgement: incidentId is not a Number.");
+    if(!incidentId || incidentId && isNaN(incidentId) || incidentId && parseInt(incidentId) < 1) throw new Error("Incident deletion: incidentId must be a positive 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

@@ -1,7 +1,6 @@
 class IncidentComments {
   /**
-   * @param {string} token
-   * @param {string} baseURL
+   * @param {Client} client 
    */
   constructor(client) {
     this.client = client;
@@ -16,7 +15,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 +34,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}`);
@@ -53,8 +53,8 @@ class IncidentComments {
    */
   async getAll(incidentId) {
 
-    if(!incidentId) throw new Error("Incident comment fetch: incidentId is a required options.");
-    if(isNaN(incidentId)) throw new Error("Incident comment fetch: incidentId must be a Number.");
+    if(!incidentId || incidentId && isNaN(incidentId)) throw new Error("Incident comment fetch: incidentId is a required option.");
+    if(incidentId < 1) throw new Error("Incident comment fetch: incidentId must be a positive Number.");
 
     try {
       return await this.client.get(`/v2/incidents/${incidentId}/comments`);
@@ -64,6 +64,19 @@ class IncidentComments {
 
   }
 
+  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 a positive Number.");
+
+    try {
+      return await this.client.delete(`/v2/incidents/${incidentId}/comments/${incidentCommentId}`);
+    } catch(error) {
+      throw error;
+    }
+
+  }
+
   /**
    * Edit an existing incident comment.
    * @param {Number} incidentId 
@@ -73,8 +86,9 @@ class IncidentComments {
    */
   async update(incidentId, incidentCommentId, incidentCommentText) {
     
-    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 || !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 be Numbers.");
+    if(incidentId < 1 || incidentCommentId < 1) throw new Error("Incident comment update: incidentId and incidentCommentId must be a positive Number.");
 
     try {
       return await this.client.patch(`/v2/incidents/${incidentId}/comments/${incidentCommentId}`, {

package/src/etc/Monitor.js

@@ -0,0 +1,152 @@
+const util = require('../client/utils');
+
+class Monitor {
+  /**
+   * @param {Client} client 
+   */
+  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/etc/MonitorGroup.js

@@ -0,0 +1,122 @@
+class MonitorGroup {
+  /**
+   * @param {Client} client 
+   */
+  constructor(client) {
+    this.client = client;
+  };
+
+  /**
+   * Create a new monitor group.
+   * @param {Object} monitorGroup 
+   * @returns 
+   */
+  async create(monitorGroup) {
+
+    if(!monitorGroup) throw new Error("Montior Group: Must provide a Monitor Group object.");
+    if(!monitorGroup.team_name) throw new Error("Monitor Group: Team Name must be provided.");
+    if(monitorGroup.paused && typeof(monitorGroup.paused) != "Boolean") throw new Error("Monitor Group: paused must be either true or false.");
+    if(monitorGroup.sort_index && isNaN(monitorGroup.sort_index) || monitorGroup.sort_index && parseInt(monitorGroup.sort_index) < 1) throw new Error("Monitor Group: sort_index must be a positive number.");
+
+    try {
+      return await this.client.post(`/v2/monitor-groups/`, {
+        monitorGroup
+      });
+    } catch(error) {
+      throw error;
+    }
+
+  }
+
+  /**
+   * Edit an existing monitor group.
+   * @param {Number} id
+   * @param {Object} monitorGroup 
+   * @returns 
+   */
+  async edit(id, monitorGroup) {
+
+    if(!id || !monitorGroup) throw new Error("Montior Group: Must provide an ID and a Monitor Group object.");
+    if(parseInt(id) < 1 || isNaN(id)) throw new Error("Monitor Group: The ID must be a positive Number.");
+    if(monitorGroup.paused && typeof(monitorGroup.paused) != "Boolean") throw new Error("Monitor Group: paused must be either true or false.");
+    if(monitorGroup.sort_index && isNaN(monitorGroup.sort_index) || monitorGroup.sort_index && parseInt(monitorGroup.sort_index) < 1) throw new Error("Monitor Group: sort_index must be a positive number.");
+
+    try {
+      return await this.client.patch(`/v2/monitor-groups/`, {
+        monitorGroup
+      });
+    } catch(error) {
+      throw error;
+    }
+
+  }
+
+  /**
+   * Get an existing monitor group.
+   * @param {Number} monitorGroupId 
+   * @returns 
+   */
+  async get(monitorGroupId) {
+
+    if(!monitorGroupId || monitorGroupId && isNaN(monitorGroupId) || monitorGroupId && monitorGroupId < 1) throw new Error("Montior Group Deletion: ID must be a positive number.");
+
+    try {
+      return await this.client.get(`/v2/monitor-groups/${monitorGroupId}`);
+    } catch(error) {
+      throw error;
+    }
+
+  }
+
+  /**
+   * List monitors that belong to this group.
+   * @param {Number} monitorGroupId 
+   * @param {Number} perPage 
+   * @param {Number} page 
+   * @returns 
+   */
+  async listMonitors(monitorGroupId, perPage, page) {
+    if(!monitorGroupId || monitorGroupId && isNaN(monitorGroupId) || monitorGroupId && monitorGroupId < 1) throw new Error("Monitor Group ID must be a positive number.");
+
+    if(page && isNaN(page) || page && !isNaN(page) && page < 1) throw new Error("pageId must be a number greater than or equal to 0.");
+    if(perPage && isNaN(perPage) || perPage && perPage > 250 || perPage && perPage < 1) throw new Error("perPage must be a number between 1 and 250.");
+
+    const endpoint = `/v2/monitor-groups/${monitorGroupId}/monitors`;
+
+    // Build query from passed parameters
+    let parameters = {
+      "perPage": perPage ? perPage : 50,
+      "page": page ? page : 1
+    }
+    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;
+    }
+
+  }
+
+  /**
+   * Delete an existing monitor group.
+   * @param {Number} monitorGroupId 
+   * @returns 
+   */
+  async remove(monitorGroupId) {
+
+    if(!monitorGroupId || monitorGroupId && isNaN(monitorGroupId) || monitorGroupId && monitorGroupId < 1) throw new Error("Montior Group Deletion: ID must be a positive number.");
+
+    try {
+      return await this.client.delete(`/v2/monitor-groups/${monitorGroupId}`);
+    } catch(error) {
+      throw error;
+    }
+
+  }
+}
+
+module.exports = { MonitorGroup };

package/src/index.js

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

package/src/readme.md

@@ -0,0 +1,21 @@
+# BSM - Better Stack Manager
+
+Manage your Better Stack incidents & more using the API with this library.
+
+You're in the **source code**.
+
+## Directories
+
+- `client/` - The main client code and other utilities.
+- `errors/` - The error handler.
+- `etc/` - Other classes as defined in the documentation.
+
+## Links
+
+- [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).