Documentation Index
Fetch the complete documentation index at: https://otpless.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
This document tracks changes in Android Headless Lite SDK releases and their feature parity with the corresponding Android Headless SDK versions.
Lite SDK is a trimmed-down variant of the full Headless SDK, optimized for smaller AAR size, while retaining core stability, security fixes, and phone-auth critical flows.
Scope of Lite SDK
Included
- Core phone-number authentication flows
- SNA (Silent Network Authentication), OTP (WhatsApp/SMS/RCS)
- Security / stability fixes from the corresponding Headless SDK base
Excluded (by design)
- Passkey flows
- Google / Facebook integrations
- Non-essential intent-based models and APIs not required for Lite phone-auth usecase
Version Mapping (Lite → Full SDK)
| Lite SDK Version | Based on Headless SDK | Notes |
|---|
| 0.0.1 | 0.2.7 | Initial Lite fork, removed non-essential auth methods |
| 0.0.2 | 0.2.8 | Bugfix parity |
| 0.0.3 | 0.2.9 | Bugfix parity |
| 0.0.4 | 0.3.4 | Fraud control + SNA improvements |
| 0.0.5 | 0.3.6 | SNA improvements |
| 0.0.6 | 0.3.7 | Internal API contract updates |
| 0.0.7 | — | Airtel + new Vi SNA support, SIM improvements |
| 1.0.1 | — | Major footprint reduction + API simplification |
Note: Versions 0.0.7 and 1.0.1 include changes not strictly tied to a single full SDK version tag (internal contract / refactor + size optimization work).
Release Notes
Changed
- Enabled library minification (
minifyEnabled true) and enhanced Proguard/consumer rules.
- Simplified the public API by removing unnecessary parameters not required for the phone-auth use case.
Simplified OtplessRequest
- Removed
AuthenticationMedium, locale support, and libphonenumber validation.
- Phone validation is now lightweight digit/length based (E.164-ish 8–15 digits).
- Request JSON generation simplified (phone-number-only path).
Refactors / dependency trimming
- Refactored code to reduce footprint and improve SDK size.
- Trimmed dependencies: removed appcompat, chucker, googleid (credential manager), libphonenumber.
- Converted model classes from data class → class and added explicit
@SerializedName mappings.
- Added consumer Proguard rules for Retrofit + Gson reflection safety.
- Added library Proguard rules:
-dontobfuscate to reduce collision risks when consumers merge multiple obfuscated SDKs- Keeps public entrypoints and DTOs stable
- Keeps network model constructors for Gson
Impact
- Major SDK size reduction.
Changed
- Added support for Airtel and the new Vi SNA endpoint.
- Expanded network security config allowlist to include:
in-vil.ipification.comapi-csp.airtel.in
- Improved SIM detail logic to use the data-SIM
TelephonyManager when available.
- Replaced
okhttp3.internal.toImmutableMap with Utility.toImmutableMap.
Based on
android-headless-sdk: 0.3.7
Changed
- Updated internal API contract.
Based on
android-headless-sdk: 0.3.6
Changed
Based on
android-headless-sdk: 0.3.4
Changed
- Fixed immutability-related issues.
- Added enhanced fraud control changes.
- Improved SNA flow.
Based on
android-headless-sdk: 0.2.9
Changed
- Incorporated bug fixes from Headless SDK
0.2.9.
Based on
android-headless-sdk: 0.2.8
Changed
- Incorporated bug fixes from Headless SDK
0.2.8.
Based on
android-headless-sdk: 0.2.7
Changed
- Removed Passkey, Google, and Facebook SDK integrations.
- Removed intent-based data classes.
- Removed APIs related to Passkey / Google / Facebook auth methods.
Impact
- Reduced SDK size by ~200 KB.
- Focused Lite SDK on essential authentication flows only.
Size History (AAR)
| Lite SDK Version | Size (bytes) | Size (MB) |
|---|
| 0.0.1 | 272,807 | 0.2602 |
| 0.0.2 | 272,881 | 0.2602 |
| 0.0.3 | 290,912 | 0.2774 |
| 0.0.4 | 292,621 | 0.2791 |
| 0.0.5 | 290,935 | 0.2775 |
| 0.0.6 | 293,175 | 0.2796 |
| 0.0.7 | 294,387 | 0.2807 |
| 1.0.1 | 171,963 | 0.1640 |
Lite vs Full SDK size comparison
This section compares Lite SDK sizes to the corresponding Full Android Headless SDK version that each Lite release is based on.
Note: Lite 0.0.7 and 1.0.1 are intentionally excluded here because they do not map directly to a single Full SDK version.
| Lite SDK Version | Based on Full SDK | Lite size (bytes) | Full size (bytes) | Saved (bytes) | Saved (%) |
|---|
| 0.0.1 | 0.2.7 | 272,807 | 449,882 | 177,075 | 39.4 |
| 0.0.2 | 0.2.8 | 272,881 | 449,955 | 177,074 | 39.4 |
| 0.0.3 | 0.2.9 | 290,912 | 466,775 | 175,863 | 37.7 |
| 0.0.4 | 0.3.4 | 292,621 | 473,064 | 180,443 | 38.1 |
| 0.0.5 | 0.3.6 | 290,935 | 475,839 | 184,904 | 38.9 |
| 0.0.6 | 0.3.7 | 293,175 | 476,451 | 183,276 | 38.5 |
