feat(notification): add BearSMS SMS provider for Israel (#7638)

server/notification-providers/bearsms.js

@@ -0,0 +1,54 @@
+const NotificationProvider = require("./notification-provider");
+const axios = require("axios");
+
+class BearSMS extends NotificationProvider {
+    name = "bearsms";
+
+    /**
+     * @inheritdoc
+     */
+    async send(notification, msg, monitorJSON = null, heartbeatJSON = null) {
+        const okMsg = "Sent Successfully.";
+
+        try {
+            // BearSMS rejects messages containing emoji (astral characters) with error 200
+            const cleanMsg = msg.replaceAll("🔴 ", "").replaceAll("✅ ", "");
+            const params = new URLSearchParams({
+                app: "ws",
+                u: notification.bearsmsUsername,
+                h: notification.bearsmsHashKey,
+                op: "pv",
+                to: notification.bearsmsPhoneNumber,
+                msg: cleanMsg,
+            });
+
+            if (notification.bearsmsSenderId) {
+                params.append("from", notification.bearsmsSenderId);
+            }
+
+            // Non-GSM text (e.g. Hebrew) must be flagged as unicode
+            if (/[^\x00-\x7F]/.test(cleanMsg)) {
+                params.append("unicode", "1");
+            }
+
+            const url = `https://app.bearsms.com/index.php?${params.toString()}`;
+            let config = this.getAxiosConfigWithProxy({});
+            const response = await axios.get(url, config);
+
+            // BearSMS responds with HTTP 200 even on failure.
+            // Failure: {"status":"ERR","error":"100","error_string":"authentication failed"}
+            // Success: {"data":[{"status":"OK","error":"0","smslog_id":"..."}],"error_string":null}
+            const data = response.data;
+            const results = Array.isArray(data?.data) ? data.data : [];
+            if (data?.status === "ERR" || data?.error_string || !results.some((r) => r.status === "OK")) {
+                throw new Error(data?.error_string || JSON.stringify(data));
+            }
+
+            return okMsg;
+        } catch (error) {
+            this.throwGeneralAxiosError(error);
+        }
+    }
+}
+
+module.exports = BearSMS;

server/notification.js

@@ -6,6 +6,7 @@ const AliyunSms = require("./notification-providers/aliyun-sms");
 const Apprise = require("./notification-providers/apprise");
 const Bale = require("./notification-providers/bale");
 const Bark = require("./notification-providers/bark");
+const BearSMS = require("./notification-providers/bearsms");
 const Bitrix24 = require("./notification-providers/bitrix24");
 const ClickSendSMS = require("./notification-providers/clicksendsms");
 const CallMeBot = require("./notification-providers/call-me-bot");
@@ -124,6 +125,7 @@ class Notification {
             new Apprise(),
             new Bale(),
             new Bark(),
+            new BearSMS(),
             new Bitrix24(),
             new ClickSendSMS(),
             new CallMeBot(),