Introduce async streams support

.github/actionlint-matcher.json

@@ -0,0 +1,17 @@
+{
+  "problemMatcher": [
+    {
+      "owner": "actionlint",
+      "pattern": [
+        {
+          "regexp": "^(?:\\x1b\\[\\d+m)?(.+?)(?:\\x1b\\[\\d+m)?:(?:\\x1b\\[\\d+m)?(\\d+)(?:\\x1b\\[\\d+m)?:(?:\\x1b\\[\\d+m)?(\\d+)(?:\\x1b\\[\\d+m)?: (?:\\x1b\\[\\d+m)?(.+?)(?:\\x1b\\[\\d+m)? \\[(.+?)\\]$",
+          "file": 1,
+          "line": 2,
+          "column": 3,
+          "message": 4,
+          "code": 5
+        }
+      ]
+    }
+  ]
+}

.github/workflows/lint-swift.yml

@@ -0,0 +1,26 @@
+name: Lint Swift
+
+on:
+  pull_request:
+    branches:
+      - '*'
+    paths:
+      - '**/*.swift'
+      - 'Package.swift'
+      - 'Package.resolved'
+      - '.swiftlint.yml'
+      - '.github/workflows/lint-swift.yml'
+
+jobs:
+  swiftlint:
+    name: SwiftLint
+    runs-on: macos-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Install SwiftLint
+      run: brew install swiftlint
+
+    - name: Run SwiftLint
+      run: swiftlint lint --strict

.github/workflows/lint-workflows.yml

@@ -0,0 +1,30 @@
+name: Lint Workflows
+
+on:
+  pull_request:
+    branches:
+      - '*'
+    paths:
+      - '.github/workflows/*.yml'
+      - '.github/actionlint-matcher.json'
+
+jobs:
+  actionlint:
+    name: actionlint
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Download actionlint
+      id: get_actionlint
+      run: bash <(curl https://raw.githubusercontent.com/rhysd/actionlint/main/scripts/download-actionlint.bash)
+      shell: bash
+
+    - name: Register problem matcher
+      run: echo "::add-matcher::.github/actionlint-matcher.json"
+
+    - name: Run actionlint
+      run: ${{ steps.get_actionlint.outputs.executable }} -color
+      shell: bash

.github/workflows/test.yml

@@ -0,0 +1,36 @@
+name: Test
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - '**/*.swift'
+      - 'Package.swift'
+      - 'Package.resolved'
+      - '.github/workflows/test.yml'
+  pull_request:
+    branches:
+      - '*'
+    paths:
+      - '**/*.swift'
+      - 'Package.swift'
+      - 'Package.resolved'
+      - '.github/workflows/test.yml'
+
+jobs:
+  macos:
+    name: macOS
+    runs-on: macos-latest
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Swift version
+      run: swift --version
+
+    - name: Build
+      run: swift build -v
+
+    - name: Run tests
+      run: swift test -v

Package.swift

@@ -27,7 +27,7 @@ let package = Package(
         .target(
             name: "GraphQLAPIKit",
             dependencies: [
-                .product(name: "Apollo", package: "apollo-ios"),
+                .product(name: "Apollo", package: "apollo-ios")
             ]
         ),
         .testTarget(

README.md

@@ -13,7 +13,6 @@ Developed to simplify [Futured](https://www.futured.app) in-house development of
 
 Currently there is no support for some Apollo's features:
 - Apollo built-in cache
-- GraphQL subscriptions
 - Custom interceptors
 
 Network observers are available for logging and analytics.
@@ -128,6 +127,25 @@ let queryResult = try await apiAdapter.fetch(query: query)
 let mutationResult = try await apiAdapter.perform(mutation: mutation)
 ```
 
+### Subscriptions
+```swift
+let subscriptionStream = try await apiAdapter.subscribe(subscription: MySubscription())
+
+for try await data in subscriptionStream {
+    print("Received: \(data)")
+}
+```
+
+### Deferred Responses (@defer)
+```swift
+let deferredStream = try apiAdapter.fetch(query: MyDeferredQuery())
+
+for try await data in deferredStream {
+    // Data arrives progressively as deferred fragments complete
+    print("Received: \(data)")
+}
+```
+
 ## Contributors
 
 - [Ievgen Samoilyk](https://github.com/samoilyk), <ievgen.samoilyk@futured.app>.

Sources/GraphQLAPIKit/Configuration/GraphQLRequestConfiguration.swift

@@ -22,3 +22,19 @@ public struct GraphQLRequestConfiguration: GraphQLOperationConfiguration {
         self.headers = headers
     }
 }
+
+/// Configuration for GraphQL subscriptions.
+///
+/// Use this struct to customize subscription-specific options.
+/// Subscriptions are long-lived connections that may require different configuration than standard requests.
+public struct GraphQLSubscriptionConfiguration: GraphQLOperationConfiguration {
+    /// Additional headers to add to the subscription request.
+    public let headers: RequestHeaders?
+
+    /// Creates a new subscription configuration.
+    ///
+    /// - Parameter headers: Additional headers to add to the request. Defaults to `nil`.
+    public init(headers: RequestHeaders? = nil) {
+        self.headers = headers
+    }
+}