mirror of
https://github.com/louislam/uptime-kuma.git
synced 2024-09-08 10:23:57 +00:00
![Chongyi Zheng](/assets/img/avatar_default.png)
* Use API v2 for Bark notification * API v2 endpoint should end with path `/push` * Support both v1 and v2 * Flip the bool * Allow selecting api version * Apply review suggestion Co-authored-by: Nelson Chan <3271800+chakflying@users.noreply.github.com> * Add translated string to `en.json` * Apply review suggestion Co-authored-by: Nelson Chan <3271800+chakflying@users.noreply.github.com> --------- Co-authored-by: Nelson Chan <3271800+chakflying@users.noreply.github.com>
125 lines
4.4 KiB
JavaScript
125 lines
4.4 KiB
JavaScript
//
|
|
// bark.js
|
|
// UptimeKuma
|
|
//
|
|
// Created by Lakr Aream on 2021/10/24.
|
|
// Copyright © 2021 Lakr Aream. All rights reserved.
|
|
//
|
|
|
|
const NotificationProvider = require("./notification-provider");
|
|
const { DOWN, UP } = require("../../src/util");
|
|
const { default: axios } = require("axios");
|
|
|
|
// bark is an APN bridge that sends notifications to Apple devices.
|
|
|
|
const barkNotificationAvatar = "https://github.com/louislam/uptime-kuma/raw/master/public/icon.png";
|
|
const successMessage = "Successes!";
|
|
|
|
class Bark extends NotificationProvider {
|
|
name = "Bark";
|
|
|
|
/**
|
|
* @inheritdoc
|
|
*/
|
|
async send(notification, msg, monitorJSON = null, heartbeatJSON = null) {
|
|
let barkEndpoint = notification.barkEndpoint;
|
|
|
|
// check if the endpoint has a "/" suffix, if so, delete it first
|
|
if (barkEndpoint.endsWith("/")) {
|
|
barkEndpoint = barkEndpoint.substring(0, barkEndpoint.length - 1);
|
|
}
|
|
|
|
if (msg != null && heartbeatJSON != null && heartbeatJSON["status"] === UP) {
|
|
let title = "UptimeKuma Monitor Up";
|
|
return await this.postNotification(notification, title, msg, barkEndpoint);
|
|
}
|
|
|
|
if (msg != null && heartbeatJSON != null && heartbeatJSON["status"] === DOWN) {
|
|
let title = "UptimeKuma Monitor Down";
|
|
return await this.postNotification(notification, title, msg, barkEndpoint);
|
|
}
|
|
|
|
if (msg != null) {
|
|
let title = "UptimeKuma Message";
|
|
return await this.postNotification(notification, title, msg, barkEndpoint);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add additional parameter for Bark v1 endpoints
|
|
* @param {BeanModel} notification Notification to send
|
|
* @param {string} postUrl URL to append parameters to
|
|
* @returns {string} Additional URL parameters
|
|
*/
|
|
appendAdditionalParameters(notification, postUrl) {
|
|
// set icon to uptime kuma icon, 11kb should be fine
|
|
postUrl += "?icon=" + barkNotificationAvatar;
|
|
// grouping all our notifications
|
|
if (notification.barkGroup != null) {
|
|
postUrl += "&group=" + notification.barkGroup;
|
|
} else {
|
|
// default name
|
|
postUrl += "&group=" + "UptimeKuma";
|
|
}
|
|
// picked a sound, this should follow system's mute status when arrival
|
|
if (notification.barkSound != null) {
|
|
postUrl += "&sound=" + notification.barkSound;
|
|
} else {
|
|
// default sound
|
|
postUrl += "&sound=" + "telegraph";
|
|
}
|
|
return postUrl;
|
|
}
|
|
|
|
/**
|
|
* Check if result is successful
|
|
* @param {object} result Axios response object
|
|
* @returns {void}
|
|
* @throws {Error} The status code is not in range 2xx
|
|
*/
|
|
checkResult(result) {
|
|
if (result.status == null) {
|
|
throw new Error("Bark notification failed with invalid response!");
|
|
}
|
|
if (result.status < 200 || result.status >= 300) {
|
|
throw new Error("Bark notification failed with status code " + result.status);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Send the message
|
|
* @param {BeanModel} notification Notification to send
|
|
* @param {string} title Message title
|
|
* @param {string} subtitle Message
|
|
* @param {string} endpoint Endpoint to send request to
|
|
* @returns {string} Success message
|
|
*/
|
|
async postNotification(notification, title, subtitle, endpoint) {
|
|
let result;
|
|
if (notification.apiVersion === "v1" || notification.apiVersion == null) {
|
|
// url encode title and subtitle
|
|
title = encodeURIComponent(title);
|
|
subtitle = encodeURIComponent(subtitle);
|
|
let postUrl = endpoint + "/" + title + "/" + subtitle;
|
|
postUrl = this.appendAdditionalParameters(notification, postUrl);
|
|
result = await axios.get(postUrl);
|
|
} else {
|
|
result = await axios.post(`${endpoint}/push`, {
|
|
title,
|
|
body: subtitle,
|
|
icon: barkNotificationAvatar,
|
|
sound: notification.barkSound || "telegraph", // default sound is telegraph
|
|
group: notification.barkGroup || "UptimeKuma", // default group is UptimeKuma
|
|
});
|
|
}
|
|
this.checkResult(result);
|
|
if (result.statusText != null) {
|
|
return "Bark notification succeed: " + result.statusText;
|
|
}
|
|
// because returned in range 200 ..< 300
|
|
return successMessage;
|
|
}
|
|
}
|
|
|
|
module.exports = Bark;
|