feat(horizon): add horizon support with flavor

Author: hyochan

.github/workflows/ci-horizon.yml

@@ -0,0 +1,53 @@
+name: CI Horizon
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-horizon-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  wrapper-validation:
+    name: Validate Gradle Wrapper
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Validate Wrapper
+        uses: gradle/wrapper-validation-action@v2
+
+  horizon-build:
+    name: Build Horizon flavors
+    runs-on: ubuntu-latest
+    needs: wrapper-validation
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Java 17
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: '17'
+
+      - name: Set up Gradle
+        uses: gradle/gradle-build-action@v2
+
+      - name: Set up Android SDK
+        uses: android-actions/setup-android@v3
+
+      - name: Install required SDK packages
+        run: |
+          sdkmanager --install \
+            "platform-tools" \
+            "platforms;android-34" \
+            "build-tools;34.0.0"
+          yes | sdkmanager --licenses
+
+      - name: Build Horizon variants
+        run: ./gradlew --stacktrace --no-daemon :openiap:assembleHorizonDebug :Example:assembleHorizonDebug

.vscode/launch.json

@@ -2,13 +2,24 @@
     "version": "0.2.0",
     "configurations": [
         {
-            "name": "🚀 Android: Run Example (install & start)",
+            "name": "🚀 Android: Run Example (Play)",
             "type": "node",
             "request": "launch",
             "runtimeExecutable": "bash",
             "runtimeArgs": [
                 "-lc",
-                "./gradlew :Example:installDebug && adb shell am start -n dev.hyo.martie/.MainActivity"
+                "./gradlew :Example:installPlayDebug && adb shell am start -n dev.hyo.martie/.MainActivity"
+            ],
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "🚀 Android: Run Example (Horizon)",
+            "type": "node",
+            "request": "launch",
+            "runtimeExecutable": "bash",
+            "runtimeArgs": [
+                "-lc",
+                "./gradlew -PEXAMPLE_OPENIAP_STORE=horizon \"-PEXAMPLE_HORIZON_APP_ID=${input:horizonAppId}\" :Example:installHorizonDebug && adb shell am start -n dev.hyo.martie/.MainActivity"
             ],
             "console": "integratedTerminal"
         },
@@ -24,13 +35,24 @@
             "console": "integratedTerminal"
         },
         {
-            "name": "🧱 Android: Assemble Example (debug)",
+            "name": "🧱 Android: Assemble Example (Play Debug)",
+            "type": "node",
+            "request": "launch",
+            "runtimeExecutable": "bash",
+            "runtimeArgs": [
+                "-lc",
+                "./gradlew :Example:assemblePlayDebug"
+            ],
+            "console": "integratedTerminal"
+        },
+        {
+            "name": "🧱 Android: Assemble Example (Horizon Debug)",
             "type": "node",
             "request": "launch",
             "runtimeExecutable": "bash",
             "runtimeArgs": [
                 "-lc",
-                "./gradlew :Example:assembleDebug"
+                "./gradlew -PEXAMPLE_OPENIAP_STORE=horizon \"-PEXAMPLE_HORIZON_APP_ID=${input:horizonAppId}\" :Example:assembleHorizonDebug"
             ],
             "console": "integratedTerminal"
         },
@@ -67,5 +89,13 @@
             ],
             "console": "integratedTerminal"
         }
+    ],
+    "inputs": [
+        {
+            "id": "horizonAppId",
+            "type": "promptString",
+            "description": "Enter Horizon App ID (Meta) used when building the example",
+            "default": ""
+        }
     ]
 }

.vscode/settings.json

@@ -35,7 +35,6 @@
         "**/node_modules/": true
     },
     "gradle.nestedProjects": true,
-    "gradle.javaDebug": true,
     "typescript.validate.enable": false,
     "javascript.validate.enable": false,
     "typescript.tsc.autoDetect": "off",
@@ -44,6 +43,7 @@
         "billingclient",
         "gson",
         "hyodotdev",
+        "martie",
         "openiap",
         "skus"
     ]

CONTRIBUTING.md

@@ -22,17 +22,32 @@ cd openiap-google
 # Open in Android Studio (recommended)
 ./scripts/open-android-studio.sh
 
-# Or build from CLI
-./gradlew :openiap:assemble
+# Or build from CLI (Play flavor)
+./gradlew :openiap:assemblePlayDebug
 
 # Run unit tests for the library module
 ./gradlew :openiap:test
 
