JWTDecode.swift

Added

• feat: added support for visionOS platform #231 (desusai7)

Changed

• Dropped support for Xcode 14, Swift versions [5,7, 5.8]
• Dropped support for iOS 13 & tvOS 13.

Removed

• Drop support for iOS 12, tvOS 12, macOS 10.15, watch0S < 7, and Xcode 13 #199 (Widcket)

Fixed

• Fix conversion of boolean claim values #193 (Widcket)

💡 Check the Migration Guide to understand the changes required to migrate your application to v3.

⚠️ BREAKING CHANGES

• Rename DecodeError and error case #162 (Widcket)
• Drop support for Objective-C [SDK-3405] #149 (Widcket)
• Remove ID token validator [SDK-3395] #145 (Widcket)
• Drop support for old platform versions [SDK-3386] #143 (Widcket)
• Drop support for old Swift versions [SDK-3394] #142 (Widcket)

Added

• Add subscript getter for claims [SDK-3421] #156 (Widcket)

Changed

• Apply recommended Xcode 14 settings #159 (Widcket)
• Improve display of DecodeError [SDK-3427] #158 (Widcket)

💡 Check the Migration Guide to understand the changes required to migrate your application to v3.

⚠️ BREAKING CHANGES

• Rename DecodeError and error case #162 (Widcket)
• Drop support for Objective-C [SDK-3405] #149 (Widcket)
• Remove ID token validator [SDK-3395] #145 (Widcket)
• Drop support for old platform versions [SDK-3386] #143 (Widcket)
• Drop support for old Swift versions [SDK-3394] #142 (Widcket)

Added

• Add subscript getter for claims [SDK-3421] #156 (Widcket)

Changed

• Apply recommended Xcode 14 settings #159 (Widcket)
• Improve display of DecodeError [SDK-3427] #158 (Widcket)

Changed

• Updated dependencies #132 (Widcket)

Fixed

• Add supported Plattforms to Package.swift #131 (obrhoff)

Security

• Update Addressable to v2.8.0 #127 (Widcket)

Changed

• Make test dependencies not resolve when installing with SPM [SDK-2599] #125 (Widcket)

• Added support for boolean claims #121 (kaishin)

⚠️ This release adds support for Xcode 12 and drops support for Xcode < 11.4

Changed

• Updated Quick and Nimble #421 (Widcket)

Changed

• Lowered tvOS deployment target to 9.0 #100 (Widcket)
• Added SPM instructions to the README #99 (Widcket)

Added

• Added Swift Package Manager Support [SDK-1181] #97 (Widcket)
• Added watchOS support #91 (jklp)

Added

• Multiple Swift version support in CocoaPods #94 (ericbuehl)

Added

• Added Swift 5 / Xcode 10.2 support #88 (cocojoe)

Added

• Added latest release management #80 (cocojoe)
• Added ID Token Claims Validation #78 (cocojoe)
• Added Multi Swift Version CI #74 (cocojoe)
• Added rawValue accessor for Claims #69 (cocojoe)

Changed

• Update Xcode 9.3, Added CI 2.0 #66 (cocojoe)

Added

• Added @objc attributes #54 (narlei)

Added

• Added Xcode 9 / Swift 3.2 Support #50 (cocojoe)

Full Changelog

Support for Xcode 8 & Swift 3.

Following Swift API Guidelines, all functions and methods requires a parameter label.

So now to decode a token

try JWTDecode.decode(jwt: "token")

Also now JWTDecode errors conforms the protocol LocalizableError

public enum DecodeError: LocalizedError {
    case invalidBase64Url(String)
    case invalidJSON(String)
    case invalidPartCount(String, Int)

    public var localizedDescription: String {
        switch self {
        case .invalidJSON(let value):
            return NSLocalizedString("Malformed jwt token, failed to parse JSON value from base64Url \(value)", comment: "Invalid JSON value inside base64Url")
        case .invalidPartCount(let jwt, let parts):
            return NSLocalizedString("Malformed jwt token \(jwt) has \(parts) parts when it should have 3 parts", comment: "Invalid amount of jwt parts")
        case .invalidBase64Url(let value):
            return NSLocalizedString("Malformed jwt token, failed to decode base64Url value \(value)", comment: "Invalid JWT token base64Url value")
        }
    }
}

Full Changelog

Support for Xcode 8 & Swift 2.3.

Full Changelog

Changed:

• Rework how claims are decoded #35 (hzalaz)
• Add expired method to A0JWT #25 (wkoszek)
• Require only App Extension Safe API (in iOS) #20 (hzalaz)

Added:

• Swift 2.3 #34 (hzalaz)
• Return JWT string representation #19 (hzalaz)
• Add tvOS Support #33 (adolfo)

Deprecated:

To provide a better experience while dealing with claims and converting their values to Swift types, we deprecated the following method to retrive JWT claims

public func claim<T>(name: String) -> T?

In favor of the following method to retrieve the claim

let claim = jwt.claim(name: "claim_name")

and then you can try converting it's value to the proper type like

if let email = claim.string {
    print("JWT had email \(email)")
}

The supported conversions are:

var string: String?
var integer: Int?
var double: Double?
var date: NSDate?
var array: [String]?