fix: resolve CI build failures and add missing APIs

- Add missing requestProducts() function for unified product fetching
- Add deprecation warnings to getProducts() and getSubscriptions()
- Change getStorefrontIOS() to show warning instead of throwing error on non-iOS platforms
- Add requestProducts to useIap hook for consistency
- Fix documentation build issues (broken anchors, missing tags, truncation marker)
- Update blog post link to correct path

Author: hyochan

docs/blog/2025-07-22-v2-6-3-release.md

@@ -9,6 +9,8 @@ tags: [release, ios, apptransaction]
 
 We're excited to announce the release of expo-iap version 2.6.3, which includes critical fixes for iOS AppTransaction functionality.
 
+<!-- truncate -->
+
 ## What's New
 
 ### Complete AppTransaction Properties

docs/blog/2025-07-22-v2-7-0-release.md

@@ -325,7 +325,7 @@ bun add expo-iap@2.7.0
 
 ## 📚 Documentation
 
-- Check our [updated documentation](/docs/latest/guides/purchases)
+- Check our [updated documentation](/docs/guides/purchases)
 - View [complete examples](https://github.com/hyochan/expo-iap/tree/main/example)
 - Join our [community discussions](https://github.com/hyochan/expo-iap/discussions)
 

docs/blog/tags.yml

@@ -32,3 +32,33 @@ breaking-changes:
   label: Breaking Changes
   permalink: /breaking-changes
   description: Updates that require code changes
+
+release:
+  label: Release
+  permalink: /release
+  description: New version releases and updates
+
+api:
+  label: API
+  permalink: /api
+  description: API updates and changes
+
+android:
+  label: Android
+  permalink: /android
+  description: Android platform specific features
+
+google-play-billing:
+  label: Google Play Billing
+  permalink: /google-play-billing
+  description: Google Play Billing Library updates
+
+apptransaction:
+  label: App Transaction
+  permalink: /apptransaction
+  description: App transaction related features
+
+migration:
+  label: Migration
+  permalink: /migration
+  description: Migration guides and updates

src/index.ts

@@ -81,6 +81,9 @@ export function initConnection() {
 }
 
 export const getProducts = async (skus: string[]): Promise<Product[]> => {
+  console.warn(
+    '`getProducts` is deprecated. Use `requestProducts({ skus, type: \'inapp\' })` instead. This function will be removed in version 3.0.0.',
+  );
   if (!skus?.length) {
     return Promise.reject(new Error('"skus" is required'));
   }
@@ -112,6 +115,9 @@ export const getProducts = async (skus: string[]): Promise<Product[]> => {
 export const getSubscriptions = async (
   skus: string[],
 ): Promise<SubscriptionProduct[]> => {
+  console.warn(
+    '`getSubscriptions` is deprecated. Use `requestProducts({ skus, type: \'subs\' })` instead. This function will be removed in version 3.0.0.',
+  );
   if (!skus?.length) {
     return Promise.reject(new Error('"skus" is required'));
   }
@@ -151,6 +157,78 @@ export async function endConnection(): Promise<boolean> {
   return ExpoIapModule.endConnection();
 }
 
+/**
+ * Request products with unified API (v2.7.0+)
+ *
+ * @param params - Product request configuration
+ * @param params.skus - Array of product SKUs to fetch
+ * @param params.type - Type of products: 'inapp' for regular products (default) or 'subs' for subscriptions
+ *
+ * @example
+ * ```typescript
+ * // Regular products
+ * const products = await requestProducts({
+ *   skus: ['product1', 'product2'],
+ *   type: 'inapp'
+ * });
+ *
+ * // Subscriptions
+ * const subscriptions = await requestProducts({
+ *   skus: ['sub1', 'sub2'],
+ *   type: 'subs'
+ * });
+ * ```
+ */
+export const requestProducts = async ({
+  skus,
+  type = 'inapp',
+}: {
+  skus: string[];
+  type?: 'inapp' | 'subs';
+}): Promise<Product[] | SubscriptionProduct[]> => {
+  if (!skus?.length) {
+    throw new Error('No SKUs provided');
+  }
+
+  if (Platform.OS === 'ios') {
+    const rawItems = await ExpoIapModule.getItems(skus);
+    const filteredItems = rawItems.filter((item: unknown) => {
+      if (!isProductIos(item)) return false;
+      return (
+        typeof item === 'object' &&
+        item !== null &&
+        'id' in item &&
+        typeof item.id === 'string' &&
+        skus.includes(item.id)
+      );
+    });
+
+    return type === 'inapp'
+      ? (filteredItems as Product[])
+      : (filteredItems as SubscriptionProduct[]);
+  }
+
+  if (Platform.OS === 'android') {
+    const items = await ExpoIapModule.getItemsByType(type, skus);
+    const filteredItems = items.filter((item: unknown) => {
+      if (!isProductAndroid(item)) return false;
+      return (
+        typeof item === 'object' &&
+        item !== null &&
+        'id' in item &&
+        typeof item.id === 'string' &&
+        skus.includes(item.id)
+      );
+    });
+
+    return type === 'inapp'
+      ? (filteredItems as Product[])
+      : (filteredItems as SubscriptionProduct[]);
+  }
+
+  throw new Error('Unsupported platform');
+};
+
 /**
  * @deprecated Use `getPurchaseHistories` instead. This function will be removed in version 3.0.0.
  */
@@ -529,7 +607,8 @@ export const finishTransaction = ({
  */
 export const getStorefrontIOS = (): Promise<string> => {
   if (Platform.OS !== 'ios') {
-    throw new Error('getStorefrontIOS: This method is only available on iOS');
+    console.warn('getStorefrontIOS: This method is only available on iOS');
+    return Promise.resolve('');
   }
   return ExpoIapModule.getStorefront();
 };

src/useIap.ts

@@ -15,6 +15,7 @@ import {
   finishTransaction as finishTransactionInternal,
   getSubscriptions,
   requestPurchase as requestPurchaseInternal,
+  requestProducts,
 } from './';
 import {syncIOS, validateReceiptIOS} from './modules/ios';
 import {validateReceiptAndroid} from './modules/android';
@@ -54,6 +55,10 @@ type UseIap = {
   getPurchaseHistories: (skus: string[]) => Promise<void>;
   getProducts: (skus: string[]) => Promise<void>;
   getSubscriptions: (skus: string[]) => Promise<void>;
+  requestProducts: (params: {
+    skus: string[];
+    type?: 'inapp' | 'subs';
+  }) => Promise<void>;
   requestPurchase: (params: {
     request: RequestPurchaseProps | RequestSubscriptionProps;
     type?: 'inapp' | 'subs';
@@ -179,6 +184,37 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     [mergeWithDuplicateCheck],
   );
 
+  const requestProductsInternal = useCallback(
+    async (params: {
+      skus: string[];
+      type?: 'inapp' | 'subs';
+    }): Promise<void> => {
+      try {
+        const result = await requestProducts(params);
+        if (params.type === 'subs') {
+          setSubscriptions((prevSubscriptions) =>
+            mergeWithDuplicateCheck(
+              prevSubscriptions,
+              result as SubscriptionProduct[],
+              (subscription) => subscription.id,
+            ),
+          );
+        } else {
+          setProducts((prevProducts) =>
+            mergeWithDuplicateCheck(
+              prevProducts,
+              result as Product[],
+              (product) => product.id,
+            ),
+          );
+        }
+      } catch (error) {
+        console.error('Error fetching products:', error);
+      }
+    },
+    [mergeWithDuplicateCheck],
+  );
+
   const getAvailablePurchasesInternal = useCallback(async (): Promise<void> => {
     try {
       const result = await getAvailablePurchases();
@@ -389,6 +425,7 @@ export function useIAP(options?: UseIAPOptions): UseIap {
     getPurchaseHistories: getPurchaseHistoriesInternal,
     getProducts: getProductsInternal,
     getSubscriptions: getSubscriptionsInternal,
+    requestProducts: requestProductsInternal,
     requestPurchase: requestPurchaseWithReset,
     validateReceipt,
     restorePurchases,