stack/sdks/implementations/swift/Examples/StackAuthMacOS

Hexclave macOS Example

A comprehensive macOS SwiftUI application for testing all Hexclave SDK functions interactively.

Prerequisites

• macOS 14.0+
• Swift 5.9+
• A running Hexclave backend (default: http://localhost:8102)

Running the Example

1. Start the Hexclave backend:

   cd /path/to/stack-2
   pnpm run dev
   

2. Open and run the example:

   cd Examples/StackAuthMacOS
   swift run
   

   Or open in Xcode:

   open Package.swift
   

Features

The example app provides a sidebar navigation with the following sections:

Configuration

• Settings: Configure API base URL, project ID, and API keys
• Logs: View real-time logs of all SDK operations

Client App Testing

• Authentication

  • Sign up with email/password
  • Sign in with credentials
  • Sign in with wrong password (error testing)
  • Sign out
  • Get current user
  • Get user (or throw)

• User Management

  • Set display name
  • Update client metadata
  • Update password
  • Get access/refresh tokens
  • Get auth headers
  • Get partial user from token

• Teams

  • Create team
  • List user's teams
  • Get team by ID
  • List team members

• Contact Channels

  • List contact channels

• OAuth

  • Generate OAuth URLs for Google, GitHub, Microsoft
  • Test PKCE code generation

• Tokens

  • Get access token (JWT format)
  • Get refresh token
  • Get auth headers
  • Test different token stores

Server App Testing

• Server Users

  • Create user (basic and with all options)
  • List users with pagination
  • Get user by ID
  • Delete user

• Server Teams

  • Create team
  • List all teams
  • Add/remove users from teams
  • List team users
  • Delete team

• Sessions

  • Create session (impersonation)
  • Use session tokens with client app

Default Configuration

The example is pre-configured for local development:

• Base URL: http://localhost:8102
• Project ID: internal
• Publishable Key: this-publishable-client-key-is-for-local-development-only
• Secret Key: this-secret-server-key-is-for-local-development-only

SDK Functions Covered

Category	Functions
Auth	signUpWithCredential, signInWithCredential, signOut, getUser, getOAuthUrl
User	setDisplayName, update (metadata), updatePassword, getAccessToken, getRefreshToken, getAuthHeaders, getPartialUser
Teams	createTeam, listTeams, getTeam, listUsers (team members)
Contact	listContactChannels
Server Users	createUser, listUsers, getUser, delete, update (metadata, password)
Server Teams	createTeam, listTeams, getTeam, addUser, removeUser, listUsers, delete
Sessions	createSession
Errors	EmailPasswordMismatchError, UserNotSignedInError, PasswordConfirmationMismatchError