SmartThings Edge Crypto: Complete Fork Rebranding & Modernization

[blueyetisoftware]

🚀 SmartThings Edge Crypto: Complete Fork Rebranding & Modernization

This PR finalizes the fork of lua-lockbox as smartthings-edge-crypto, a dedicated cryptographic library optimized for SmartThings Edge drivers.

🔄 Major Changes

Rebranding & Package Identity

• Package renamed: lua-lockbox → smartthings-edge-crypto
• Module namespace: lockbox.* → crypto.*
• Entry point: lockbox.lua → crypto.lua
• Directory structure: lockbox/ → crypto/
• Rockspec files: Updated package names and module mappings

Performance Optimizations

• Native bitwise operations: Replaced external bit libraries with Lua 5.3+ native operators (&, |, ~, <<, >>)
• Zero external dependencies: Eliminated bit/bit32/numberlua fallbacks
• Lua 5.3+ requirement: Minimum version raised for native operator support
• Performance gains documented: Added benchmark results showing significant speed improvements

Testing Framework Modernization

• Test framework: Converted from custom test runner to busted
• Test organization: Moved tests from test/ to spec/ with proper BDD structure
• Test coverage: Added comprehensive test suites for all crypto algorithms
• CI integration: Tests run via GitHub Actions with proper error reporting

CI/CD Pipeline Overhaul

• GitHub Actions: Complete migration from Travis CI
• Workflows added:
  • test.yml: Automated testing on PR/push
  • benchmark.yml: Performance regression testing
  • luacheck.yml: Code quality linting
• Benchmark automation: Performance data collection and storage in gh-pages branch

Code Quality & Organization

• Benchmark script: Moved RunPerf.lua to dedicated benchmark/ directory
• Documentation: Added benchmark README and performance analysis docs
• Legacy cleanup: Removed Travis CI config, bootstrap scripts, and deprecated utilities
• Linting: Added LuaCheck configuration and CI enforcement

📊 Performance Impact

The native bitwise operations provide substantial performance improvements:

• SHA operations: ~2-3x faster
• AES encryption: ~1.5-2x faster
• HMAC: ~2x faster
• Memory usage: Reduced due to eliminated external library dependencies

🧪 Testing

• 72 test cases pass across all crypto algorithms
• Full compatibility maintained with upstream lua-lockbox API
• Edge case coverage improved with native operation testing

🎯 Target Use Cases

Optimized for SmartThings Edge driver development:

• JWT token validation
• OAuth flow cryptography
• Zigbee/Z-Wave secure communications
• Tuya/Broadlink protocol crypto
• Generic HMAC-SHA256/AES operations

🔗 Related

• Upstream: somesocks/lua-lockbox
• Issues: Seeking maintainers for general-purpose lua-lockbox
• Focus: This fork prioritizes Edge runtime performance and reliability

---

Breaking Changes: Module namespace changed from lockbox.* to crypto.*. Update all require() statements accordingly.