PushError

public enum PushError : Error, LocalizedError, Sendable

Errors that can occur during Push operations.

PushError provides comprehensive error handling for all Push-related operations, including credential management, URI parsing, notification processing, and policy enforcement. Each error case includes detailed information to help developers diagnose and resolve issues.

Error Categories

• Initialization: Errors during client initialization
• Credential Management: Errors related to storing, retrieving, and managing credentials
• URI Parsing: Errors that occur when parsing pushauth:// or mfauth:// URIs
• Notification Processing: Errors during push notification handling
• Policy: Errors related to policy enforcement and credential locking
• Network: Errors during communication with the server
• Storage: Errors related to persistent storage operations

Usage Examples

do {
    let credential = try await client.addCredentialFromUri(uri)
    let notification = try await client.processNotification(userInfo)
} catch let error as PushError {
    switch error {
    case .invalidUri(let message):
        print("Invalid URI format: \(message)")
        // Show user-friendly error about QR code format
    case .credentialLocked(let id):
        print("Credential is locked: \(id)")
        // Prompt user for authentication or wait for unlock
    case .networkFailure(let message, _):
        print("Network error: \(message)")
        // Retry or show offline message
    default:
        print("Push error: \(error.localizedDescription)")
    }
}