iOS SDK overview

widas-sdk-ios is a native Swift Package that adds Wi-DAS Passpoint onboarding to your app. A small WiDAS facade gets a signed client certificate and installs a Passpoint profile. You call four verbs; everything else is internal.

At a glance

Distribution	Swift Package Manager
Minimum OS	iOS 14
Language	Swift (async/await)
Attestation	App Attest
Passpoint install	NEHotspotConfiguration
Telemetry	None
Version	0.1.x

The public surface

import WiDAS

// Configure once — ships no secret; clientId is a public identifier.
let widas = WiDAS(
    clientId: "client-acme",
    keychainAccessGroup: "<TeamID>.com.apple.networkextensionsharing"
)

// Onboard the user. Safe to call every launch.
let result = try await widas.connect(user: "user-42", requestedValidity: "P365D")

// Advisory status — never throws.
let status = await widas.status()   // .none | .valid | .expired | .revoked

// Remove the installed profile.
try await widas.disconnect()

The four verbs

Verb	What it does
init(clientId:keychainAccessGroup:)	Configures the SDK. Ships no secret; clientId is public.
connect(user:requestedValidity:)	Onboards the user. Idempotent — call it every launch.
status()	Advisory certificate status. Never throws.
disconnect()	Removes the installed Passpoint profile.

Next steps

1. Installation — add the package.
2. Setup — App Attest, the Hotspot Configuration entitlement, the Keychain group, and getting registered.
3. Usage — wiring the four verbs into your app.
4. Error handling — the WiDASError cases and what to do about each.