jvlstudio / Swift-SMART

Swift SMART on FHIR framework for iOS and OS X

Swift-SMART is a full client implementation of the 🔥FHIR specification for building apps that interact with healthcare data through SMART on FHIR. Written in Swift 2 it is compatible with iOS 8 and OS X 10.9 and newer and requires Xcode 7 or newer.

Versioning

Due to the complications of combining two volatile technologies, here's an overview of which version numbers use which Swift and FHIR versions. The master branch should always compile and is on (point releases of) these main versions. See the develop branch or specific feature/x branches for new Swift or FHIR versions, and check the tags.

Version	Swift	FHIR
2.2.3	2.2	1.0.2.7202	DSTU 2 (+ technical errata)
2.2	2.0-2.2	1.0.2.7202	DSTU 2 (+ technical errata)
2.1	2.0-2.2	1.0.1.7108	DSTU 2
2.0	2.0-2.2	0.5.0.5149	DSTU 2 Ballot, May 2015
1.0	1.2	0.5.0.5149	DSTU 2 Ballot, May 2015
0.2	1.1	0.5.0.5149	DSTU 2 Ballot, May 2015
0.1	1.0	0.0.81.2382	DSTU 1

Resources

• Programming Guide with code examples
• Technical Documentation of classes, properties and methods
• Medication List sample app
• SMART on FHIR API documentation

QuickStart

See the programming guide for more code examples and details.

The following is the minimal setup working against our reference implementation. It is assuming that you don't have a client_id and on first authentication will register the client with our server, then proceed to retrieve a token. If you know your client-id you can specify it in the settings dict. The app must also register the redirect URL scheme so it can be notified when authentication completes.

import SMART

// create the client
let smart = Client(
    baseURL: "https://fhir-api-dstu2.smarthealthit.org",
    settings: [
        //"client_id": "my_mobile_app",       // if you have one
        "redirect": "smartapp://callback",    // must be registered
    ]
)

// authorize, then search for prescriptions
smart.authorize() { patient, error in
    if nil != error || nil == patient {
        // report error
    }
    else {
        MedicationOrder.search(["patient": patient!.id])
        .perform(smart.server) { bundle, error in
            if nil != error {
                // report error
            }
            else {
                var meds = bundle?.entry?
                    .filter() { return $0.resource is MedicationOrder }
                    .map() { return $0.resource as! MedicationOrder }
                
                // now `meds` holds all the patient's orders (or is nil)
            }
        }
    }
}

Installation

The suggested approach is to add Swift-SMART as a git submodule to your project. Find detailed instructions on how this is done on the Installation page.

The framework is also available via CocoaPods under the name “SMART”.

License

This work is Apache 2 licensed: NOTICE.txt.