initial commit

Author: TaeJoongYoon

.gitignore

@@ -0,0 +1,124 @@
+### macOS ###
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+### macOS Patch ###
+# iCloud generated files
+*.icloud
+
+### Swift ###
+# Xcode
+#
+# gitignore contributors: remember to update Global/Xcode.gitignore, Objective-C.gitignore & Swift.gitignore
+
+## User settings
+xcuserdata/
+
+## compatibility with Xcode 8 and earlier (ignoring not required starting Xcode 9)
+*.xcscmblueprint
+*.xccheckout
+
+## compatibility with Xcode 3 and earlier (ignoring not required starting Xcode 4)
+build/
+DerivedData/
+*.moved-aside
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+
+## Obj-C/Swift specific
+*.hmap
+
+## App packaging
+*.ipa
+*.dSYM.zip
+*.dSYM
+
+## Playgrounds
+timeline.xctimeline
+playground.xcworkspace
+
+# Swift Package Manager
+# Add this line if you want to avoid checking in source code from Swift Package Manager dependencies.
+# Packages/
+# Package.pins
+# Package.resolved
+# *.xcodeproj
+# Xcode automatically generates this directory with a .xcworkspacedata file and xcuserdata
+# hence it is not needed unless you have added a package configuration file to your project
+.swiftpm
+
+.build/
+
+# CocoaPods
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+# Pods/
+# Add this line if you want to avoid checking in source code from the Xcode workspace
+# *.xcworkspace
+
+# Carthage
+# Add this line if you want to avoid checking in source code from Carthage dependencies.
+# Carthage/Checkouts
+
+Carthage/Build/
+
+# Accio dependency management
+Dependencies/
+.accio/
+
+# fastlane
+# It is recommended to not store the screenshots in the git repo.
+# Instead, use fastlane to re-generate the screenshots whenever they are needed.
+# For more information about the recommended setup visit:
+# https://docs.fastlane.tools/best-practices/source-control/#source-control
+
+fastlane/report.xml
+fastlane/Preview.html
+fastlane/screenshots/**/*.png
+fastlane/test_output
+
+# Code Injection
+# After new code Injection tools there's a generated folder /iOSInjectionProject
+# https://github.com/johnno1962/injectionforxcode
+
+iOSInjectionProject/
+
+### SwiftPackageManager ###
+Packages
+xcuserdata
+*.xcodeproj
+
+
+### SwiftPM ###

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [2025] [TaeJoongYoon]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Package.swift

@@ -0,0 +1,29 @@
+// swift-tools-version: 5.9
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "SwiftWebSocketClient",
+    platforms: [
+        .macOS(.v12),
+        .iOS(.v15),
+        .tvOS(.v15),
+        .watchOS(.v8)
+    ],
+    products: [
+        .library(
+            name: "SwiftWebSocketClient",
+            targets: ["SwiftWebSocketClient"]
+        ),
+    ],
+    targets: [
+        .target(
+            name: "SwiftWebSocketClient"
+        ),
+        .testTarget(
+            name: "SwiftWebSocketClientTests",
+            dependencies: ["SwiftWebSocketClient"]
+        ),
+    ]
+)

README.md

