Build visitor and agent communications inside a native iOS app

# Pilot install from a local Swift package
1. Download ringnity-swift-sdk-0.2.0-beta.0.zip
2. Extract it beside your iOS app workspace
3. Open Xcode
4. File > Add Package Dependencies
5. Add Local... and select the extracted Package.swift
6. Link the RingnitySDK product to your app target

import Foundation
import RingnitySDK

struct RingnityRuntimeTokenResponse: Decodable {
    let token: String
    let expiresIn: Int
    let tokenType: String?
}

let callAdapter = RingnityAppleCallAdapter()

func fetchRingnityToken() async throws -> RingnityRuntimeToken {
    var request = URLRequest(
        url: URL(string: "https://your-backend.example.com/ringnity/runtime-token")!
    )
    request.httpMethod = "POST"
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = try JSONSerialization.data(withJSONObject: [
        "userId": currentUser.id,
        "name": currentUser.name,
        "email": currentUser.email,
        "appVersion": "1.0.0",
        "platform": "ios"
    ])

    let (data, response) = try await URLSession.shared.data(for: request)
    guard let http = response as? HTTPURLResponse, (200..<300).contains(http.statusCode) else {
        throw URLError(.badServerResponse)
    }

    let decoded = try JSONDecoder().decode(RingnityRuntimeTokenResponse.self, from: data)
    return RingnityRuntimeToken(
        token: decoded.token,
        expiresIn: decoded.expiresIn,
        tokenType: decoded.tokenType ?? "Bearer"
    )
}

let ringnity = try await Ringnity.create(
    config: RingnityConfig(
        tokenProvider: fetchRingnityToken,
        callMode: .basic,
        notifications: RingnityNotificationPreferences(
            incomingCall: RingnityRingtoneOptions(
                soundName: "ringnity_default",
                vibrate: true
            )
        ),
        mediaAdapter: callAdapter,
        notificationAdapter: callAdapter
    )
)

import Foundation
import RingnitySDK
import SwiftUI

let callAdapter = RingnityAppleCallAdapter()

func fetchRingnityToken() async throws -> RingnityRuntimeToken {
    let url = URL(string: "https://your-backend.example.com/ringnity/runtime-token")!
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    request.httpBody = try JSONSerialization.data(withJSONObject: [
        "userId": currentUser.id,
        "name": currentUser.name,
        "email": currentUser.email,
        "platform": "ios"
    ])

    let (data, _) = try await URLSession.shared.data(for: request)
    let decoded = try JSONDecoder().decode(RingnityRuntimeTokenResponse.self, from: data)
    return RingnityRuntimeToken(
        token: decoded.token,
        expiresIn: decoded.expiresIn,
        tokenType: decoded.tokenType ?? "Bearer"
    )
}

let config = RingnityConfig(
    tokenProvider: fetchRingnityToken,
    callMode: .basic,
    mediaAdapter: callAdapter,
    notificationAdapter: callAdapter
)

struct ManagedSupportScreen: View {
    var body: some View {
        RingnityView(
            config: config,
            mode: .full,
            conversationSubject: "Mobile customer support"
        )
    }
}

@MainActor
final class HeadlessSupportModel: ObservableObject {
    @Published var messages: [[String: Any]] = []
    private var ringnity: Ringnity?

    func start() async {
        do {
            let sdk = try await Ringnity.create(config: config)
            let conversation = try await sdk.chat.createConversation(
                subject: "Mobile customer support"
            )
            let conversationId = conversation["conversationId"] as! String

            let message = try await sdk.chat.sendMessage(
                conversationId: conversationId,
                body: "Hi, I need help."
            )

            messages.append(message)
            ringnity = sdk
        } catch {
            showError(error)
        }
    }

    func startVideo(conversationId: String) async throws {
        let microphoneGranted = await RingnityAppleCallAdapter.requestMicrophonePermission()
        let cameraGranted = await RingnityAppleCallAdapter.requestCameraPermission()
        guard microphoneGranted && cameraGranted else { return }

        let call = try await ringnity?.calls.startVideo(
            conversationId: conversationId
        )
        try await call?.setVideoEnabled(true)
    }
}

struct HeadlessSupportScreen: View {
    @StateObject private var model = HeadlessSupportModel()

    var body: some View {
        YourCustomSupportView(messages: model.messages)
            .task { await model.start() }
    }
}