Adopt openiap-gql typegen on Android (#9)

## Summary
- replace handwritten models with openiap-gql generated Types.kt
- rewire OpenIapModule, store, and sample screens to the new handlers
- fail CI when Types.kt regeneration alters the tree

Author: hyochan

.github/workflows/ci.yml

@@ -49,6 +49,10 @@ jobs:
             "build-tools;34.0.0"
           yes | sdkmanager --licenses
 
+      - name: Verify generated Types.kt is up to date
+        run: |
+          ./scripts/generate-types.sh
+          git diff --exit-code openiap/src/main/java/dev/hyo/openiap/Types.kt
+
       - name: Build library and example
         run: ./gradlew --stacktrace --no-daemon :openiap:build :Example:assembleDebug
-

.vscode/settings.json

@@ -42,6 +42,8 @@
     "npm.autoDetect": "off",
     "cSpell.words": [
         "billingclient",
-        "openiap"
+        "gson",
+        "openiap",
+        "skus"
     ]
 }

AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

CLAUDE.md

@@ -0,0 +1,19 @@
+# Agent Primer
+
+Welcome! This repository hosts the Android implementation of OpenIAP.
+
+## Project Layout
+
+- `openiap/`: Android library sources.
+- `Example/`: sample application consuming the library.
+- `scripts/`: automation (code generation, tooling).
+- `CONVENTION.md`: authoritative engineering conventions for this repo.
+
+## How To Work Here
+
+1. Start every session by reading `CONVENTION.md`. It documents critical rules such as the prohibition on editing generated files (`openiap/src/main/Types.kt`) and where to place shared helper code (`openiap/src/main/java/dev/hyo/openiap/utils/…`).
+2. Treat generated sources as read-only. If a change requires updating them, run `./scripts/generate-types.sh` instead of hand editing.
+3. Put all reusable Kotlin helpers (e.g., safe map accessors) into the `utils` package so they can be used without modifying generated output.
+4. After code generation or dependency changes, compile with `./gradlew :openiap:compileDebugKotlin` (or the appropriate target) to verify the build stays green.
+
+Refer back to this document and `CONVENTION.md` whenever you are unsure about workflow expectations.

CONVENTION.md

@@ -0,0 +1,24 @@
+# Project Conventions
+
+## Generated GraphQL/Kotlin Models
+
+- `openiap/src/main/Types.kt` is auto-generated. Regenerate it with `./scripts/generate-types.sh` after changing any GraphQL schema files.
+- Never edit `Types.kt` manually. Regeneration guarantees consistency across platforms and avoids merge conflicts.
+- When additional parsing or conversion helpers are needed for GraphQL payloads, place them in a utility file (for example `openiap/src/main/java/dev/hyo/openiap/utils/JsonUtils.kt`). Keep all custom helpers outside of generated sources and have the hand-written code call into them.
+
+## Helper Utilities
+
+- Shared helper extensions such as safe `Map<String, *>` lookups must live in utility sources (`utils/*.kt`) so they can be reused without modifying generated files.
+- Utility files should include succinct KDoc explaining their intent and reference the convention above when interacting with generated code.
+
+## Android Module API Handlers
+
+- The Android `OpenIapModule` exposes every GraphQL operation through the typealias handlers defined in `Types.kt` (e.g. `MutationInitConnectionHandler`, `QueryGetAvailablePurchasesHandler`, etc.).
+- These handlers are declared as properties (for example `val initConnection = ...`) inside `OpenIapModule`; they encapsulate all coroutine work (`withContext`, `suspendCancellableCoroutine`, etc.) and return the types required by the GraphQL schema (e.g. `RequestPurchaseResult`).
+- `OpenIapStore` and other consumers must call the module through these handler properties rather than direct suspend functions, unpacking any wrapper results (such as `RequestPurchaseResultPurchases`) as needed.
+- Keep helper wiring inside `OpenIapModule`—avoid reintroducing extension builders like `createQueryHandlers`; the module itself owns `queryHandlers`, `mutationHandlers`, and `subscriptionHandlers` values so wiring stays localized and in sync with the typealiases.
+
+## Regeneration Checklist
+
+- Run `./scripts/generate-types.sh` whenever GraphQL schema definitions change.
+- After regenerating, run the relevant Gradle targets (e.g. `./gradlew :openiap:compileDebugKotlin`) to ensure the generated output compiles together with existing handwritten code.

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

@@ -21,8 +21,9 @@ import androidx.navigation.NavController
 import dev.hyo.martie.models.AppColors
 import dev.hyo.martie.screens.uis.*
 import dev.hyo.openiap.IapContext
+import dev.hyo.openiap.PurchaseAndroid
+import dev.hyo.openiap.PurchaseState
 import dev.hyo.openiap.store.OpenIapStore
-import dev.hyo.openiap.models.*
 import dev.hyo.openiap.store.PurchaseResultStatus
 import kotlinx.coroutines.launch
 
