// Node
npm i --save '@snapauth/sdk'
// UMD
<script src="https://unpkg.com/@snapauth/sdk"></script>

XCode > File > Add Package Dependencies...

https://github.com/snapauthapp/sdk-swift

// Coming soon!

// npm
import { SDK } from '@snapauth/sdk'
const snapAuth = new SDK('pubkey_xxxx')
// UMD
const snapAuth = new SnapAuth.SDK('pubkey_xxxx')

import SnapAuth

let snapAuth = SnapAuth(publishableKey: "pubkey_xxxx")

// Coming soon!

let name: string // Some value from your app. The user will see this during sign-in.

const registration = await snapAuth.startRegister({ name })
if (registration.ok) {
  const token = registration.data.token
  // Send token to your backend along with other relevant data
} else {
  // If desired, inspect registration.error and decide how to proceed
}

// Tip: this needs to be in an `async` context. You can wrap this entire block
// in Task { ... } if you don't have one.
let result = await snapAuth.startRegister(name: "User's name")
switch result {
case .success(let registration):
  // Send registration.token to your backend
case .failure(let error):
  // If desired, inspect error and decide how to proceed
}

// Coming soon!

{
  "token": string,
  "expiresAt": Timestamp,
}

// Note: use either id or handle, not both.
let id: string|null
let handle: string|null

const auth = await snapAuth.startAuth({ id, handle })
if (auth.ok) {
  const token = auth.data.token
  // Send token to your backend along with other relevant data
} else {
  // If desired, inspect auth.error and decide how to proceed
}

// Tip: this needs to be in an `async` context. You can wrap this entire block
// in Task { ... } if you don't have one.
let result = await snapAuth.startAuth(.handle("Username"))
// Or snapAuth.startAuth(.id(userId))
switch result {
case .success(let auth):
  // Send auth.token to your backend
case .failure(let error):
  // If desired, inspect error and decide how to proceed
}

// Coming soon!

{
  "token": string,
  "expiresAt": Timestamp,
}

import { AuthResponse } from '@snapauth/sdk'

const onAuthenticate = async (auth: AuthResponse) => {
  if (auth.ok) {
    const token = auth.data.token
    // e.g.
    const response = await postToYourBackend('/endpoint', { token })
    // .. Do whatever you need to!
  }
}

snapAuth.handleAutofill(onAuthenticate)

// On the page, you must also have a webauthn input:

<input type="text" autocomplete="username webauthn" />

// CAUTION: we've found the passkey AutoFill experience to be somewhat
// unreliable on supported Apple platforms.  We've filed issues to get this fixed.

// Your UI must be displaying a TextField with `textContentType` of `.username`

import SnapAuth

struct MyView: View {
  let snapAuth = SnapAuth(publishableKey: "pubkey_xxxx")
  var body: some View {
    TextField("Username")
      .textContentType(.username)
      .onAppear {
        #if os(iOS)
        snapAuth.handleAutoFill(delegate: self)
        #endif
      }
  }
}

extension MyView: SnapAuthAutoFillDelegate {
  func snapAuth(didAutoFillWithResult result: SnapAuthResult) {
    guard case .success(let auth) = result else {
      // Typically, autofill errors shouldn't be shown to users.
      return
    }
    // Send auth.token to your backend to finish authenticatoin
  }
}

// Coming soon!

const result = await snapAuth.someAction(...)
// result has an `errors` property, containing 0 or more errors
if (result.ok) {
  // result has a `data` property, which contains the documented response
} else {
  // `errors` is guaranteed to have at least one entry
}

let result = await snapAuth.someAction(...)
switch result {
case .success(let data):
  // data is the documented response format as a platform-native Struct
case .failure(let error):
  // Look at the error code and decide how to proceed
}

// Coming soon!