Add optional Telegram alerts with photos and Mac location

BLEUnlock.xcodeproj/xcshareddata/xcschemes/BLEUnlock.xcscheme

@@ -28,6 +28,16 @@
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       shouldUseLaunchSchemeArgsEnv = "YES">
       <Testables>
+         <TestableReference
+            skipped = "NO">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "7E1000163000000000000001"
+               BuildableName = "BLEUnlockTests.xctest"
+               BlueprintName = "BLEUnlockTests"
+               ReferencedContainer = "container:BLEUnlock.xcodeproj">
+            </BuildableReference>
+         </TestableReference>
       </Testables>
    </TestAction>
    <LaunchAction

BLEUnlock/AppDelegate.swift

@@ -30,6 +30,27 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate, NSMenuItemVa
     var unlockedAt = 0.0
     var inScreensaver = false
     var lastRSSI: Int? = nil
+    let telegramSettings = TelegramSettings(
+        secrets: KeychainStore(service: "jp.sone.BLEUnlock.telegram")
+    )
+    let macLocationProvider = CoreMacLocationProvider()
+    lazy var telegramService: TelegramNotificationHandling = TelegramNotificationService(
+        settings: telegramSettings,
+        sender: TelegramNotifier(transport: URLSessionTransport()),
+        camera: CameraCapture(),
+        location: macLocationProvider,
+        reporter: RateLimitedFailureReporter()
+    )
+    lazy var telegramMenuController = TelegramMenuController(
+        settings: telegramSettings,
+        service: telegramService,
+        dialogs: AppKitTelegramDialogPresenter(),
+        locationAuthorization: macLocationProvider
+    )
+    private let telegramEventQueue = DispatchQueue(
+        label: "jp.sone.BLEUnlock.telegram.events",
+        qos: .utility
+    )
 
     func menuWillOpen(_ menu: NSMenu) {
         if menu == deviceMenu {
@@ -177,6 +198,20 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate, NSMenuItemVa
         try? process.run()
     }
 
+    func dispatchEvent(_ rawValue: String) {
+        runScript(rawValue)
+        guard let event = TelegramEvent(rawValue: rawValue) else { return }
+        let context = TelegramEventContext(
+            event: event,
+            hostName: Host.current().localizedName ?? "Mac",
+            timestamp: Date(),
+            rssi: lastRSSI
+        )
+        telegramEventQueue.async { [weak self] in
+            self?.telegramService.handle(context)
+        }
+    }
+
     func pauseNowPlaying() {
         guard prefs.bool(forKey: "pauseItunes") else { return }
         MRMediaRemoteGetNowPlayingApplicationIsPlaying(
@@ -238,7 +273,7 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate, NSMenuItemVa
                 pauseNowPlaying()
                 lockOrSaveScreen()
                 notifyUser(reason)
-                runScript(reason)
+                dispatchEvent(reason)
             }
             manualLock = false
         }
@@ -302,7 +337,7 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate, NSMenuItemVa
             self.unlockedAt = Date().timeIntervalSince1970
             self.fakeKeyStrokes(password)
             self.playNowPlaying()
-            self.runScript("unlocked")
+            self.dispatchEvent("unlocked")
         })
     }
 
@@ -344,7 +379,7 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate, NSMenuItemVa
             print("onUnlock")
             if Date().timeIntervalSince1970 >= self.unlockedAt + 10 {
                 if self.ble.unlockRSSI != self.ble.UNLOCK_DISABLED {
-                    self.runScript("intruded")
+                    self.dispatchEvent("intruded")
                 }
                 self.playNowPlaying()
             }
@@ -642,6 +677,9 @@ class AppDelegate: NSObject, NSApplicationDelegate, NSMenuDelegate, NSMenuItemVa
         if prefs.bool(forKey: "sleepDisplay") {
             item.state = .on
         }
