Implement the play(_:) method (#4)

* Implement the `play(_:)` method

* Implement conformance to the Sendable protocol

* Update `CHANGELOG.md`

Author: ns-vasilev

CHANGELOG.md

@@ -2,9 +2,17 @@
 All notable changes to this project will be documented in this file.
 
 #### 1.x Releases
+- `1.2.x` Releases - [1.2.0](#120)
 - `1.1.x` Releases - [1.1.0](#110)
 - `1.0.x` Releases - [1.0.0](#100) | [1.0.1](#101)
 
+## [1.2.0](https://github.com/space-code/haptic-feedback/releases/tag/1.2.0)
+Released on 2025-01-08.
+
+#### Added
+- Implement the `play(_:)` method.
+  - Added in Pull Request [#4](https://github.com/space-code/haptic-feedback/pull/4).
+
 ## [1.1.0](https://github.com/space-code/haptic-feedback/releases/tag/1.1.0)
 Released on 2024-12-25.
 
@@ -24,4 +32,4 @@ Released on 2023-11-26.
 
 #### Added
 - Initial release of `haptic-feedback`.
-  - Added by [Nikita Vasilev](https://github.com/nik3212).
+  - Added by [Nikita Vasilev](https://github.com/nik3212).

Sources/HapticFeedback/Classes/Core/Helpers/OperationQueue+Serial.swift

@@ -0,0 +1,13 @@
+//
+// haptic-feedback
+// Copyright © 2025 Space Code. All rights reserved.
+//
+
+import Foundation
+extension OperationQueue {
+    static var serial: OperationQueue {
+        let queue = OperationQueue()
+        queue.maxConcurrentOperationCount = 1
+        return queue
+    }
+}

Sources/HapticFeedback/Classes/Core/Operations/HapticOperation.swift

@@ -0,0 +1,39 @@
+//
+// haptic-feedback
+// Copyright © 2025 Space Code. All rights reserved.
+//
+
+import Foundation
+
+/// An operation that triggers haptic feedback using the provided `HapticFeedback` object.
+/// This operation is executed on the main thread to ensure the haptic feedback is played properly.
+final class HapticOperation: Operation, @unchecked Sendable {
+    // MARK: - Properties
+
+    /// The `HapticFeedback` instance used to generate the haptic feedback.
+    private let haptic: HapticFeedback
+
+    // MARK: - Initialization
+
+    /// Initializes a `HapticOperation` with a specified `HapticFeedback` object.
+    ///
+    /// - Parameter haptic: The `HapticFeedback` instance that will generate the haptic feedback.
+    init(haptic: HapticFeedback) {
+        self.haptic = haptic
+    }
+
+    // MARK: - Operation Execution
+
+    /// The main method of the operation where the haptic feedback is triggered.
+    ///
+    /// This method ensures that the haptic feedback is generated on the main thread.
+    override func main() {
+        guard !isCancelled else {
+            return
+        }
+
+        DispatchQueue.main.sync {
+            self.haptic.generate()
+        }
+    }
+}

Sources/HapticFeedback/Classes/Core/Operations/WaitOperation.swift

@@ -0,0 +1,38 @@
+//
+// haptic-feedback
+// Copyright © 2025 Space Code. All rights reserved.
+//
+
+import Foundation
+
+/// An operation that introduces a delay for a specified duration.
+/// Used to sequence operations in the `HapticFeedback` queue.
+final class WaitOperation: Operation, @unchecked Sendable {
+    // MARK: - Properties
+
+    /// The duration of the wait in seconds.
+    private let duration: TimeInterval
+
+    // MARK: - Initialization
+
+    /// Initializes a `WaitOperation` with a specified delay duration.
+    ///
+    /// - Parameter duration: The time interval, in seconds, for which the operation should pause execution.
+    init(duration: TimeInterval) {
+        self.duration = duration
+    }
+
+    // MARK: - Operation Execution
+
+    /// The main method of the operation where the delay is applied.
+    ///
+    /// This method blocks the current thread for the specified duration.
+    override func main() {
+        guard !isCancelled else {
+            return
+        }
+
+        Thread.sleep(forTimeInterval: duration)
+        print("SLEEP")
+    }
+}

Sources/HapticFeedback/Classes/HapticFeedback.swift

@@ -1,10 +1,12 @@
 //
 // haptic-feedback
-// Copyright © 2024 Space Code. All rights reserved.
+// Copyright © 2025 Space Code. All rights reserved.
 //
 
 import UIKit
 
+// MARK: - HapticFeedback
+
 /// Enum defining different types of haptic feedback
 @MainActor
 public enum HapticFeedback: Equatable {
@@ -35,3 +37,48 @@ public enum HapticFeedback: Equatable {
         }
     }
 }
+
+extension HapticFeedback {
+    /// A private serial operation queue to ensure haptic feedback operations are executed sequentially.
+    private static let queue: OperationQueue = .serial
+
+    /// Plays a sequence of haptic feedback notes.
+    ///
+    /// - Parameter notes: An array of `Note` objects, each representing either a haptic feedback or a delay.
+    public static func play(_ notes: [Note]) {
+        guard queue.operations.isEmpty else {
+            return
+        }
+
+        for note in notes {
+            let operation = note.operation
+
+            if let last = queue.operations.last {
+                operation.addDependency(last)
+            }
+
+            queue.addOperation(operation)
+        }
+    }
+}
+
+// MARK: HapticFeedback.Note
+
+public extension HapticFeedback {
+    enum Note {
+        /// A haptic feedback event.
+        case haptic(HapticFeedback)
+        /// A delay before the next event.
+        case wait(TimeInterval)
+
+        /// Converts the note into an `Operation` for execution in the serial queue.
+        var operation: Operation {
+            switch self {
+            case let .haptic(haptic):
+                return HapticOperation(haptic: haptic)
+            case let .wait(duration):
+                return WaitOperation(duration: duration)
+            }
+        }
+    }
+}