✅ Add Swift SDK E2E coverage

Run the Swift client against a real local Vizzly TDD server in an isolated temp workspace. Cover server discovery, PNG upload, new baseline creation, and repeated screenshot matching.

Author: Robdel12

clients/swift/Package.swift

@@ -27,5 +27,8 @@ let package = Package(
         .testTarget(
             name: "VizzlyTests",
             dependencies: ["Vizzly", "VizzlyXCTest"]),
+        .testTarget(
+            name: "VizzlyE2ETests",
+            dependencies: ["Vizzly"]),
     ]
 )

clients/swift/README.md

@@ -458,6 +458,18 @@ Check out the `Example/` directory for:
 - Custom properties and thresholds
 - Direct client usage
 
+## SDK E2E Tests
+
+The Swift SDK has an end-to-end test path that runs against a real local
+Vizzly TDD server and uploads real PNG bytes through `VizzlyClient`:
+
+```bash
+npm run test:swift:e2e
+```
+
+This command builds the CLI, starts an isolated TDD run in a temp directory,
+and executes the `VizzlyE2ETests` SwiftPM suite.
+
 ## Contributing
 
 Bug reports and pull requests are welcome at https://github.com/vizzly-testing/cli

clients/swift/Tests/VizzlyE2ETests/VizzlyE2ETests.swift

@@ -0,0 +1,90 @@
+import XCTest
+import Vizzly
+
+#if os(macOS)
+import AppKit
+#endif
+
+final class VizzlyE2ETests: XCTestCase {
+    override func setUpWithError() throws {
+        try super.setUpWithError()
+
+        guard ProcessInfo.processInfo.environment["VIZZLY_E2E"] == "1" else {
+            throw XCTSkip("Set VIZZLY_E2E=1 to run Swift SDK E2E tests")
+        }
+    }
+
+    func testUploadsScreenshotThroughRunningTddServer() throws {
+        let client = VizzlyClient()
+        XCTAssertTrue(client.isReady, "Expected VizzlyClient to discover the TDD server")
+
+        let firstResult = try XCTUnwrap(
+            client.screenshot(
+                name: "swift-sdk-e2e-home",
+                image: try Self.makeTestPng(),
+                properties: [
+                    "platform": "swift-e2e",
+                    "screen": "home"
+                ],
+                threshold: 1.5,
+                minClusterSize: 3,
+                fullPage: true
+            )
+        )
+
+        XCTAssertTrue(
+            Self.successStatuses.contains(Self.status(from: firstResult)),
+            "Expected first upload to create or match a baseline, got: \(firstResult)"
+        )
+        XCTAssertEqual(firstResult["name"] as? String, "swift-sdk-e2e-home")
+        XCTAssertNotNil(firstResult["current"])
+        XCTAssertNotNil(firstResult["baseline"])
+    }
+
+    func testSecondUploadMatchesExistingBaseline() throws {
+        let client = VizzlyClient()
+
+        let firstResult = try XCTUnwrap(
+            client.screenshot(
+                name: "swift-sdk-e2e-repeatable",
+                image: try Self.makeTestPng(),
+                properties: ["case": "repeatable"]
+            )
+        )
+        XCTAssertTrue(
+            Self.successStatuses.contains(Self.status(from: firstResult)),
+            "Expected first upload to create or match a baseline, got: \(firstResult)"
+        )
+
+        let secondResult = try XCTUnwrap(
+            client.screenshot(
+                name: "swift-sdk-e2e-repeatable",
+                image: try Self.makeTestPng(),
+                properties: ["case": "repeatable"]
+            )
+        )
+        XCTAssertEqual(Self.status(from: secondResult), "match")
+    }
+
+    private static let successStatuses: Set<String> = ["new", "match"]
+
+    private static func status(from result: [String: Any]) -> String {
+        return result["status"] as? String ?? ""
+    }
+
+    private static func makeTestPng() throws -> Data {
+        #if os(macOS)
+        let image = NSImage(size: NSSize(width: 2, height: 2))
+        image.lockFocus()
+        NSColor.systemBlue.setFill()
+        NSRect(x: 0, y: 0, width: 2, height: 2).fill()
+        image.unlockFocus()
+
+        let tiffData = try XCTUnwrap(image.tiffRepresentation)
+        let bitmap = try XCTUnwrap(NSBitmapImageRep(data: tiffData))
+        return try XCTUnwrap(bitmap.representation(using: .png, properties: [:]))
+        #else
+        throw XCTSkip("Swift SDK E2E PNG fixture generation currently runs on macOS")
+        #endif
+    }
+}

clients/swift/scripts/run-e2e.js

@@ -0,0 +1,52 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+let scriptDir = dirname(fileURLToPath(import.meta.url));
+let swiftPackageDir = resolve(scriptDir, '..');
+let repoRoot = resolve(swiftPackageDir, '../..');
+let cliPath = join(repoRoot, 'bin/vizzly.js');
+let distCliPath = join(repoRoot, 'dist/cli.js');
+
+if (!existsSync(distCliPath)) {
+  console.error('Build the CLI first: npm run build');
+  process.exit(1);
+}
+
+let tempDir = mkdtempSync(join(tmpdir(), 'vizzly-swift-e2e-'));
+let swiftTestCommand = [
+  'cd',
+  JSON.stringify(swiftPackageDir),
+  '&&',
+  'swift',
+  'test',
+  '--filter',
+  'VizzlyE2ETests',
+].join(' ');
+
+let child = spawn(
+  process.execPath,
+  [cliPath, 'tdd', 'run', swiftTestCommand, '--no-color'],
+  {
+    cwd: tempDir,
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      VIZZLY_E2E: '1',
+      VIZZLY_HOME: join(tempDir, '.vizzly-home'),
+    },
+  }
+);
+
+child.on('exit', code => {
+  rmSync(tempDir, { recursive: true, force: true });
+  process.exit(code ?? 1);
+});
+
+child.on('error', error => {
+  rmSync(tempDir, { recursive: true, force: true });
+  console.error(error);
+  process.exit(1);
+});

package.json

@@ -71,6 +71,7 @@
     "test:watch": "node --test --test-reporter=spec --watch $(find tests -name '*.test.js')",
     "test:reporter": "playwright test --config=tests/reporter/playwright.config.js",
     "test:reporter:visual": "node bin/vizzly.js run \"npm run test:reporter\"",
+    "test:swift:e2e": "npm run build && node clients/swift/scripts/run-e2e.js",
     "test:tui": "node --test --test-reporter=spec tests/tui/*.test.js",
     "test:tui:docker": "./tests/tui/run-tui-tests.sh",
     "lint": "biome check src tests",