-# (Optional) Install and run the Example app
-./gradlew :Example:installDebug
+# (Optional) Install and run the Example app (Play flavor)
+./gradlew :Example:installPlayDebug
 adb shell am start -n dev.hyo.martie/.MainActivity
 ```
 
+### Horizon flavor testing
+
+The Horizon build uses a dedicated product flavor that bundles Meta's billing compatibility SDK.
+
+```bash
+# Assemble the Horizon flavor of the library
+./gradlew :openiap:assembleHorizonDebug
+
+# Install the sample app (replace APP_ID with your Meta Horizon identifier)
+./gradlew -PEXAMPLE_OPENIAP_STORE=horizon "-PEXAMPLE_HORIZON_APP_ID=APP_ID" :Example:installHorizonDebug
+adb shell am start -n dev.hyo.martie/.MainActivity
+```
+
+With flavors enabled, Gradle no longer creates the generic `installDebug`/`assembleDebug` tasks—run the flavor-specific tasks explicitly in scripts, CI pipelines, and IDE run configurations.
+
 ## Generated Types
 
 - All GraphQL models in `openiap/src/main/java/dev/hyo/openiap/Types.kt` are generated from the [`hyodotdev/openiap-gql`](https://github.com/hyodotdev/openiap-gql) repository. When you update API behavior, adjust the upstream type generator first so the Kotlin output stays in sync across platforms.

Example/build.gradle.kts

@@ -17,6 +17,28 @@ android {
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
         vectorDrawables.useSupportLibrary = true
+        val appId = (project.findProperty("EXAMPLE_HORIZON_APP_ID") as String?)
+            ?: (project.findProperty("EXAMPLE_OPENIAP_APP_ID") as String?)
+            ?: ""
+        buildConfigField("String", "HORIZON_APP_ID", "\"${appId}\"")
+    }
+
+    flavorDimensions += "store"
+
+    productFlavors {
+        val storeOverride = (project.findProperty("EXAMPLE_OPENIAP_STORE") as String?)
+
+        create("play") {
+            dimension = "store"
+            val value = storeOverride ?: "play"
+            buildConfigField("String", "OPENIAP_STORE", "\"${value}\"")
+        }
+
+        create("horizon") {
+            dimension = "store"
+            val value = storeOverride ?: "horizon"
+            buildConfigField("String", "OPENIAP_STORE", "\"${value}\"")
+        }
     }
 
     buildTypes {
@@ -44,6 +66,7 @@ android {
 
     buildFeatures {
         compose = true
+        buildConfig = true
     }
 
     packaging {

Example/src/main/java/dev/hyo/martie/Constants.kt

@@ -1,14 +1,28 @@
 package dev.hyo.martie
 
 object IapConstants {
-    // App-defined SKU lists
-    val INAPP_SKUS = listOf(
+    private fun isHorizon(): Boolean =
+        dev.hyo.martie.BuildConfig.OPENIAP_STORE.equals("horizon", ignoreCase = true)
+
+    private val HORIZON_INAPP = listOf(
         "dev.hyo.martie.10bulbs",
-        "dev.hyo.martie.30bulbs"
+        "dev.hyo.martie.30bulbs",
+    )
+    private val HORIZON_SUBS = listOf(
+        "dev.hyo.martie.premium",
     )
 
-    val SUBS_SKUS = listOf(
-        "dev.hyo.martie.premium"
+    private val PLAY_INAPP = listOf(
+        "dev.hyo.martie.10bulbs",
+        "dev.hyo.martie.30bulbs",
     )
-}
+    private val PLAY_SUBS = listOf(
+        "dev.hyo.martie.premium",
+    )
+
+    val INAPP_SKUS: List<String>
+        get() = if (isHorizon()) HORIZON_INAPP else PLAY_INAPP
 
+    val SUBS_SKUS: List<String>
+        get() = if (isHorizon()) HORIZON_SUBS else PLAY_SUBS
+}

Example/src/main/java/dev/hyo/martie/screens/PurchaseFlowScreen.kt

@@ -46,7 +46,12 @@ fun PurchaseFlowScreen(
     val activity = remember(context) { context.findActivity() }
     val uiScope = rememberCoroutineScope()
     val appContext = remember(context) { context.applicationContext }
-    val iapStore = storeParam ?: remember(appContext) { OpenIapStore(appContext) }
+    val iapStore = storeParam ?: remember(appContext) {
+        val storeKey = dev.hyo.martie.BuildConfig.OPENIAP_STORE
+        val appId = dev.hyo.martie.BuildConfig.HORIZON_APP_ID
+        runCatching { OpenIapStore(appContext, storeKey, appId) }
+            .getOrElse { OpenIapStore(appContext, "auto", appId) }
+    }
     val products by iapStore.products.collectAsState()
     val purchases by iapStore.availablePurchases.collectAsState()
     val androidProducts = remember(products) { products.filterIsInstance<ProductAndroid>() }

Example/src/main/java/dev/hyo/martie/screens/SubscriptionFlowScreen.kt

@@ -59,7 +59,12 @@ fun SubscriptionFlowScreen(
     val activity = remember(context) { context.findActivity() }
     val uiScope = rememberCoroutineScope()
     val appContext = remember(context) { context.applicationContext }
-    val iapStore = storeParam ?: remember(appContext) { OpenIapStore(appContext) }
+    val iapStore = storeParam ?: remember(appContext) {
+        val storeKey = dev.hyo.martie.BuildConfig.OPENIAP_STORE
+        val appId = dev.hyo.martie.BuildConfig.HORIZON_APP_ID
+        runCatching { OpenIapStore(appContext, storeKey, appId) }
+            .getOrElse { OpenIapStore(appContext, "auto", appId) }
+    }
     val products by iapStore.products.collectAsState()
     val purchases by iapStore.availablePurchases.collectAsState()
     val androidProducts = remember(products) { products.filterIsInstance<ProductAndroid>() }

README.md

@@ -29,6 +29,7 @@ OpenIAP GMS is a modern, type-safe Kotlin library that simplifies Google Play in
 - 🔐 **Google Play Billing v8** - Latest billing library with enhanced security
 - ⚡ **Kotlin Coroutines** - Modern async/await API
 - 🎯 **Type Safe** - Full Kotlin type safety with sealed classes
+- 🥽 **Meta Horizon OS Support** - Optional compatibility SDK integration alongside Play Billing
 - 🔄 **Real-time Events** - Purchase update and error listeners
 - 🧵 **Thread Safe** - Concurrent operations with proper synchronization
 - 📱 **Easy Integration** - Simple singleton pattern with context management
@@ -52,6 +53,21 @@ dependencies {
 }
 ```
 
