Android SDK

dependencies {
    implementation("com.agentwallie:sdk:0.1.0")
}

import com.agentwallie.sdk.AgentWallie
import com.agentwallie.sdk.AgentWallieOptions
 
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        AgentWallie.configure(this, apiKey = "pk_your_public_key")
    }
}

val options = AgentWallieOptions(
    baseUrl = "https://agentwallie.com/api",
    loggingEnabled = true,
    automaticPurchaseHandling = true,
    configRefreshIntervalMs = 300_000L  // 5 minutes
)
 
AgentWallie.configure(this, apiKey = "pk_your_public_key", options = options)

AgentWallie.identify("user_123")

AgentWallie.setUserAttributes(mapOf(
    "plan" to "free",
    "onboarding_complete" to true,
    "session_count" to 5,
    "age" to 28
))

AgentWallie.reset()

AgentWallie.register(placement = "feature_gate") {
    // Handler runs if user has entitlement (no paywall needed)
    showProFeature()
}

AgentWallie.presentPaywall(id = "pw_abc123")

val schema = AgentWallie.getPaywall(forPlacement = "upgrade")
if (schema != null) {
    // Use schema for custom rendering
}

// Set subscription status
AgentWallie.subscriptionStatus = SubscriptionStatus.ACTIVE
 
// Set entitlements
AgentWallie.entitlements = setOf("pro", "premium_content")

import com.agentwallie.sdk.purchasing.PurchaseController
 
class MyPurchaseController : PurchaseController {
    override suspend fun purchase(productId: String): PurchaseResult {
        // Custom purchase logic
        return PurchaseResult.Purchased
    }
 
    override suspend fun restorePurchases(): RestoreResult {
        return RestoreResult.Restored
    }
}
 
// Set before any paywall presentation
AgentWallie.setPurchaseController(MyPurchaseController())

AgentWallie.trackEvent(
    name = "workout_completed",
    properties = mapOf(
        "duration" to 45,
        "type" to "strength"
    )
)

import com.agentwallie.sdk.AgentWallieDelegate
 
class MyDelegate : AgentWallieDelegate {
    override fun onPaywallWillPresent(paywallId: String) {
        Log.d("AgentWallie", "Will present: $paywallId")
    }
 
    override fun onPaywallDidPresent(paywallId: String) {
        Log.d("AgentWallie", "Did present: $paywallId")
    }
 
    override fun onPaywallDidDismiss(paywallId: String) {
        Log.d("AgentWallie", "Dismissed: $paywallId")
    }
 
    override fun onPurchaseCompleted(productId: String) {
        AgentWallie.subscriptionStatus = SubscriptionStatus.ACTIVE
    }
 
    override fun onCustomAction(name: String) {
        when (name) {
            "show_onboarding" -> showOnboarding()
        }
    }
}
 
// Set delegate
AgentWallie.delegate = MyDelegate()

// In your Activity
override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    intent.data?.let { uri ->
        AgentWallie.handleDeepLink(uri)
    }
}

{
  "theme": {
    "font_families": {
      "display": "Playfair Display",
      "heading": "Inter",
      "body": "Inter",
      "mono": "JetBrains Mono"
    }
  }
}

{
  "type": "text",
  "id": "promo_title",
  "props": { "content": "Limited Offer", "text_style": "title1" },
  "style": { "font_family": "Lobster" }
}

app/src/main/res/font/
├── playfair_display.ttf
├── inter.ttf
└── jetbrains_mono.ttf

{
  "type": "text",
  "props": { "content": "Only {{ products.selected.price }}/year" }
}

{
  "type": "text",
  "props": { "content": "Welcome back, {{ user.name }}!" }
}

{
  "style": { "color": "{{ theme.accent }}" }
}

{
  "type": "text",
  "props": { "content": "Get **unlimited** access to **all** features" }
}

{
  "settings": {
    "background_gradient": {
      "colors": ["#1A1A2E", "#16213E", "#0F3460"],
      "start": "top",
      "end": "bottom"
    }
  }
}

{
  "type": "cta_button",
  "id": "cta",
  "props": { "text": "Subscribe Now", "action": "purchase" },
  "style": {
    "background_color": "#7C3AED",
    "glow_color": "#7C3AED"
  }
}

{
  "type": "text",
  "props": { "content": "PREMIUM", "text_style": "headline" },
  "style": { "letter_spacing": 2.5 }
}

{
  "settings": {
    "close_button": true,
    "close_button_style": "text"
  }
}

{
  "type": "product_picker",
  "id": "products",
  "props": {
    "layout": "cards",
    "show_savings_badge": true,
    "savings_badge_text": "Save {{ products.primary.savings_percent }}%"
  },
  "style": {
    "selected_border_color": "{{ theme.primary }}",
    "corner_radius": 16,
    "padding": 16
  }
}

{
  "type": "feature_list",
  "id": "features",
  "props": {
    "items": [
      {
        "icon": "star.fill",
        "text": "Priority support",
        "background": "#F0F9FF",
        "corner_radius": 12,
        "padding": 16,
        "border_color": "#3B82F6"
      },
      {
        "icon": "bolt.fill",
        "text": "Unlimited exports",
        "background": "#FFF7ED",
        "corner_radius": 12,
        "padding": 16,
        "border_color": "#F97316"
      }
    ]
  }
}

AgentWallie.showDebugger()

<activity
    android:name="com.agentwallie.sdk.debug.DebugActivity"
    android:theme="@style/Theme.Material3.DayNight"
    android:exported="false" />

agentwallie://debug

override fun onNewIntent(intent: Intent) {
    super.onNewIntent(intent)
    intent.data?.let { uri ->
        if (uri.toString() == "agentwallie://debug") {
            AgentWallie.showDebugger()
        } else {
            AgentWallie.handleDeepLink(uri)
        }
    }
}

import android.app.Application
import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.compose.material3.*
import com.agentwallie.sdk.*
 
class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        AgentWallie.configure(
            context = this,
            apiKey = "pk_live_abc123",
            options = AgentWallieOptions(loggingEnabled = true)
        )
        AgentWallie.delegate = object : AgentWallieDelegate {
            override fun onPurchaseCompleted(productId: String) {
                AgentWallie.subscriptionStatus = SubscriptionStatus.ACTIVE
                AgentWallie.entitlements = setOf("pro")
            }
        }
    }
}
 
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
 
        AgentWallie.identify("user_456")
        AgentWallie.setUserAttributes(mapOf(
            "plan" to "free",
            "workouts_completed" to 12
        ))
 
        setContent {
            Button(onClick = {
                AgentWallie.register(placement = "advanced_workout") {
                    // User has pro -- let them through
                    startAdvancedWorkout()
                }
            }) {
                Text("Start Advanced Workout")
            }
        }
    }
 
    private fun startAdvancedWorkout() {
        // Navigate to workout
    }
}