+
+        item = mainMenu.addItem(withTitle: t("telegram"), action: nil, keyEquivalent: "")
+        item.submenu = telegramMenuController.menu
 
         mainMenu.addItem(withTitle: t("set_password"), action: #selector(askPassword), keyEquivalent: "")
 

BLEUnlock/BLEUnlock.entitlements

@@ -4,5 +4,7 @@
 <dict>
 	<key>com.apple.security.automation.apple-events</key>
 	<true/>
+	<key>com.apple.security.personal-information.location</key>
+	<true/>
 </dict>
 </plist>

BLEUnlock/Base.lproj/InfoPlist.strings

@@ -0,0 +1,2 @@
+"NSCameraUsageDescription" = "BLEUnlock uses the system default camera to photograph a manual unlock and upload the alert to Telegram.";
+"NSLocationUsageDescription" = "BLEUnlock gets this Mac's location at capture time and attaches the coordinates and map to the Telegram security notification.";

BLEUnlock/Base.lproj/Localizable.strings

@@ -36,3 +36,51 @@
 "use_screensaver_to_lock" = "Use Screensaver to Lock";
 "wake_on_proximity" = "Wake on Proximity";
 "wake_without_unlocking" = "Wake without Unlocking";
+
+"telegram" = "Telegram Notifications";
+"telegram_enable" = "Enable Telegram";
+"telegram_configure" = "Configure…";
+"telegram_test" = "Send Test Notification";
+"telegram_events" = "Events";
+"telegram_event_away" = "Device is away";
+"telegram_event_lost" = "Signal is lost";
+"telegram_event_unlocked" = "Unlocked by BLEUnlock";
+"telegram_event_intruded" = "Unlocked manually";
+"telegram_take_photo" = "Attach a photo for manual unlock";
+"telegram_attach_mac_location" = "Attach Mac Location";
+"telegram_status_not_configured" = "Not configured";
+"telegram_status_enabled" = "Enabled";
+"telegram_status_disabled" = "Disabled";
+"telegram_bot_token" = "Bot token";
+"telegram_chat_id" = "Chat ID";
+"telegram_save" = "Save";
+"telegram_setup_help" = "Create a bot with @BotFather and copy its token. Send the bot a message, then open getUpdates in the Telegram Bot API and copy the numeric Chat ID from the response.";
+"telegram_test_success" = "Test notification sent.";
+"telegram_test_failed" = "Could not send the test notification.";
+"telegram_camera_privacy" = "BLEUnlock uses the system default camera and uploads one photo to Telegram. The temporary photo is deleted after the attempt; if capture fails, BLEUnlock sends text instead.";
+"telegram_error_not_configured" = "Configure a bot token and Chat ID first.";
+"telegram_camera_error_denied" = "Camera access was denied.";
+"telegram_camera_error_restricted" = "Camera access is restricted.";
+"telegram_camera_error_no_camera" = "No camera is available.";
+"telegram_camera_error_setup_failed" = "The camera could not be configured.";
+"telegram_camera_error_capture_failed" = "The camera could not capture a photo.";
+"telegram_camera_error_timeout" = "The camera capture timed out.";
+"telegram_camera_error_file_write_failed" = "The captured photo could not be saved.";
+"telegram_error_invalid_request" = "The Telegram request could not be created.";
+"telegram_error_unreadable_photo" = "The captured photo could not be read.";
+"telegram_error_transport" = "Telegram could not be reached.";
+"telegram_error_http_status" = "Telegram returned HTTP status %d.";
+"telegram_error_rejected" = "Telegram rejected the request.";
+"telegram_error_invalid_response" = "Telegram returned an invalid response.";
+"telegram_error_settings_unavailable" = "Telegram settings could not be read.";
+"telegram_error_file_cleanup" = "The captured photo could not be deleted.";
+"telegram_error_keychain_status" = "Keychain operation failed (%d).";
+"telegram_failure_notification_subtitle" = "Telegram notification failed";
+"telegram_message_time" = "Time";
+"telegram_message_rssi" = "RSSI";
+"telegram_message_coordinates" = "GPS Coordinates";
+"telegram_message_accuracy" = "Location Accuracy";
+"telegram_message_map" = "Map";
+"telegram_location_unavailable" = "The location at capture time is unavailable.";
+"telegram_location_error" = "The Mac location could not be obtained.";
+"telegram_location_send_error" = "The photo was sent, but the Telegram map location could not be sent.";