fix(auth): replace trait with runtime configuration flag

[grdsdev]

Summary

Replaces the EmitLocalSessionAsInitialSession trait with a runtime configuration flag to resolve compatibility issues with Xcode projects and align with Apple's trait guidelines.

Problem

The current trait-based approach has several issues:

1. Xcode incompatibility: iOS projects cannot enable traits (no Package.swift, no UI/CLI support)
2. Violates Apple's guidelines: Traits should be strictly additive and not alter API behavior
3. Limited discoverability: Users in Xcode won't know this option exists

Solution

Implemented a runtime configuration flag emitLocalSessionAsInitialSession: Bool in AuthClient.Configuration:

• Defaults to false for backward compatibility
• Can be set at initialization without recompilation
• Works in all project types (Xcode, SPM)
• Discoverable through autocomplete and documentation

Changes

• ✅ Added emitLocalSessionAsInitialSession: Bool property to AuthClient.Configuration
• ✅ Replaced conditional compilation (#if EmitLocalSessionAsInitialSession) with runtime checks
• ✅ Updated deprecation warning to reference the new configuration option
• ✅ Added separate tests for both behaviors (old and new)
• ✅ Removed EmitLocalSessionAsInitialSession trait from Package@swift-6.1.swift
• ✅ All 78 AuthClientTests passing

Migration

Users who want the new behavior can now set:

let client = AuthClient(
  url: url,
  headers: headers,
  localStorage: storage,
  emitLocalSessionAsInitialSession: true  // Opt-in to new behavior
)

Or using configuration:

let config = AuthClient.Configuration(
  url: url,
  // ... other parameters
  emitLocalSessionAsInitialSession: true
)
let client = AuthClient(configuration: config)

Test Plan

• Build succeeds (swift build)
• All AuthClientTests pass (78/78)
• Tests cover both old behavior (default) and new behavior (with flag enabled)
• No breaking changes for existing users

Breaking Changes

None. The default behavior remains unchanged (false). This will change to true in the next major release (v3.0.0).

🤖 Generated with Claude Code

[Copilot]

Pull Request Overview

This PR replaces the Swift 6.1 experimental package trait EmitLocalSessionAsInitialSession with a runtime configuration option emitLocalSessionAsInitialSession. This change provides a more accessible way for users to opt into the new behavior where the locally stored session is emitted immediately as the initial session, rather than waiting for a refresh attempt first.

Key changes:

• Removed the Package@swift-6.1.swift file that used the experimental trait feature
• Added emitLocalSessionAsInitialSession configuration parameter throughout the Auth client initialization chain
• Replaced compile-time #if EmitLocalSessionAsInitialSession conditionals with runtime if configuration.emitLocalSessionAsInitialSession checks
• Updated tests to use the new runtime configuration instead of conditional compilation

Reviewed Changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
Package@swift-6.1.swift	Removed file that defined the experimental package trait
Sources/Auth/AuthClient.swift	Replaced conditional compilation directives with runtime checks based on the new configuration property
Sources/Auth/AuthClientConfiguration.swift	Added emitLocalSessionAsInitialSession configuration property with documentation
Sources/Supabase/Types.swift	Added emitLocalSessionAsInitialSession to auth options with default value for backward compatibility
Sources/Supabase/SupabaseClient.swift	Threaded through the new configuration parameter to AuthClient initialization
Tests/AuthTests/AuthClientTests.swift	Replaced conditional test expectations with separate test variants for both behavior modes

[vojtabohm]

Amazing! Thank you for looking into it so SWIFTly :)

[vojtabohm]

Seems to be working as intended. Going to production with it. Thanks!