+### Optional provider configuration
+
+Set the target billing provider via `BuildConfig` fields (default is `play`). The library will also auto-detect Horizon hardware when `auto` is supplied.
+
+```kotlin
+android {
+    defaultConfig {
+        buildConfigField("String", "OPENIAP_STORE", "\"auto\"") // play | horizon | auto
+        buildConfigField("String", "HORIZON_APP_ID", "\"YOUR_APP_ID\"")
+    }
+}
+```
+
+The example app reads the same values via `EXAMPLE_OPENIAP_STORE` / `EXAMPLE_HORIZON_APP_ID` Gradle properties for quick testing.
+
 Or `build.gradle`:
 
 ```groovy
@@ -156,6 +172,21 @@ class MainActivity : AppCompatActivity() {
 }
 ```
 
+## 🥽 Testing on Meta Horizon
+
+The library exposes a dedicated `horizon` product flavor that bundles Meta's billing compatibility SDK. Build and install it with:
+
+```bash
+# Compile the Horizon flavor of the library
+./gradlew :openiap:assembleHorizonDebug
+
+# Install the sample app (replace APP_ID with your Horizon app id)
+./gradlew -PEXAMPLE_OPENIAP_STORE=horizon "-PEXAMPLE_HORIZON_APP_ID=APP_ID" :Example:installHorizonDebug
+adb shell am start -n dev.hyo.martie/.MainActivity
+```
+
+For standard Google Play workflows, run the matching `play` tasks (`:openiap:assemblePlayDebug`, `:Example:installPlayDebug`). Flavors remove the generic `installDebug` task, so always target the desired flavor explicitly when using the CLI, CI, or IDE run configurations.
+
 ## 📚 API Reference
 
 ### Core Methods

openiap/build.gradle.kts

@@ -5,6 +5,8 @@ plugins {
     id("com.vanniktech.maven.publish")
 }
 
+import com.vanniktech.maven.publish.AndroidSingleVariantLibrary
+
 // Resolve version from either 'openIapVersion' or 'OPENIAP_VERSION' or fallback
 val openIapVersion: String =
     (project.findProperty("openIapVersion")
@@ -20,6 +22,21 @@ android {
 
         testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
         consumerProguardFiles("consumer-rules.pro")
+        buildConfigField("String", "OPENIAP_STORE", "\"play\"")
+        buildConfigField("String", "HORIZON_APP_ID", "\"\"")
+    }
+
+    flavorDimensions += "store"
+
+    productFlavors {
+        create("play") {
+            dimension = "store"
+            buildConfigField("String", "OPENIAP_STORE", "\"play\"")
+        }
+        create("horizon") {
+            dimension = "store"
+            buildConfigField("String", "OPENIAP_STORE", "\"horizon\"")
+        }
     }
 
     buildTypes {
@@ -44,7 +61,9 @@ android {
     // Enable Compose for composables in this library (IapContext)
     buildFeatures {
         compose = true
+        buildConfig = true
     }
+
 }
 
 dependencies {
@@ -53,6 +72,9 @@ dependencies {
 
     // Google Play Billing Library (align with app/lib v8)
     api("com.android.billingclient:billing-ktx:8.0.0")
+
+    // Meta Horizon Billing compatibility client (only needed on the horizon flavor)
+    add("horizonImplementation", "com.meta.horizon.billingclient.api:horizon-billing-compatibility:1.1.1")
 
     // Kotlin Coroutines
     implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.9.0")
@@ -83,6 +105,7 @@ mavenPublishing {
     // Use the new Central Portal publishing which avoids Nexus staging profile lookups.
     publishToMavenCentral(com.vanniktech.maven.publish.SonatypeHost.CENTRAL_PORTAL)
     signAllPublications()
+    configure(AndroidSingleVariantLibrary(variant = "playRelease", sourcesJar = true, publishJavadocJar = true))
 
     pom {
         name.set("OpenIAP GMS")