Align OpenIAP GQL unions (#210)

Align OpenIAP literal unions across generated types and runtime helpers
to match the updated schema. Refresh docs, examples, and tests so
consumers see the lowercase literals while preserving native
compatibility.

Complies with
https://github.com/hyodotdev/openiap-gql/releases/tag/1.0.1

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

- **New Features**
- Public APIs now normalize purchase types to "in-app"
(backward-compatible with "inapp"), standardize platform values to
"ios"/"android", and introduce updated purchase/subscription request
typing and an auto-sync option.

- **Documentation**
- Guides, migration notes, examples, and API docs updated to use
"in-app" and the new string-union terminology for product types,
platforms, events, and states.

- **Tests**
- Unit and example tests updated to reflect "in-app" and standardized
platform/purchase string values.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

Author: hyochan

.eslintrc.js

@@ -1,6 +1,7 @@
 module.exports = {
   root: true,
   extends: ['expo', 'prettier'],
+  ignorePatterns: ['src/types.ts'],
   plugins: ['prettier'],
   rules: {
     'eslint-comments/no-unlimited-disable': 0,

CLAUDE.md

@@ -62,7 +62,7 @@ For complete type definitions and documentation, see: <https://www.openiap.dev/d
 
 The library follows the OpenIAP type specifications with platform-specific extensions using iOS/Android suffixes.
 
-> **Note:** `src/types.ts` is generated from the OpenIAP schema. Do **not** edit this file manually—run `npm run generate` after updating any `*.graphql` schema instead.
+> **Important:** `src/types.ts` is generated from the OpenIAP schema. Never edit this file manually or commit hand-written changes. After updating any `*.graphql` schema, run `bun run generate:types` (or the equivalent script in your package manager) to refresh the file.
 
 ### React/JSX Conventions
 

docs/CONVENTIONS.md

@@ -81,7 +81,7 @@ export interface Platform {
 // ✅ Good - Clear parameter and return types
 export const requestProducts = async (params: {
   skus: string[];
-  type?: 'inapp' | 'subs';
+  type?: 'in-app' | 'subs';
 }): Promise<Product[]> => {
   // implementation
 };
@@ -141,7 +141,7 @@ export const deepLinkToSubscriptionsAndroid = async ({
 // These functions handle platform differences internally
 export const requestProducts = async (params: {
   skus: string[];
-  type?: 'inapp' | 'subs';
+  type?: 'in-app' | 'subs';
 }): Promise<Product[]> => {
   return (
     Platform.select({
@@ -274,7 +274,7 @@ Always use async/await over promises:
 // ✅ Good
 export const requestProducts = async (params: {
   skus: string[];
-  type?: 'inapp' | 'subs';
+  type?: 'in-app' | 'subs';
 }): Promise<Product[]> => {
   try {
     const products = await ExpoIapModule.requestProducts(params);
@@ -312,14 +312,14 @@ All public APIs must have JSDoc comments:
  *
  * @example
  * ```typescript
- * const products = await requestProducts({ skus: ['com.example.premium'], type: 'inapp' });
+ * const products = await requestProducts({ skus: ['com.example.premium'], type: 'in-app' });
  * ```
  *
  * @platform iOS
  */
 export const requestProductsIOS = async (params: {
   skus: string[];
-  type?: 'inapp' | 'subs';
+  type?: 'in-app' | 'subs';
 }): Promise<ProductIOS[]> => {
   // implementation
 };
@@ -358,7 +358,7 @@ describe('PurchaseManager', () => {
     it('should get products on iOS', async () => {
       const products = await requestProductsIOS({
         skus: ['com.example.product'],
-        type: 'inapp',
+        type: 'in-app',
       });
       expect(products).toHaveLength(1);
     });
@@ -371,7 +371,7 @@ describe('PurchaseManager', () => {
 
     it('should throw error on Android', async () => {
       await expect(
-        requestProductsIOS({skus: ['com.example.product'], type: 'inapp'}),
+        requestProductsIOS({skus: ['com.example.product'], type: 'in-app'}),
       ).rejects.toThrow('This method is only available on iOS');
     });
   });
@@ -487,7 +487,7 @@ await requestPurchase({
       obfuscatedAccountIdAndroid: 'user-123',
     },
   },
-  type: 'inapp',
+  type: 'in-app',
 });
 
 // ❌ Bad - Old API with Platform.OS checks

docs/blog/2025-08-18-v2.8.0-migration-guide.md

@@ -161,7 +161,7 @@ const purchase = await requestPurchase({
     ios: {sku: 'product-id'},
     android: {skus: ['product-id']},
   },
-  type: 'inapp',
+  type: 'in-app',
 });
 if (purchase.expirationDateIOS) {
   console.log('Expires:', purchase.expirationDateIOS);

docs/blog/2025-09-03-v2.8.7.md

@@ -23,18 +23,18 @@ import AdFitTopFixed from "@site/src/uis/AdFitTopFixed";
 
 ```typescript
 // Old (deprecated)
-const products = await requestProducts({skus: ['product1'], type: 'inapp'});
+const products = await requestProducts({skus: ['product1'], type: 'in-app'});
 
 // New (recommended)
-const products = await fetchProducts({skus: ['product1'], type: 'inapp'});
+const products = await fetchProducts({skus: ['product1'], type: 'in-app'});
 ```
 
 ### useIAP Hook
 
 ```typescript
 const {fetchProducts, requestProducts} = useIAP(); // requestProducts still works but deprecated
 
-await fetchProducts({skus: ['product1'], type: 'inapp'});
+await fetchProducts({skus: ['product1'], type: 'in-app'});
 ```
 
 ## Deprecations

docs/blog/2025-09-13-v3.0.0.md

@@ -54,7 +54,7 @@ import AdFitTopFixed from "@site/src/uis/AdFitTopFixed";
 ```ts
 import {fetchProducts, type ProductSubscription} from 'expo-iap';
 
-const inapps = await fetchProducts({skus: ['prod1', 'prod2'], type: 'inapp'});
+const inapps = await fetchProducts({skus: ['prod1', 'prod2'], type: 'in-app'});
 
 const subs = (await fetchProducts({
   skus: ['sub_monthly'],
@@ -70,7 +70,7 @@ import {requestPurchase} from 'expo-iap';
 // In‑app
 await requestPurchase({
   request: {ios: {sku: 'prod1'}, android: {skus: ['prod1']}},
-  type: 'inapp',
+  type: 'in-app',
 });
 
 // Subscriptions (Android supply offer tokens)

docs/docs/api/methods/core-methods.md

@@ -84,7 +84,7 @@ const loadProducts = async () => {
   try {
     const products = await fetchProducts({
       skus: ['com.example.product1', 'com.example.product2'],
-      type: 'inapp',
+      type: 'in-app',
     });
 
     console.log('Products:', products);
@@ -114,7 +114,7 @@ const loadSubscriptions = async () => {
 
 - `params` (object):
   - `skus` (string[]): Array of product or subscription IDs to fetch
-  - `type` ('inapp' | 'subs'): Product type - 'inapp' for products, 'subs' for subscriptions
+  - `type` ('in-app' | 'subs'): Product type - 'in-app' for products, 'subs' for subscriptions
 
 **Returns:** `Promise<Product[]>`
 
@@ -149,7 +149,7 @@ const buyProduct = async (productId: string) => {
           skus: [productId],
         },
       },
-      type: 'inapp',
+      type: 'in-app',
     });
   } catch (error) {
     console.error('Purchase failed:', error);
@@ -193,7 +193,7 @@ await requestPurchase({
     quantity: 1,
     appAccountToken: 'user-account-token',
   },
-  type: 'inapp',
+  type: 'in-app',
 });
 ```
 
@@ -206,7 +206,7 @@ await requestPurchase({
     obfuscatedAccountIdAndroid: 'user-account-id',
     obfuscatedProfileIdAndroid: 'user-profile-id',
   },
-  type: 'inapp',
+  type: 'in-app',
 });
 ```
 
@@ -222,7 +222,7 @@ await requestPurchase({
     - `obfuscatedAccountIdAndroid?` (string, Android only): Obfuscated account ID
     - `obfuscatedProfileIdAndroid?` (string, Android only): Obfuscated profile ID
     - `isOfferPersonalized?` (boolean, Android only): Whether offer is personalized
-  - `type?` ('inapp' | 'subs'): Purchase type, defaults to 'inapp'
+  - `type?` ('in-app' | 'subs'): Purchase type, defaults to 'in-app'
 
 **Returns:** `Promise<Purchase | Purchase[] | void>`
 
@@ -776,6 +776,6 @@ This ensures pending transactions are surfaced and properly resolved without a s
 ## Removed APIs
 
 - `requestProducts()` — Removed in v3.0.0. Use `fetchProducts({ skus, type })` instead.
-- `getProducts()` — Removed in v3.0.0. Use `fetchProducts({ skus, type: 'inapp' })` instead.
+- `getProducts()` — Removed in v3.0.0. Use `fetchProducts({ skus, type: 'in-app' })` instead.
 - `getSubscriptions()` — Removed in v3.0.0. Use `fetchProducts({ skus, type: 'subs' })` instead.
 - `requestSubscription()` — Removed in v3.0.0. Use `requestPurchase({ ..., type: 'subs' })` and supply Android `subscriptionOffers`.

docs/docs/api/types.md

@@ -4,7 +4,7 @@ import AdFitTopFixed from "@site/src/uis/AdFitTopFixed";
 
 <AdFitTopFixed />
 
-The expo-iap type surface is now generated in one place: `src/types.ts`. The file is produced by our GraphQL schema and represents the canonical source for all product, purchase, subscription, and request shapes. After updating any schema definitions, run `npm run generate` to refresh the file.
+The expo-iap type surface is now generated in one place: `src/types.ts`. The file is produced by our GraphQL schema and represents the canonical source for all product, purchase, subscription, and request shapes. After updating any schema definitions, run `bun run generate:types` to refresh the file.
 
 Key runtime helpers that build on these types live alongside them:
 
@@ -14,27 +14,20 @@ Key runtime helpers that build on these types live alongside them:
 
 Below is a curated overview of the most commonly used types. Consult `src/types.ts` for the full schema.
 
-## Core Enumerations
+## Core Type Aliases
 
 ```ts
-export enum Platform {
-  Android = 'ANDROID',
-  Ios = 'IOS',
-}
+export type IapPlatform = 'android' | 'ios';
 
-export enum ProductType {
-  InApp = 'IN_APP',
-  Subs = 'SUBS',
-}
+export type ProductType = 'in-app' | 'subs';
 
-export enum PurchaseState {
-  Deferred = 'DEFERRED',
-  Failed = 'FAILED',
-  Pending = 'PENDING',
-  Purchased = 'PURCHASED',
-  Restored = 'RESTORED',
-  Unknown = 'UNKNOWN',
-}
+export type PurchaseState =
+  | 'deferred'
+  | 'failed'
+  | 'pending'
+  | 'purchased'
+  | 'restored'
+  | 'unknown';
 ```
 
 The `ErrorCode` enum now mirrors the OpenIAP schema without the legacy `E_` prefix:
@@ -54,7 +47,7 @@ Use `PurchaseError` from `src/purchase-error.ts` to work with typed errors and p
 
 ## Product Types
 
-All products share the generated `ProductCommon` interface. Platform extensions discriminate on the `platform` field via the `Platform` enum.
+All products share the generated `ProductCommon` interface. Platform extensions discriminate on the `platform` field via the `IapPlatform` string union.
 
 ```ts
 export interface ProductCommon {
@@ -66,7 +59,7 @@ export interface ProductCommon {
   displayPrice: string;
   currency: string;
   price?: number | null;
-  platform: Platform;
+  platform: IapPlatform;
 }
 
 export interface ProductAndroid extends ProductCommon {
@@ -77,29 +70,29 @@ export interface ProductAndroid extends ProductCommon {
     | null;
 }
 
-export interface ProductIos extends ProductCommon {
+export interface ProductIOS extends ProductCommon {
   displayNameIOS: string;
   isFamilyShareableIOS: boolean;
   jsonRepresentationIOS: string;
-  typeIOS: ProductTypeIos;
-  subscriptionInfoIOS?: SubscriptionInfoIos | null;
+  typeIOS: ProductTypeIOS;
+  subscriptionInfoIOS?: SubscriptionInfoIOS | null;
 }
 
-export type Product = ProductAndroid | ProductIos;
+export type Product = ProductAndroid | ProductIOS;
 export type ProductSubscription =
   | ProductSubscriptionAndroid
-  | ProductSubscriptionIos;
+  | ProductSubscriptionIOS;
 ```
 
 ## Purchase Types
 
-Purchases share the `PurchaseCommon` shape and discriminate on the same `platform` enum. Both variants expose the unified `purchaseToken` field for server validation.
+Purchases share the `PurchaseCommon` shape and discriminate on the same `platform` union. Both variants expose the unified `purchaseToken` field for server validation.
 
 ```ts
 export interface PurchaseCommon {
   id: string;
   productId: string;
-  platform: Platform;
+  platform: IapPlatform;
   purchaseState: PurchaseState;
   transactionDate: number;
   quantity: number;
@@ -115,15 +108,15 @@ export interface PurchaseAndroid extends PurchaseCommon {
   dataAndroid?: string | null;
 }
 
-export interface PurchaseIos extends PurchaseCommon {
+export interface PurchaseIOS extends PurchaseCommon {
   appAccountToken?: string | null;
   environmentIOS?: string | null;
   expirationDateIOS?: number | null;
   originalTransactionIdentifierIOS?: string | null;
-  offerIOS?: PurchaseOfferIos | null;
+  offerIOS?: PurchaseOfferIOS | null;
 }
 
-export type Purchase = PurchaseAndroid | PurchaseIos;
+export type Purchase = PurchaseAndroid | PurchaseIOS;
 ```
 
 ## Active Subscriptions

docs/docs/api/use-iap.md

@@ -134,7 +134,7 @@ interface UseIAPOptions {
   ```tsx
   if (connected) {
     // Safe to make IAP calls
-    fetchProducts({skus: ['product.id'], type: 'inapp'});
+    fetchProducts({skus: ['product.id'], type: 'in-app'});
   }
   ```
 
@@ -219,7 +219,7 @@ interface UseIAPOptions {
 
 #### fetchProducts
 
-- **Type**: `(params: { skus: string[]; type?: 'inapp' | 'subs' }) => Promise<void>`
+- **Type**: `(params: { skus: string[]; type?: 'in-app' | 'subs' }) => Promise<void>`
 - **Description**: Fetch products or subscriptions and update `products` / `subscriptions` state. In the hook this returns `void` (no data result), by design.
 - **Do not await for data**: Call it, then consume `products` / `subscriptions` state from the hook.
 - **Example**:
@@ -230,7 +230,7 @@ interface UseIAPOptions {
     // In hook: returns void, updates state
     fetchProducts({
       skus: ['com.app.premium', 'com.app.coins_100'],
-      type: 'inapp',
+      type: 'in-app',
     });
     fetchProducts({skus: ['com.app.premium_monthly'], type: 'subs'});
   }, [connected, fetchProducts]);
@@ -507,7 +507,7 @@ const {requestPurchase} = useIAP({
    ```tsx
    useEffect(() => {
      if (connected) {
-       fetchProducts({skus: productIds, type: 'inapp'});
+       fetchProducts({skus: productIds, type: 'in-app'});
      }
    }, [connected, fetchProducts]);
    ```

docs/docs/examples/purchase-flow.md

@@ -22,11 +22,11 @@ View the full example source:
 
 - Load products:
 
-  `fetchProducts({ skus, type: 'inapp' })`
+  `fetchProducts({ skus, type: 'in-app' })`
 
 - Start purchase:
 
-  `requestPurchase({ request: { ios: { sku }, android: { skus: [sku] } }, type: 'inapp' })`
+  `requestPurchase({ request: { ios: { sku }, android: { skus: [sku] } }, type: 'in-app' })`
 
 - Receive callbacks: `onPurchaseSuccess` / `onPurchaseError` (from `useIAP`)
 
@@ -80,7 +80,7 @@ await requestPurchase({
     ios: {sku: productId, quantity: 1},
     android: {skus: [productId]},
   },
-  type: 'inapp',
+  type: 'in-app',
 });
 ```