Summary

Removes Apple FairPlay SDK binaries (~2MB) from the repository and implements external dependency management for license compliance and security.

Fixes #27

Changes

Removed from Repository

• ❌ vendor/fpssdk/prebuilt/macos/libfpscrypto.dylib (1.0MB)
• ❌ vendor/fpssdk/prebuilt/x86_64-unknown-linux-gnu/libfpscrypto.so (492KB)
• ❌ vendor/fpssdk/prebuilt/aarch64-unknown-linux-gnu/libfpscrypto.so (524KB)

Total: ~2MB removed (git history cleanup recommended separately)

Smart Library Detection (build.rs)

Implements intelligent library search with priority order:

1. FPSSDK_LIB_PATH environment variable (custom location)
2. prebuilt/ directory (backwards compatibility)
3. System paths (/usr/local/lib, /opt/homebrew/lib, /opt/local/lib)

Provides clear, actionable error messages when library not found.

Documentation Updates

• CLAUDE.md: Brief reference to docs/fairplay.md
• docs/fairplay.md: Complete installation guide with 3 options
• .gitignore: Added vendor/fpssdk/prebuilt/ to prevent future commits

Developer Installation

Developers building with FairPlay must install libfpscrypto separately:

Option A: System-wide (recommended)

# Download SDK from Apple Developer Portal
# Extract to vendor/FairPlay_Streaming_Server_SDK_26/

# macOS
sudo cp vendor/FairPlay_*/Development/lib/macos/libfpscrypto.dylib /usr/local/lib/

# Linux x86_64
sudo cp vendor/FairPlay_*/Development/lib/linux/x86_64/libfpscrypto.so /usr/local/lib/

Option B: Environment variable

export FPSSDK_LIB_PATH=/path/to/fairplay/lib
cargo build --features fairplay

Option C: Temporary build

LIBRARY_PATH=/path/to/fairplay/lib cargo build --features fairplay

Benefits

✅ License Compliance: No redistribution of Apple proprietary binaries
✅ Security: Developers verify binaries directly from Apple
✅ Repository Size: 2MB immediate reduction, more with history cleanup
✅ Flexibility: Multiple installation methods for different workflows
✅ Clear Errors: Helpful messages guide developers to correct setup

Testing Performed

• ✅ Build succeeds with FPSSDK_LIB_PATH set
• ✅ Build succeeds with LIBRARY_PATH set
• ✅ Build succeeds with library in /usr/local/lib
• ✅ Clear error message displayed when library missing
• ✅ Runtime works with DYLD_LIBRARY_PATH
• ✅ Build without --features fairplay still works

CI Notes

Expected CI behavior:

• ❌ FairPlay feature builds will FAIL (library not installed in CI)
• ✅ Default builds (without --features fairplay) will PASS

This is intentional. FairPlay binaries cannot be committed, so CI cannot build FairPlay features unless we:

1. Add SDK download step to CI workflow (requires Apple Developer credentials)
2. Store binaries in GitHub secrets/artifacts (license compliance unclear)
3. Skip FairPlay builds in CI (current approach)

Recommendation: Keep FairPlay builds as optional developer feature, test manually.

Rollback Plan

If issues arise:

git revert 16305fa

Binaries can be temporarily restored from this commit for emergency use.

Next Steps

After merge:

• Consider git history cleanup with BFG Repo-Cleaner
• Update CI workflow if FairPlay testing needed
• Document FairPlay setup in team wiki/onboarding

Note: Builds without --features fairplay are unaffected. FairPlay is an optional feature.