Warp SDK

13 focused Kotlin modules with opt-in imports.

• •Gradle KTS + Version Catalog (libs.versions.toml)
• •Each module publishes independently
• •Module-for-module parity with Weave SDK (iOS)

Clean architecture foundation.

• •BaseViewModel with safeCall, sealed UiState pattern
• •Result extensions and one-shot event channels

Ktor 3 HTTP client.

• •Automatic Spool response envelope unwrapping
• •ErrorCode parity with @spool/http
• •ApiException mapping, interceptors, and retry logic

Material 3 Compose components.

• •Button, Card, Loading, Error states
• •Spacing tokens and typography scales
• •Full dark mode and Dynamic Color support

Multi-layer persistence.

• •InMemoryCache with TTL
• •DataStore preferences, EncryptedSharedPreferences for secrets
• •Thread-safe with Coroutines

Authentication and biometrics.

• •JWT decoder, BiometricPrompt integration
• •Credential Manager for passkeys
• •Mirrors AuthWeave (iOS) API surface

Google Play Billing 7+ subscriptions.

• •Subscriptions and one-time purchases
• •Provider-agnostic API mirroring RevenueWeave (iOS)

Timber-based structured logging.

• •LogCategory for organized log streams
• •Configurable log levels with metadata
• •Production-safe filtering

Provider-agnostic analytics.

• •AnalyticsManager with pluggable providers
• •Swap Firebase/Mixpanel without code changes
• •Event batching and deduplication

Runtime language switching.

• •No app restart required
• •Mirrors LocaleWeave (iOS) API surface
• •Bundle-based string resolution

Feature flags and remote configuration.

• •Caching with local overrides
• •Mirrors RemoteConfigWeave (iOS) API
• •Runtime toggle without redeploy

Compose debug overlay for dev builds.

• •Network inspector with request/response details
• •Log viewer with filtering
• •Performance metrics dashboard

Push and local notification management.

• •FCM push notification handling
• •Local notification scheduling
• •Channel management with categories

Common Kotlin utilities.

• •Date, String, Number formatting extensions
• •Android-specific helpers
• •Shared constants and type aliases

Opt-in primitives that bring Warp to production parity with the iOS counterpart.

• •warp-net -CertificatePin data class + OkHttp-backed pinner. ApiClientConfig.certificatePins is empty by default; supplying pins wires an OkHttpClient.Builder().certificatePinner(...) into Ktor's engine.
• •warp-data -EncryptedPreferencesHelper wraps AndroidX Security EncryptedSharedPreferences (AES256_SIV / AES256_GCM, master key in Android Keystore).
• •warp-log -CrashReporter installs a process-wide Thread.UncaughtExceptionHandler and dispatches captured throwables to every registered CrashSink. Also exposes a CoroutineExceptionHandler factory.
• •warp-arch -StateRestorer + rememberStatePersistor / rememberRestoredState composables hook the host scene's Lifecycle so state is auto-saved on ON_STOP and restored on first composition.
• •warp-util -Flow.throttleFirst(periodMillis) leading-edge dual of debounce, plus Flow.distinctConsecutive(keySelector).

Module fillout pass that brings warp-ui, warp-revenue, and warp-config to a level where you can ship a real Android app without writing the boilerplate yourself.

• •warp-ui -Eight new Compose components close the gap with Weave UIWeave: WarpBadge (5 variants), WarpTextField + WarpPasswordField, WarpDialog, WarpEmptyState, WarpAvatar (Coil 3), WarpDivider, WarpSearchBar, WarpOTPInput.
• •warp-revenue -Production PlayBillingManager on Play Billing 7. BillingManager covers connect / queryProducts / queryPurchases / purchase / acknowledge for Subscription and OneTime products. New EntitlementResolver (pure Kotlin, fully testable) maps purchases into a richer SubscriptionState (Active, InGracePeriod, CancelledStillActive, OnHold, Expired, NotPurchased).
• •warp-config -RemoteConfigProvider interface + InMemoryRemoteConfigProvider, RemoteConfigValue with safe coercion, and DefaultRemoteConfigManager with override -> cache -> defaults resolution order, fetch deduplication, and StateFlow signals.

The remaining three modules are now feature-equivalent to their Weave (iOS) counterparts.

• •warp-auth -AuthCredentials + AuthSession reactive state (Unknown / SignedOut / SignedIn) with bootstrap, signIn, signOut. TokenStore interface + InMemoryTokenStore for tests. AuthProvider abstraction with AuthResult sealed type. GoogleSignInProvider wraps Credential Manager.
• •warp-analytics -Typed event helpers (ButtonClickEvent, ScreenImpressionEvent, PurchaseEvent, CustomEvent). InMemoryAnalyticsProvider captures every signal for assertions and as a default fallback. BatchingAnalyticsProvider decorator buffers events and flushes on capacity or via manual flush().
• •warp-trace -NetworkStore + LogStore bounded ring buffers (StateFlow-backed for Compose). TraceConfiguration toggles + host-fragment ignore list. ShakeDetector accelerometer-based shake-to-show overlay trigger. DeviceInfoSnapshot.capture(context).