@@ -39,9 +40,11 @@ fun AvailablePurchasesScreen(
     val status by iapStore.status.collectAsState()
     val connectionStatus by iapStore.connectionStatus.collectAsState()
     val statusMessage = status.lastPurchaseResult
-    
+
+    val androidPurchases = remember(purchases) { purchases.filterIsInstance<PurchaseAndroid>() }
+
     // Modal state
-    var selectedPurchase by remember { mutableStateOf<OpenIapPurchase?>(null) }
+    var selectedPurchase by remember { mutableStateOf<PurchaseAndroid?>(null) }
 
     // Initialize and connect on first composition (spec-aligned names)
     val startupScope = rememberCoroutineScope()
@@ -174,26 +177,26 @@ fun AvailablePurchasesScreen(
             }
 
             // Group purchases by type
-            val consumables = purchases.filter { 
+            val consumables = androidPurchases.filter { 
                 !it.isAutoRenewing && (
                     it.productId.contains("consumable", ignoreCase = true) ||
                     it.productId.contains("bulb", ignoreCase = true)
                 )
             }
-            val nonConsumables = purchases.filter { 
+            val nonConsumables = androidPurchases.filter { 
                 !it.isAutoRenewing && 
                 it.productId != "dev.hyo.martie.premium" &&
                 !(
                     it.productId.contains("consumable", ignoreCase = true) ||
                     it.productId.contains("bulb", ignoreCase = true)
                 )
             }
-            val subscriptions = purchases.filter { 
+            val subscriptions = androidPurchases.filter { 
                 it.isAutoRenewing || it.productId == "dev.hyo.martie.premium"
             }
 
             // Check for unfinished transactions (purchases that need acknowledgment/consumption)
-            val unfinishedPurchases = purchases.filter { purchase ->
+            val unfinishedPurchases = androidPurchases.filter { purchase ->
                 // TODO: In real implementation, check if purchase needs acknowledgment/consumption
                 // This would typically check: purchase.purchaseState == PurchaseState.Purchased && !purchase.isAcknowledged
                 // For demo purposes, let's assume some consumable purchases might need finishing
@@ -326,7 +329,7 @@ fun AvailablePurchasesScreen(
             }
 
             // Empty State
-            if (purchases.isEmpty() && !status.isLoading) {
+            if (androidPurchases.isEmpty() && !status.isLoading) {
                 item {
                     EmptyStateCard(
                         message = "No purchases found. Try restoring purchases from your Google account.",
@@ -336,7 +339,7 @@ fun AvailablePurchasesScreen(
             }
 
             // Statistics Card
-            if (purchases.isNotEmpty()) {
+            if (androidPurchases.isNotEmpty()) {
                 item {
                     Card(
                         modifier = Modifier
@@ -362,7 +365,7 @@ fun AvailablePurchasesScreen(
                                 horizontalArrangement = Arrangement.SpaceAround
                             ) {
                                 StatisticItem(
-                                    count = purchases.size,
+                                    count = androidPurchases.size,
                                     label = "Total",
                                     color = AppColors.primary
                                 )
@@ -451,7 +454,7 @@ enum class PurchaseType {
 
 @Composable
 fun PurchaseItemCard(
-    purchase: OpenIapPurchase,
+    purchase: PurchaseAndroid,
     type: PurchaseType,
     onClick: () -> Unit
 ) {
@@ -509,7 +512,7 @@ fun PurchaseItemCard(
                     )
 
                     Text(
-                        "Purchased: ${java.text.SimpleDateFormat("MMM dd, yyyy", java.util.Locale.getDefault()).format(java.util.Date(purchase.transactionDate))}",
+                        "Purchased: ${java.text.SimpleDateFormat("MMM dd, yyyy", java.util.Locale.getDefault()).format(java.util.Date(purchase.transactionDate.toLong()))}",
                         style = MaterialTheme.typography.bodySmall,
                         color = AppColors.textSecondary
                     )
@@ -567,7 +570,7 @@ fun StatisticItem(
 
 @Composable
 fun UnfinishedTransactionCard(
-    purchase: OpenIapPurchase,
+    purchase: PurchaseAndroid,
     onFinish: (Boolean) -> Unit,
     onClick: () -> Unit
 ) {
@@ -617,7 +620,7 @@ fun UnfinishedTransactionCard(
                     )
 
                     Text(
-                        "Date: ${java.text.SimpleDateFormat("MMM dd, yyyy", java.util.Locale.getDefault()).format(java.util.Date(purchase.transactionDate))}",
+                        "Date: ${java.text.SimpleDateFormat("MMM dd, yyyy", java.util.Locale.getDefault()).format(java.util.Date(purchase.transactionDate.toLong()))}",
                         style = MaterialTheme.typography.bodySmall,
                         color = AppColors.textSecondary
                     )