From d1f203c6c642fdca33a232ffb26a1cd026eeaf49 Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 17:49:19 +0700
Subject: [PATCH 1/9] feat(monitoring): add TCP/SSH monitor provider and UI
support
---
.../Configuration/MonitorConfiguration.swift | 2 +-
Pulse/Core/Monitoring/MonitorEngine.swift | 11 ++-
.../Providers/TCPMonitorProvider.swift | 71 +++++++++++++++++++
.../Features/Settings/MonitorDetailView.swift | 47 ++++++++++++
4 files changed, 127 insertions(+), 4 deletions(-)
create mode 100644 Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
diff --git a/Pulse/Core/Configuration/MonitorConfiguration.swift b/Pulse/Core/Configuration/MonitorConfiguration.swift
index 9f1dfd1..eda700d 100644
--- a/Pulse/Core/Configuration/MonitorConfiguration.swift
+++ b/Pulse/Core/Configuration/MonitorConfiguration.swift
@@ -97,7 +97,7 @@ enum MonitorType: String, Codable, Sendable, CaseIterable, Identifiable {
}
/// Monitor types that have a fully implemented provider.
- static let implemented: [MonitorType] = [.http, .betterstack, .atlassian]
+ static let implemented: [MonitorType] = [.http, .tcp, .betterstack, .atlassian]
/// Whether this type monitors a status page rather than probing directly.
var isStatusPage: Bool {
diff --git a/Pulse/Core/Monitoring/MonitorEngine.swift b/Pulse/Core/Monitoring/MonitorEngine.swift
index c7fb9d6..b40c48a 100644
--- a/Pulse/Core/Monitoring/MonitorEngine.swift
+++ b/Pulse/Core/Monitoring/MonitorEngine.swift
@@ -157,10 +157,15 @@ final class MonitorEngine {
await self?.pollAggregated(provider: atlassianProvider, key: key, monitorType: monitorType, frequency: frequency)
}
- case .tcp, .statusio, .incidentio:
- // Not yet implemented — show unknown state.
+ case .tcp:
+ guard let config = monitor.tcp else { return }
+ let tcpProvider = TCPMonitorProvider(config: config)
initializeSingleState(key: key, monitorType: monitorType)
- logger.info("Monitor type '\(monitorType.rawValue)' not yet implemented for '\(monitor.name)'.")
+ pollTasks[key] = Task { [weak self] in
+ await self?.pollSingle(provider: tcpProvider, key: key, frequency: frequency)
+ }
+
+ case .statusio, .incidentio:
}
}
diff --git a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
new file mode 100644
index 0000000..665cc96
--- /dev/null
+++ b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
@@ -0,0 +1,71 @@
+import Foundation
+import Network
+import os
+
+/// Performs TCP connectivity checks against a configured host and port.
+struct TCPMonitorProvider: MonitorProvider {
+ private let config: TCPMonitorConfig
+ private let logger = Logger(subsystem: "com.sattlerjoshua.Pulse", category: "TCPMonitor")
+
+ init(config: TCPMonitorConfig) {
+ self.config = config
+ }
+
+ func check() async throws -> CheckResult {
+ let endpoint = NWEndpoint.hostPort(
+ host: NWEndpoint.Host(config.host),
+ port: NWEndpoint.Port(integerLiteral: UInt16(config.port))
+ )
+ let connection = NWConnection(to: endpoint, using: .tcp)
+
+ let start = ContinuousClock.now
+
+ return await withCheckedContinuation { continuation in
+ var hasResponded = false
+
+ connection.stateUpdateHandler = { state in
+ switch state {
+ case .ready:
+ if !hasResponded {
+ hasResponded = true
+ connection.cancel()
+ let elapsed = ContinuousClock.now - start
+ continuation.resume(returning: CheckResult(
+ status: .operational,
+ responseTime: elapsed,
+ timestamp: .now
+ ))
+ }
+ case .failed(let error):
+ if !hasResponded {
+ hasResponded = true
+ connection.cancel()
+ continuation.resume(returning: CheckResult(
+ status: .downtime,
+ timestamp: .now,
+ message: error.localizedDescription
+ ))
+ }
+ default:
+ break
+ }
+ }
+
+ // Timeout after 5 seconds if no response.
+ Task {
+ try? await Task.sleep(for: .seconds(5))
+ if !hasResponded {
+ hasResponded = true
+ connection.cancel()
+ continuation.resume(returning: CheckResult(
+ status: .downtime,
+ timestamp: .now,
+ message: "Connection timed out"
+ ))
+ }
+ }
+
+ connection.start(queue: .global())
+ }
+ }
+}
diff --git a/Pulse/Features/Settings/MonitorDetailView.swift b/Pulse/Features/Settings/MonitorDetailView.swift
index 481271f..a25eaae 100644
--- a/Pulse/Features/Settings/MonitorDetailView.swift
+++ b/Pulse/Features/Settings/MonitorDetailView.swift
@@ -24,6 +24,10 @@ struct MonitorDetailView: View {
@State private var checkFrequency: String = "60"
@State private var failureThreshold: String = "1"
+ // TCP fields
+ @State private var tcpHost: String = ""
+ @State private var tcpPort: String = "22"
+
// Status page fields
@State private var statusPageURL: String = ""
@@ -49,6 +53,8 @@ struct MonitorDetailView: View {
switch monitorType {
case .http:
return !httpURL.trimmingCharacters(in: .whitespaces).isEmpty
+ case .tcp:
+ return !tcpHost.trimmingCharacters(in: .whitespaces).isEmpty && Int(tcpPort) != nil
case .betterstack, .atlassian:
return !statusPageURL.trimmingCharacters(in: .whitespaces).isEmpty
default:
@@ -80,6 +86,13 @@ struct MonitorDetailView: View {
checkFrequency: $checkFrequency,
failureThreshold: $failureThreshold
)
+ case .tcp:
+ TCPMonitorSection(
+ host: $tcpHost,
+ port: $tcpPort,
+ checkFrequency: $checkFrequency,
+ failureThreshold: $failureThreshold
+ )
case .betterstack, .atlassian:
StatusPageMonitorSection(url: $statusPageURL, monitorType: monitorType)
default:
@@ -132,6 +145,13 @@ struct MonitorDetailView: View {
failureThreshold = http.failureThreshold.map(String.init) ?? "1"
}
+ if let tcp = monitor.tcp {
+ tcpHost = tcp.host
+ tcpPort = String(tcp.port)
+ checkFrequency = tcp.checkFrequency.map(String.init) ?? "60"
+ failureThreshold = tcp.failureThreshold.map(String.init) ?? "1"
+ }
+
if let config = monitor.betterstack ?? monitor.atlassian {
statusPageURL = config.url
}
@@ -158,6 +178,14 @@ struct MonitorDetailView: View {
failureThreshold: Int(failureThreshold)
)
+ case .tcp:
+ monitor.tcp = TCPMonitorConfig(
+ host: tcpHost.trimmingCharacters(in: .whitespaces),
+ port: Int(tcpPort) ?? 0,
+ checkFrequency: Int(checkFrequency),
+ failureThreshold: Int(failureThreshold)
+ )
+
case .betterstack:
monitor.betterstack = StatusPageMonitorConfig(
url: statusPageURL.trimmingCharacters(in: .whitespaces),
@@ -212,6 +240,25 @@ struct HTTPMonitorSection: View {
}
}
+// MARK: - TCP Monitor Section
+
+/// Form section with fields specific to TCP monitors.
+struct TCPMonitorSection: View {
+ @Binding var host: String
+ @Binding var port: String
+ @Binding var checkFrequency: String
+ @Binding var failureThreshold: String
+
+ var body: some View {
+ Section("TCP / SSH") {
+ TextField("Host", text: $host, prompt: Text("example.com or 1.2.3.4"))
+ TextField("Port", text: $port, prompt: Text("22"))
+ TextField("Check Frequency (seconds)", text: $checkFrequency, prompt: Text("60"))
+ TextField("Failure Threshold", text: $failureThreshold, prompt: Text("1"))
+ }
+ }
+}
+
// MARK: - Status Page Monitor Section
/// Form section with fields specific to status page monitors.
From 9e0b77801cc91f357c015378dade29bf49de758c Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 17:52:15 +0700
Subject: [PATCH 2/9] chore(ci): add automatic release workflow
---
.github/workflows/auto-release.yml | 81 ++++++++++++++++++++++++++++++
1 file changed, 81 insertions(+)
create mode 100644 .github/workflows/auto-release.yml
diff --git a/.github/workflows/auto-release.yml b/.github/workflows/auto-release.yml
new file mode 100644
index 0000000..344c9a3
--- /dev/null
+++ b/.github/workflows/auto-release.yml
@@ -0,0 +1,81 @@
+name: Auto Release
+
+on:
+ push:
+ branches: [ main ]
+ tags:
+ - 'v*'
+ workflow_dispatch:
+
+permissions:
+ contents: write
+
+jobs:
+ build:
+ runs-on: macos-latest
+ steps:
+ - name: Checkout repository
+ uses: actions/checkout@v4
+ with:
+ fetch-depth: 0
+
+ - name: Select Xcode version
+ run: sudo xcode-select -s /Applications/Xcode_16.0.app
+
+ - name: Determine version
+ id: version
+ run: |
+ if [[ $GITHUB_REF == refs/tags/* ]]; then
+ VERSION=${GITHUB_REF#refs/tags/}
+ else
+ # Auto-versioning: vYYYY.MM.DD.RUN_NUMBER
+ VERSION="v$(date +'%Y.%m.%d').${{ github.run_number }}"
+ fi
+ echo "version=$VERSION" >> $GITHUB_OUTPUT
+ echo "Build version: $VERSION"
+
+ - name: Build application
+ run: |
+ # Build without signing for CI (unless certificates are provided)
+ xcodebuild build \
+ -project Pulse.xcodeproj \
+ -scheme Pulse \
+ -configuration Release \
+ -derivedDataPath Build \
+ CODE_SIGN_IDENTITY="" \
+ CODE_SIGNING_REQUIRED=NO \
+ CODE_SIGNING_ALLOWED=NO \
+ MARKETING_VERSION="${{ steps.version.outputs.version }}" \
+ CURRENT_PROJECT_VERSION="${{ github.run_number }}"
+
+ - name: Create DMG
+ run: |
+ APP_NAME="Pulse"
+ VERSION="${{ steps.version.outputs.version }}"
+ DMG_NAME="${APP_NAME}-${VERSION}.dmg"
+
+ # Prepare folder for DMG
+ mkdir -p dist_folder
+ cp -R Build/Build/Products/Release/${APP_NAME}.app dist_folder/
+ ln -s /Applications dist_folder/Applications
+
+ # Create DMG
+ hdiutil create -volname "${APP_NAME}" \
+ -srcfolder dist_folder \
+ -ov -format UDZO \
+ "${DMG_NAME}"
+
+ echo "dmg_name=${DMG_NAME}" >> $GITHUB_OUTPUT
+ id: package
+
+ - name: Create Release
+ uses: softprops/action-gh-release@v2
+ with:
+ tag_name: ${{ steps.version.outputs.version }}
+ name: Pulse ${{ steps.version.outputs.version }}
+ files: ${{ steps.package.outputs.dmg_name }}
+ generate_release_notes: true
+ draft: false
+ prerelease: false
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
From 608ad9f641226e0299634d268f3d07c46f173cb1 Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 17:57:03 +0700
Subject: [PATCH 3/9] fix(monitoring): resolved build errors and concurrency
warnings
---
Pulse/Core/Monitoring/MonitorEngine.swift | 1 +
.../Providers/TCPMonitorProvider.swift | 30 ++++++++++++++-----
2 files changed, 23 insertions(+), 8 deletions(-)
diff --git a/Pulse/Core/Monitoring/MonitorEngine.swift b/Pulse/Core/Monitoring/MonitorEngine.swift
index b40c48a..9feef70 100644
--- a/Pulse/Core/Monitoring/MonitorEngine.swift
+++ b/Pulse/Core/Monitoring/MonitorEngine.swift
@@ -166,6 +166,7 @@ final class MonitorEngine {
}
case .statusio, .incidentio:
+ break
}
}
diff --git a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
index 665cc96..245d726 100644
--- a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
+++ b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
@@ -19,15 +19,19 @@ struct TCPMonitorProvider: MonitorProvider {
let connection = NWConnection(to: endpoint, using: .tcp)
let start = ContinuousClock.now
+ let lock = OSAllocatedUnfairLock(initialState: false)
return await withCheckedContinuation { continuation in
- var hasResponded = false
-
connection.stateUpdateHandler = { state in
switch state {
case .ready:
- if !hasResponded {
- hasResponded = true
+ let alreadyResponded = lock.withLock { isResponded in
+ let original = isResponded
+ isResponded = true
+ return original
+ }
+
+ if !alreadyResponded {
connection.cancel()
let elapsed = ContinuousClock.now - start
continuation.resume(returning: CheckResult(
@@ -37,8 +41,13 @@ struct TCPMonitorProvider: MonitorProvider {
))
}
case .failed(let error):
- if !hasResponded {
- hasResponded = true
+ let alreadyResponded = lock.withLock { isResponded in
+ let original = isResponded
+ isResponded = true
+ return original
+ }
+
+ if !alreadyResponded {
connection.cancel()
continuation.resume(returning: CheckResult(
status: .downtime,
@@ -54,8 +63,13 @@ struct TCPMonitorProvider: MonitorProvider {
// Timeout after 5 seconds if no response.
Task {
try? await Task.sleep(for: .seconds(5))
- if !hasResponded {
- hasResponded = true
+ let alreadyResponded = lock.withLock { isResponded in
+ let original = isResponded
+ isResponded = true
+ return original
+ }
+
+ if !alreadyResponded {
connection.cancel()
continuation.resume(returning: CheckResult(
status: .downtime,
From c89b2560c7ee313df20bca07f5cd1c64e472bf6a Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 18:20:17 +0700
Subject: [PATCH 4/9] fix(security): add network entitlements for sandbox
---
Pulse/Pulse.entitlements | 9 ++++++++-
1 file changed, 8 insertions(+), 1 deletion(-)
diff --git a/Pulse/Pulse.entitlements b/Pulse/Pulse.entitlements
index 0c67376..38da9a9 100644
--- a/Pulse/Pulse.entitlements
+++ b/Pulse/Pulse.entitlements
@@ -1,5 +1,12 @@
-
+
+ com.apple.security.app-sandbox
+
+ com.apple.security.network.client
+
+ com.apple.security.files.user-selected.read-write
+
+
From 0c17ae26828418b1f397f461db000804b9a66902 Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 18:21:49 +0700
Subject: [PATCH 5/9] debug(monitoring): add logging to TCP check
---
Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
index 245d726..9f93fb4 100644
--- a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
+++ b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
@@ -23,6 +23,7 @@ struct TCPMonitorProvider: MonitorProvider {
return await withCheckedContinuation { continuation in
connection.stateUpdateHandler = { state in
+ self.logger.debug("TCP state update for \(self.config.host):\(self.config.port): \(String(describing: state))")
switch state {
case .ready:
let alreadyResponded = lock.withLock { isResponded in
@@ -32,6 +33,7 @@ struct TCPMonitorProvider: MonitorProvider {
}
if !alreadyResponded {
+ self.logger.info("TCP connection ready for \(self.config.host):\(self.config.port)")
connection.cancel()
let elapsed = ContinuousClock.now - start
continuation.resume(returning: CheckResult(
@@ -48,6 +50,7 @@ struct TCPMonitorProvider: MonitorProvider {
}
if !alreadyResponded {
+ self.logger.warning("TCP connection failed for \(self.config.host):\(self.config.port): \(error.localizedDescription)")
connection.cancel()
continuation.resume(returning: CheckResult(
status: .downtime,
@@ -55,6 +58,8 @@ struct TCPMonitorProvider: MonitorProvider {
message: error.localizedDescription
))
}
+ case .waiting(let error):
+ self.logger.debug("TCP connection waiting for \(self.config.host):\(self.config.port): \(error.localizedDescription)")
default:
break
}
From 7e24b50506197dfc7474a1910f1d7bebb2080000 Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 18:33:13 +0700
Subject: [PATCH 6/9] fix(monitoring): hardened TCP check logic and expanded
error states
---
.../Providers/TCPMonitorProvider.swift | 72 ++++++++-----------
1 file changed, 31 insertions(+), 41 deletions(-)
diff --git a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
index 9f93fb4..277b8d1 100644
--- a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
+++ b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
@@ -6,6 +6,7 @@ import os
struct TCPMonitorProvider: MonitorProvider {
private let config: TCPMonitorConfig
private let logger = Logger(subsystem: "com.sattlerjoshua.Pulse", category: "TCPMonitor")
+ private let queue = DispatchQueue(label: "com.sattlerjoshua.Pulse.tcp-check")
init(config: TCPMonitorConfig) {
self.config = config
@@ -16,75 +17,64 @@ struct TCPMonitorProvider: MonitorProvider {
host: NWEndpoint.Host(config.host),
port: NWEndpoint.Port(integerLiteral: UInt16(config.port))
)
- let connection = NWConnection(to: endpoint, using: .tcp)
- let start = ContinuousClock.now
+ let parameters = NWParameters.tcp
+ // Request immediate failure if path is constrained or expensive if needed,
+ // but for now let's just use defaults with a strict timeout.
+
+ let connection = NWConnection(to: endpoint, using: parameters)
let lock = OSAllocatedUnfairLock(initialState: false)
+ let start = ContinuousClock.now
return await withCheckedContinuation { continuation in
connection.stateUpdateHandler = { state in
self.logger.debug("TCP state update for \(self.config.host):\(self.config.port): \(String(describing: state))")
+
switch state {
case .ready:
- let alreadyResponded = lock.withLock { isResponded in
- let original = isResponded
- isResponded = true
- return original
- }
-
- if !alreadyResponded {
- self.logger.info("TCP connection ready for \(self.config.host):\(self.config.port)")
- connection.cancel()
- let elapsed = ContinuousClock.now - start
- continuation.resume(returning: CheckResult(
- status: .operational,
- responseTime: elapsed,
- timestamp: .now
- ))
- }
+ complete(with: .operational, message: nil)
case .failed(let error):
- let alreadyResponded = lock.withLock { isResponded in
- let original = isResponded
- isResponded = true
- return original
- }
-
- if !alreadyResponded {
- self.logger.warning("TCP connection failed for \(self.config.host):\(self.config.port): \(error.localizedDescription)")
- connection.cancel()
- continuation.resume(returning: CheckResult(
- status: .downtime,
- timestamp: .now,
- message: error.localizedDescription
- ))
- }
+ complete(with: .downtime, message: error.localizedDescription)
case .waiting(let error):
- self.logger.debug("TCP connection waiting for \(self.config.host):\(self.config.port): \(error.localizedDescription)")
+ // For a health check, staying in .waiting is equivalent to downtime.
+ // This often happens with 'Connection Refused' error codes.
+ complete(with: .downtime, message: "Waiting/Refused: \(error.localizedDescription)")
default:
break
}
}
- // Timeout after 5 seconds if no response.
- Task {
- try? await Task.sleep(for: .seconds(5))
+ func complete(with status: MonitorStatus, message: String?) {
let alreadyResponded = lock.withLock { isResponded in
let original = isResponded
isResponded = true
return original
}
-
+
if !alreadyResponded {
+ // It is important to cancel the connection once we have a result.
+ connection.stateUpdateHandler = nil
connection.cancel()
+
+ let elapsed = ContinuousClock.now - start
+ self.logger.info("TCP check for \(self.config.host):\(self.config.port) completed: \(status.rawValue) in \(elapsed)")
+
continuation.resume(returning: CheckResult(
- status: .downtime,
+ status: status,
+ responseTime: elapsed,
timestamp: .now,
- message: "Connection timed out"
+ message: message
))
}
}
- connection.start(queue: .global())
+ // Hard timeout at 5 seconds.
+ Task {
+ try? await Task.sleep(for: .seconds(5))
+ complete(with: .downtime, message: "Timeout")
+ }
+
+ connection.start(queue: queue)
}
}
}
From 964fbce113f46d4452ab90f5349fbe48c601c73e Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 19:00:07 +0700
Subject: [PATCH 7/9] feat(monitoring): add verify handshake option for TCP
checks
---
.../Configuration/MonitorConfiguration.swift | 3 +++
.../Providers/TCPMonitorProvider.swift | 26 ++++++++++++++-----
.../Features/Settings/MonitorDetailView.swift | 11 ++++++--
3 files changed, 31 insertions(+), 9 deletions(-)
diff --git a/Pulse/Core/Configuration/MonitorConfiguration.swift b/Pulse/Core/Configuration/MonitorConfiguration.swift
index eda700d..bd737f7 100644
--- a/Pulse/Core/Configuration/MonitorConfiguration.swift
+++ b/Pulse/Core/Configuration/MonitorConfiguration.swift
@@ -155,6 +155,9 @@ struct TCPMonitorConfig: Codable, Sendable, Hashable {
/// Consecutive failures before the monitor is considered down.
var failureThreshold: Int?
+
+ /// If true, the check will wait for a response from the server (e.g. for SSH banners).
+ var expectResponse: Bool?
}
// MARK: - Status Page Monitor
diff --git a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
index 277b8d1..4624079 100644
--- a/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
+++ b/Pulse/Core/Monitoring/Providers/TCPMonitorProvider.swift
@@ -19,9 +19,6 @@ struct TCPMonitorProvider: MonitorProvider {
)
let parameters = NWParameters.tcp
- // Request immediate failure if path is constrained or expensive if needed,
- // but for now let's just use defaults with a strict timeout.
-
let connection = NWConnection(to: endpoint, using: parameters)
let lock = OSAllocatedUnfairLock(initialState: false)
let start = ContinuousClock.now
@@ -32,18 +29,34 @@ struct TCPMonitorProvider: MonitorProvider {
switch state {
case .ready:
- complete(with: .operational, message: nil)
+ if config.expectResponse == true {
+ // Start receiving data to verify the handshake
+ self.logger.debug("TCP [\(self.config.host)] ready, waiting for data...")
+ receiveBanner(connection: connection)
+ } else {
+ complete(with: .operational, message: nil)
+ }
case .failed(let error):
complete(with: .downtime, message: error.localizedDescription)
case .waiting(let error):
- // For a health check, staying in .waiting is equivalent to downtime.
- // This often happens with 'Connection Refused' error codes.
complete(with: .downtime, message: "Waiting/Refused: \(error.localizedDescription)")
default:
break
}
}
+ func receiveBanner(connection: NWConnection) {
+ connection.receive(minimumIncompleteLength: 1, maximumLength: 1024) { content, _, isComplete, error in
+ if let error = error {
+ complete(with: .downtime, message: "Read failed: \(error.localizedDescription)")
+ } else if content != nil {
+ complete(with: .operational, message: nil)
+ } else if isComplete {
+ complete(with: .downtime, message: "Connection closed by server without data")
+ }
+ }
+ }
+
func complete(with status: MonitorStatus, message: String?) {
let alreadyResponded = lock.withLock { isResponded in
let original = isResponded
@@ -52,7 +65,6 @@ struct TCPMonitorProvider: MonitorProvider {
}
if !alreadyResponded {
- // It is important to cancel the connection once we have a result.
connection.stateUpdateHandler = nil
connection.cancel()
diff --git a/Pulse/Features/Settings/MonitorDetailView.swift b/Pulse/Features/Settings/MonitorDetailView.swift
index a25eaae..791b3c2 100644
--- a/Pulse/Features/Settings/MonitorDetailView.swift
+++ b/Pulse/Features/Settings/MonitorDetailView.swift
@@ -27,6 +27,7 @@ struct MonitorDetailView: View {
// TCP fields
@State private var tcpHost: String = ""
@State private var tcpPort: String = "22"
+ @State private var tcpExpectResponse: Bool = false
// Status page fields
@State private var statusPageURL: String = ""
@@ -91,7 +92,8 @@ struct MonitorDetailView: View {
host: $tcpHost,
port: $tcpPort,
checkFrequency: $checkFrequency,
- failureThreshold: $failureThreshold
+ failureThreshold: $failureThreshold,
+ expectResponse: $tcpExpectResponse
)
case .betterstack, .atlassian:
StatusPageMonitorSection(url: $statusPageURL, monitorType: monitorType)
@@ -148,6 +150,7 @@ struct MonitorDetailView: View {
if let tcp = monitor.tcp {
tcpHost = tcp.host
tcpPort = String(tcp.port)
+ tcpExpectResponse = tcp.expectResponse ?? false
checkFrequency = tcp.checkFrequency.map(String.init) ?? "60"
failureThreshold = tcp.failureThreshold.map(String.init) ?? "1"
}
@@ -183,7 +186,8 @@ struct MonitorDetailView: View {
host: tcpHost.trimmingCharacters(in: .whitespaces),
port: Int(tcpPort) ?? 0,
checkFrequency: Int(checkFrequency),
- failureThreshold: Int(failureThreshold)
+ failureThreshold: Int(failureThreshold),
+ expectResponse: tcpExpectResponse
)
case .betterstack:
@@ -248,11 +252,14 @@ struct TCPMonitorSection: View {
@Binding var port: String
@Binding var checkFrequency: String
@Binding var failureThreshold: String
+ @Binding var expectResponse: Bool
var body: some View {
Section("TCP / SSH") {
TextField("Host", text: $host, prompt: Text("example.com or 1.2.3.4"))
TextField("Port", text: $port, prompt: Text("22"))
+ Toggle("Verify Service Handshake", isOn: $expectResponse)
+ .help("If enabled, Pulse waits for the server to send data (e.g. an SSH banner) after connecting.")
TextField("Check Frequency (seconds)", text: $checkFrequency, prompt: Text("60"))
TextField("Failure Threshold", text: $failureThreshold, prompt: Text("1"))
}
From d0f34ee1e7623c2820d6a71d09ae5cae9dbd3b23 Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 19:23:58 +0700
Subject: [PATCH 8/9] fix(security): allow insecure HTTP loads in Info.plist
---
Pulse/Info.plist | 5 +++++
1 file changed, 5 insertions(+)
diff --git a/Pulse/Info.plist b/Pulse/Info.plist
index c1cfff2..0266788 100644
--- a/Pulse/Info.plist
+++ b/Pulse/Info.plist
@@ -6,6 +6,11 @@
Pulse needs local network access to monitor the health of services on your network.
NSUserNotificationUsageDescription
Pulse sends notifications when a monitored service changes status.
+ NSAppTransportSecurity
+
+ NSAllowsArbitraryLoads
+
+
SUFeedURL
https://github.com/jsattler/Pulse/releases/latest/download/appcast.xml
SUPublicEDKey
From c16afb41a3f1381b2430802437006a4daabe0fcf Mon Sep 17 00:00:00 2001
From: Dmitry <35992274+iwizard7@users.noreply.github.com>
Date: Thu, 16 Apr 2026 19:32:55 +0700
Subject: [PATCH 9/9] style(assets): restored app icon from website resources
---
.../Contents.json | 30 ++++++++++++------
.../Pulse.appiconset/icon_1024.png | Bin 0 -> 1355817 bytes
.../Pulse.appiconset/icon_128.png | Bin 0 -> 1355817 bytes
.../Pulse.appiconset/icon_16.png | Bin 0 -> 1355817 bytes
.../Pulse.appiconset/icon_256.png | Bin 0 -> 1355817 bytes
.../Pulse.appiconset/icon_32.png | Bin 0 -> 1355817 bytes
.../Pulse.appiconset/icon_512.png | Bin 0 -> 1355817 bytes
7 files changed, 20 insertions(+), 10 deletions(-)
rename Pulse/Assets.xcassets/{AppIcon.appiconset => Pulse.appiconset}/Contents.json (53%)
create mode 100644 Pulse/Assets.xcassets/Pulse.appiconset/icon_1024.png
create mode 100644 Pulse/Assets.xcassets/Pulse.appiconset/icon_128.png
create mode 100644 Pulse/Assets.xcassets/Pulse.appiconset/icon_16.png
create mode 100644 Pulse/Assets.xcassets/Pulse.appiconset/icon_256.png
create mode 100644 Pulse/Assets.xcassets/Pulse.appiconset/icon_32.png
create mode 100644 Pulse/Assets.xcassets/Pulse.appiconset/icon_512.png
diff --git a/Pulse/Assets.xcassets/AppIcon.appiconset/Contents.json b/Pulse/Assets.xcassets/Pulse.appiconset/Contents.json
similarity index 53%
rename from Pulse/Assets.xcassets/AppIcon.appiconset/Contents.json
rename to Pulse/Assets.xcassets/Pulse.appiconset/Contents.json
index 3f00db4..3b49269 100644
--- a/Pulse/Assets.xcassets/AppIcon.appiconset/Contents.json
+++ b/Pulse/Assets.xcassets/Pulse.appiconset/Contents.json
@@ -3,52 +3,62 @@
{
"idiom" : "mac",
"scale" : "1x",
- "size" : "16x16"
+ "size" : "16x16",
+ "filename": "icon_16.png"
},
{
"idiom" : "mac",
"scale" : "2x",
- "size" : "16x16"
+ "size" : "16x16",
+ "filename": "icon_32.png"
},
{
"idiom" : "mac",
"scale" : "1x",
- "size" : "32x32"
+ "size" : "32x32",
+ "filename": "icon_32.png"
},
{
"idiom" : "mac",
"scale" : "2x",
- "size" : "32x32"
+ "size" : "32x32",
+ "filename": "icon_128.png"
},
{
"idiom" : "mac",
"scale" : "1x",
- "size" : "128x128"
+ "size" : "128x128",
+ "filename": "icon_128.png"
},
{
"idiom" : "mac",
"scale" : "2x",
- "size" : "128x128"
+ "size" : "128x128",
+ "filename": "icon_256.png"
},
{
"idiom" : "mac",
"scale" : "1x",
- "size" : "256x256"
+ "size" : "256x256",
+ "filename": "icon_256.png"
},
{
"idiom" : "mac",
"scale" : "2x",
- "size" : "256x256"
+ "size" : "256x256",
+ "filename": "icon_512.png"
},
{
"idiom" : "mac",
"scale" : "1x",
- "size" : "512x512"
+ "size" : "512x512",
+ "filename": "icon_512.png"
},
{
"idiom" : "mac",
"scale" : "2x",
- "size" : "512x512"
+ "size" : "512x512",
+ "filename": "icon_1024.png"
}
],
"info" : {
diff --git a/Pulse/Assets.xcassets/Pulse.appiconset/icon_1024.png b/Pulse/Assets.xcassets/Pulse.appiconset/icon_1024.png
new file mode 100644
index 0000000000000000000000000000000000000000..7823b64ba8ed26f6983108158ab3809738925df2
GIT binary patch
literal 1355817
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