@@ -0,0 +1,78 @@
+# SwiftWebSocketClient
+
+[![Swift Version](https://img.shields.io/badge/Swift-5.9-orange.svg)]()
+[![Platform](https://img.shields.io/badge/Platform-iOS%20|%20macOS%20|%20watchOS%20|%20tvOS-blue.svg)]()
+[![License](https://img.shields.io/badge/License-MIT-lightgrey.svg)](https://opensource.org/licenses/MIT)
+
+A modern, easy-to-use WebSocket client for Swift, powered by Combine and async/await.
+
+## ✨ Features
+
+- [x] Modern Concurrency: Built with `async/await` and exposes streams via Combine `Publisher`.
+- [x] Protocol-Oriented: Easy to test and extend.
+- [x] Fluent Builder API: Intuitive and chainable configuration.
+- [x] Extensible with Decorators: Add custom functionalities like auto-reconnection with ease.
+- [x] Dual Backend Support: Choose between `URLSession` and `Network.framework`.
+
+## 📋 Requirements
+
+- iOS 15.0+ / macOS 12.0+ / watchOS 8.0+ / tvOS 15.0+
+- Swift 5.9+
+
+## 📦 Installation
+
+### Swift Package Manager
+
+You can add SwiftWebSocketClient to your project by adding it as a package dependency.
+
+1. In Xcode, open your project and navigate to **File > Add Packages...**
+2. Paste the repository URL: `https://github.com/TaeJoongYoon/SwiftWebSocketClient.git`
+3. Follow the prompts to add the package to your target.
+
+## 🚀 Quick Start
+
+Here's a basic example of how to connect and listen for messages:
+
+```swift
+import SwiftWebSocketClient
+import Combine
+
+let url = URL(string: "wss://yourwebsocketserver.com")!
+let client = WebSocketBuilder(url: url).build(implementation: .urlSession)
+
+var cancellables = Set<AnyCancellable>()
+
+// Subscribe to status updates
+client.status
+    .sink { status in
+        print("Connection Status: \(status)")
+        
+        // When connected, send a message.
+        if case .connected = status {
+            Task {
+                print("Sending 'Hello' to the server.")
+                try? await client.send(message: .string("Hello from Swift!"))
+            }
+        }
+    }
+    .store(in: &cancellables)
+
+// Subscribe to incoming messages
+client.message
+    .sink { message in
+        switch message {
+        case .string(let text):
+            print("Received message: \(text)")
+        case .data(let data):
+            print("Received data: \(data.count) bytes")
+        }
+    }
+    .store(in: &cancellables)
+
+// Connect to the server
+client.connect(autoListen: true)
+```
+
+## 📄 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

Sources/SwiftWebSocketClient/Builder/WebSocketBuilder+Configuration.swift

@@ -0,0 +1,22 @@
+//
+//  WebSocketBuilder+Configuration.swift
+//  SwiftWebSocketClient
+//
+//  Created by Tae joong Yoon on 9/5/25.
+//
+
+import Foundation
+
+public extension WebSocketBuilder {
+    /// A protocol for configurations that can be applied to a `WebSocketClient`.
+    ///
+    /// Each configuration is responsible for wrapping the client with a `Decorator`
+    /// to add new functionality, such as automatic reconnection or logging.
+    protocol Configuration {
+        /// Applies the configuration to a given `WebSocketClient` instance.
+        ///
+        /// - Parameter client: The client to be configured or wrapped.
+        /// - Returns: A new `Decorator` instance that wraps the client.
+        func apply(to client: WebSocketClient) -> any Decorator
+    }
+}

Sources/SwiftWebSocketClient/Builder/WebSocketBuilder+Decorator.swift

@@ -0,0 +1,47 @@
+//
+//  WebSocketBuilder+Decorator.swift
+//  SwiftWebSocketClient
+//
+//  Created by Tae joong Yoon on 9/5/25.
+//
+
+import Foundation
+import Combine
+
+public extension WebSocketBuilder {
+    /// A protocol that enables the Decorator pattern for `WebSocketClient`.
+    ///
+    /// Conforming to this protocol provides default implementations for all `WebSocketClient` methods,
+    /// forwarding calls to the underlying `client`. This allows you to create decorators
+    /// by only overriding the methods you need to customize.
+    protocol Decorator: WebSocketClient {
+        /// The underlying `WebSocketClient` instance that this decorator enhances.
+        var client: WebSocketClient { get }
+    }
+}
+
+/// Default implementations that forward calls to the wrapped client.
+public extension WebSocketBuilder.Decorator {
+    var status: AnyPublisher<WebSocketStatus, Never> { client.status }
+    var message: AnyPublisher<WebSocketMessage, Never> { client.message }
+
+    func connect(autoListen: Bool) {
+        client.connect(autoListen: autoListen)
+    }
+    
+    func ping() async throws {
+        try await client.ping()
+    }
+    
+    func send(message: WebSocketMessage) async throws {
+        try await client.send(message: message)
+    }
+    
+    func listen() async throws {
+        try await client.listen()
+    }
+    
+    func disconnect(closeCode: WebSocketCloseCode, reason: Data?) {
+        client.disconnect(closeCode: closeCode, reason: reason)
+    }
+}