Duration Convenience

codingiran · codingiran · commit 18f564ffae63 · 2025-07-14T12:45:45.000+08:00
diff --git a/Sources/NetworkPathMonitor/NetworkPathMonitor.swift b/Sources/NetworkPathMonitor/NetworkPathMonitor.swift
@@ -16,7 +16,7 @@ import Network
 
 public enum NetworkPathMonitorInfo: Sendable {
     /// Current NetworkPathMonitor version.
-    public static let version = "0.0.5"
+    public static let version = "0.0.6"
 }
 
 /// A class that monitors network path changes using `NWPathMonitor`.
@@ -27,7 +27,7 @@ public actor NetworkPathMonitor {
     private let monitorQueue: DispatchQueue
 
     /// Debounce interval in seconds.
-    private let debounceInterval: TimeInterval
+    private let debounceInterval: Interval
 
     /// Ignore first path update.
     private let ignoreFirstPathUpdate: Bool
@@ -55,13 +55,13 @@ public actor NetworkPathMonitor {
 
     /// Initializes a new instance of `NetworkPathMonitor`.
     /// - Parameter queue: The queue on which the network path monitor runs. Default is a serial queue with a unique label.
-    /// - Parameter debounceInterval: Debounce interval in seconds. If set to 0, no debounce will be applied. Default is 0 seconds.
+    /// - Parameter debounceInterval: Debounce interval. If set to 0, no debounce will be applied. Default is 0 seconds.
     /// - Parameter ignoreFirstPathUpdate: Ignore first path update. Default is false.
     public init(queue: DispatchQueue = .init(label: "com.networkPathMonitor.\(UUID())"),
-                debounceInterval: TimeInterval = 0,
+                debounceInterval: Interval = .seconds(0),
                 ignoreFirstPathUpdate: Bool = false)
     {
-        precondition(debounceInterval >= 0, "debounceInterval must be greater than or equal to 0")
+        precondition(debounceInterval.nanoseconds >= 0, "debounceInterval must be greater than or equal to 0")
         monitorQueue = queue
         currentPath = networkMonitor.currentPath
         self.debounceInterval = debounceInterval
@@ -111,7 +111,7 @@ public actor NetworkPathMonitor {
         }
 
         debounceTask?.cancel()
-        guard debounceInterval > 0 else {
+        guard debounceInterval.nanoseconds > 0 else {
             // No debounce, yield immediately
             debounceTask = nil
             await yieldNetworkPath(path)
@@ -120,7 +120,7 @@ public actor NetworkPathMonitor {
         // Debounce is active
         debounceTask = Task {
             do {
-                try await Task.sleep(nanoseconds: UInt64(self.debounceInterval * 1_000_000_000))
+                try await Task.sleep(nanoseconds: UInt64(self.debounceInterval.nanoseconds))
                 await self.yieldNetworkPath(path)
             } catch is CancellationError {
                 // Task was cancelled, do nothing
@@ -184,3 +184,30 @@ public extension NetworkPathMonitor {
         networkPathUpdater = handler
     }
 }
+
+// MARK: - Duration Convenience
+
+public extension NetworkPathMonitor {
+    enum Interval: Sendable {
+        case nanoseconds(_: Int)
+        case microseconds(_: Int)
+        case milliseconds(_: Int)
+        case seconds(_: Double)
+        case minutes(_: Int)
+
+        var nanoseconds: Int {
+            switch self {
+            case let .nanoseconds(value):
+                return value
+            case let .microseconds(value):
+                return value * 1000
+            case let .milliseconds(value):
+                return value * 1_000_000
+            case let .seconds(value):
+                return Int(value * 1_000_000_000)
+            case let .minutes(value):
+                return value * 60 * 1_000_000_000
+            }
+        }
+    }
+}
diff --git a/Tests/NetworkPathMonitorTests/NetworkPathMonitorTests.swift b/Tests/NetworkPathMonitorTests/NetworkPathMonitorTests.swift
@@ -29,7 +29,7 @@ class NetworkPathMonitorTests: XCTestCase, @unchecked Sendable {
         XCTAssertNotNil(currentPath)
 
         // Test with custom debounce interval
-        let debounceMonitor = NetworkPathMonitor(debounceInterval: 1.0)
+        let debounceMonitor = NetworkPathMonitor(debounceInterval: .seconds(1.0))
         let debounceIsActive = await debounceMonitor.isActive
         XCTAssertFalse(debounceIsActive)
     }
@@ -129,7 +129,7 @@ class NetworkPathMonitorTests: XCTestCase, @unchecked Sendable {
     // MARK: - Debounce Tests
 
     func testDebounceInterval() async throws {
-        let debounceMonitor = NetworkPathMonitor(debounceInterval: 0.5)
+        let debounceMonitor = NetworkPathMonitor(debounceInterval: .seconds(0.5))
         let expectation = XCTestExpectation(description: "Debounced path update")
         var updateCount = 0
 
@@ -247,7 +247,7 @@ class NetworkPathMonitorTests: XCTestCase, @unchecked Sendable {
 
     func testIgnoreFirstPathUpdateWithDebounce() async {
         let debounceIgnoreMonitor = NetworkPathMonitor(
-            debounceInterval: 0.5,
+            debounceInterval: .seconds(0.5),
             ignoreFirstPathUpdate: true
         )
         let expectation = XCTestExpectation(description: "First debounced update should be ignored")
