expo-iap 3.1.18 → 3.1.19

package/plugin/build/withLocalOpenIAP.js

@@ -36,13 +36,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const config_plugins_1 = require("expo/config-plugins");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const withIosAlternativeBilling_1 = require("./withIosAlternativeBilling");
+// Log a message only once per Node process
+const logOnce = (() => {
+    const printed = new Set();
+    return (msg) => {
+        if (!printed.has(msg)) {
+            console.log(msg);
+            printed.add(msg);
+        }
+    };
+})();
 const withLocalOpenIAP = (config, props) => {
     // Import and apply iOS alternative billing configuration if provided
     if (props?.iosAlternativeBilling) {
-        // Import withIosAlternativeBilling from withIAP module
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const { withIosAlternativeBilling } = require('./withIAP');
-        config = withIosAlternativeBilling(config, props.iosAlternativeBilling);
+        config = (0, withIosAlternativeBilling_1.withIosAlternativeBilling)(config, props.iosAlternativeBilling);
     }
     // Helper to resolve Android module path
     const resolveAndroidModulePath = (p) => {
@@ -82,7 +90,7 @@ const withLocalOpenIAP = (config, props) => {
             }
             let podfileContent = fs.readFileSync(podfilePath, 'utf8');
             if (podfileContent.includes("pod 'openiap',")) {
-                console.log('✅ Local OpenIAP pod already configured');
+                logOnce('✅ Local OpenIAP pod already configured');
                 return config;
             }
             const targetRegex = /target\s+['"][\w]+['"]\s+do\s*\n\s*use_expo_modules!/;
@@ -94,7 +102,7 @@ const withLocalOpenIAP = (config, props) => {
   pod 'openiap', :path => '${iosPath}'`;
                 });
                 fs.writeFileSync(podfilePath, podfileContent);
-                console.log(`✅ Added local OpenIAP pod at: ${iosPath}`);
+                logOnce(`✅ Added local OpenIAP pod at: ${iosPath}`);
             }
             else {
                 console.warn('⚠️  Could not find target block in Podfile');
@@ -168,13 +176,13 @@ const withLocalOpenIAP = (config, props) => {
         if (!contents.includes(projectDirLine))
             contents += `${projectDirLine}\n`;
         settings.contents = contents;
-        console.log(`✅ Linked local Android module at: ${androidModulePath}`);
+        logOnce(`✅ Linked local Android module at: ${androidModulePath}`);
         return config;
     });
     // 2) app/build.gradle: add implementation project(':openiap-google')
     config = (0, config_plugins_1.withAppBuildGradle)(config, (config) => {
-        const raw = props?.localPath;
         const projectRoot = config.modRequest.projectRoot;
+        const raw = props?.localPath;
         const androidInput = typeof raw === 'string' ? undefined : raw?.android;
         const androidModulePath = resolveAndroidModulePath(androidInput) ||
             resolveAndroidModulePath(path.resolve(projectRoot, 'openiap-google')) ||
@@ -184,72 +192,65 @@ const withLocalOpenIAP = (config, props) => {
         }
         const gradle = config.modResults;
         const dependencyLine = `    implementation project(':openiap-google')`;
-        // Remove any previously added Maven deps for openiap-google to avoid duplicate classes
-        const removalPatterns = [
-            // Groovy DSL: implementation "io.github.hyochan.openiap:openiap-google:x.y.z" or api "..."
-            /^\s*(?:implementation|api)\s+["']io\.github\.hyochan\.openiap:openiap-google:[^"']+["']\s*$/gm,
-            // Kotlin DSL: implementation("io.github.hyochan.openiap:openiap-google:x.y.z") or api("...")
-            /^\s*(?:implementation|api)\s*\(\s*["']io\.github\.hyochan\.openiap:openiap-google:[^"']+["']\s*\)\s*$/gm,
-        ];
+        const flavor = props?.isHorizonEnabled ? 'horizon' : 'play';
+        const strategyLine = `        missingDimensionStrategy "platform", "${flavor}"`;
         let contents = gradle.contents;
-        let removedAny = false;
-        for (const pattern of removalPatterns) {
-            if (pattern.test(contents)) {
-                contents = contents.replace(pattern, '\n');
-                removedAny = true;
-            }
+        // Remove Maven deps (avoid duplicate classes with local module)
+        const mavenPattern = /^\s*(?:implementation|api)\s*\(?\s*["']io\.github\.hyochan\.openiap:openiap-google:[^"']+["']\s*\)?\s*$/gm;
+        if (mavenPattern.test(contents)) {
+            contents = contents.replace(mavenPattern, '\n');
+            logOnce('🧹 Removed Maven openiap-google (using local module)');
         }
-        if (removedAny) {
-            gradle.contents = contents;
-            console.log('🧹 Removed Maven openiap-google to use local :openiap-google');
+        // Add missingDimensionStrategy (required for flavored module)
+        // Remove any existing platform strategies first to avoid duplicates
+        const strategyPattern = /^\s*missingDimensionStrategy\s*\(?\s*["']platform["']\s*,\s*["'](play|horizon)["']\s*\)?\s*$/gm;
+        if (strategyPattern.test(contents)) {
+            contents = contents.replace(strategyPattern, '');
+            logOnce('🧹 Removed existing missingDimensionStrategy for platform');
         }
-        if (!gradle.contents.includes(dependencyLine)) {
+        if (!contents.includes(strategyLine)) {
+            const lines = contents.split('\n');
+            const idx = lines.findIndex((line) => line.match(/defaultConfig\s*\{/));
+            if (idx !== -1) {
+                lines.splice(idx + 1, 0, strategyLine);
+                contents = lines.join('\n');
+                logOnce(`🛠️ expo-iap: Added missingDimensionStrategy for ${flavor} flavor`);
+            }
+        }
+        // Add project dependency
+        if (!contents.includes(dependencyLine)) {
             const anchor = /dependencies\s*\{/m;
-            if (anchor.test(gradle.contents)) {
-                gradle.contents = gradle.contents.replace(anchor, (m) => `${m}\n${dependencyLine}`);
+            if (anchor.test(contents)) {
+                contents = contents.replace(anchor, (m) => `${m}\n${dependencyLine}`);
             }
             else {
-                gradle.contents += `\n\ndependencies {\n${dependencyLine}\n}\n`;
+                contents += `\n\ndependencies {\n${dependencyLine}\n}\n`;
             }
-            console.log('🛠️ Added dependency on local :openiap-google project');
+            logOnce('🛠️ Added dependency on local :openiap-google project');
         }
+        gradle.contents = contents;
         return config;
     });
-    // 3) Ensure final cleanup in app/build.gradle after all mods are applied
+    // 3) Set horizonEnabled in gradle.properties
     config = (0, config_plugins_1.withDangerousMod)(config, [
         'android',
         async (config) => {
-            try {
-                const { platformProjectRoot } = config.modRequest;
-                const appBuildGradle = path.join(platformProjectRoot, 'app', 'build.gradle');
-                if (fs.existsSync(appBuildGradle)) {
-                    let contents = fs.readFileSync(appBuildGradle, 'utf8');
-                    const patterns = [
-                        // Groovy DSL
-                        /^\s*(?:implementation|api)\s+["']io\.github\.hyochan\.openiap:openiap-google:[^"']+["']\s*$/gm,
-                        // Kotlin DSL
-                        /^\s*(?:implementation|api)\s*\(\s*["']io\.github\.hyochan\.openiap:openiap-google:[^"']+["']\s*\)\s*$/gm,
-                    ];
-                    let changed = false;
-                    for (const p of patterns) {
-                        if (p.test(contents)) {
-                            contents = contents.replace(p, '\n');
-                            changed = true;
-                        }
-                    }
-                    if (changed) {
-                        fs.writeFileSync(appBuildGradle, contents);
-                        console.log('🧹 expo-iap: Cleaned Maven openiap-google for local :openiap-google');
-                    }
-                }
-            }
-            catch (e) {
-                console.warn('expo-iap: cleanup step failed:', e);
+            const { platformProjectRoot } = config.modRequest;
+            const gradlePropertiesPath = path.join(platformProjectRoot, 'gradle.properties');
+            if (fs.existsSync(gradlePropertiesPath)) {
+                let contents = fs.readFileSync(gradlePropertiesPath, 'utf8');
+                const isHorizon = props?.isHorizonEnabled ?? false;
+                // Update horizonEnabled property
+                contents = contents.replace(/^horizonEnabled=.*$/gm, '');
+                if (!contents.endsWith('\n'))
+                    contents += '\n';
+                contents += `horizonEnabled=${isHorizon}\n`;
+                fs.writeFileSync(gradlePropertiesPath, contents);
+                logOnce(`🛠️ expo-iap: Set horizonEnabled=${isHorizon} in gradle.properties`);
             }
             return config;
         },
     ]);
-    // (removed) Avoid global root build.gradle mutations; included module should manage its plugins
     return config;
 };
 exports.default = withLocalOpenIAP;

package/plugin/src/withIAP.ts

@@ -5,12 +5,14 @@ import {
   withAndroidManifest,
   withAppBuildGradle,
   withDangerousMod,
-  withEntitlementsPlist,
-  withInfoPlist,
 } from 'expo/config-plugins';
 import * as fs from 'fs';
 import * as path from 'path';
 import withLocalOpenIAP from './withLocalOpenIAP';
+import {
+  withIosAlternativeBilling,
+  type IOSAlternativeBillingConfig,
+} from './withIosAlternativeBilling';
 
 const pkg = require('../../package.json');
 const openiapVersions = JSON.parse(
@@ -55,9 +57,13 @@ const addLineToGradle = (
 const modifyAppBuildGradle = (
   gradle: string,
   language: 'groovy' | 'kotlin',
+  isHorizonEnabled?: boolean,
 ): string => {
   let modified = gradle;
 
+  // Determine which flavor to use based on isHorizonEnabled
+  const flavor = isHorizonEnabled ? 'horizon' : 'play';
+
   // Ensure OpenIAP dependency exists at desired version in app-level build.gradle(.kts)
   const impl = (ga: string, v: string) =>
     language === 'kotlin'
@@ -91,27 +97,66 @@ const modifyAppBuildGradle = (
     );
   }
 
+  // Add flavor dimension and default config for OpenIAP if horizon is enabled
+  if (isHorizonEnabled) {
+    // Add missingDimensionStrategy to select horizon flavor
+    const defaultConfigRegex = /defaultConfig\s*{/;
+    if (defaultConfigRegex.test(modified)) {
+      const strategyLine =
+        language === 'kotlin'
+          ? `        missingDimensionStrategy("platform", "${flavor}")`
+          : `        missingDimensionStrategy "platform", "${flavor}"`;
+
+      // Remove any existing platform strategies first to avoid duplicates
+      const strategyPattern =
+        /^\s*missingDimensionStrategy\s*\(?\s*["']platform["']\s*,\s*["'](play|horizon)["']\s*\)?\s*$/gm;
+      if (strategyPattern.test(modified)) {
+        modified = modified.replace(strategyPattern, '');
+        logOnce('🧹 Removed existing missingDimensionStrategy for platform');
+      }
+
+      // Add the new strategy
+      if (!/missingDimensionStrategy.*platform/.test(modified)) {
+        modified = addLineToGradle(
+          modified,
+          defaultConfigRegex,
+          strategyLine,
+          1,
+        );
+        logOnce(
+          `🛠️ expo-iap: Added missingDimensionStrategy for ${flavor} flavor`,
+        );
+      }
+    }
+  }
+
   return modified;
 };
 
-const withIapAndroid: ConfigPlugin<{addDeps?: boolean} | void> = (
-  config,
-  props,
-) => {
+const withIapAndroid: ConfigPlugin<
+  {
+    addDeps?: boolean;
+    horizonAppId?: string;
+    isHorizonEnabled?: boolean;
+  } | void
+> = (config, props) => {
   const addDeps = props?.addDeps ?? true;
 
+  // Add dependencies if needed (only when not using local module)
   if (addDeps) {
     config = withAppBuildGradle(config, (config) => {
-      // language provided by config-plugins: 'groovy' | 'kotlin'
       const language = (config.modResults as any).language || 'groovy';
       config.modResults.contents = modifyAppBuildGradle(
         config.modResults.contents,
         language,
+        props?.isHorizonEnabled,
       );
       return config;
     });
   }
 
+  // Note: missingDimensionStrategy for local dev is handled in withLocalOpenIAP
+
   config = withAndroidManifest(config, (config) => {
     const manifest = config.modResults;
     if (!manifest.manifest['uses-permission']) {
@@ -133,121 +178,45 @@ const withIapAndroid: ConfigPlugin<{addDeps?: boolean} | void> = (
       );
     }
 
-    return config;
-  });
-
-  return config;
-};
-
-export interface IOSAlternativeBillingConfig {
-  /** Country codes where external purchases are supported (ISO 3166-1 alpha-2) */
-  countries?: string[];
-  /** External purchase URLs per country (iOS 15.4+) */
-  links?: Record<string, string>;
-  /** Multiple external purchase URLs per country (iOS 17.5+, up to 5 per country) */
-  multiLinks?: Record<string, string[]>;
-  /** Custom link regions (iOS 18.1+) */
-  customLinkRegions?: string[];
-  /** Streaming link regions for music apps (iOS 18.2+) */
-  streamingLinkRegions?: string[];
-  /** Enable external purchase link entitlement */
-  enableExternalPurchaseLink?: boolean;
-  /** Enable external purchase link streaming entitlement (music apps only) */
-  enableExternalPurchaseLinkStreaming?: boolean;
-}
-
-/** Add external purchase entitlements and Info.plist configuration */
-const withIosAlternativeBilling: ConfigPlugin<
-  IOSAlternativeBillingConfig | undefined
-> = (config, options) => {
-  if (!options || !options.countries || options.countries.length === 0) {
-    return config;
-  }
-
-  // Add entitlements
-  config = withEntitlementsPlist(config, (config) => {
-    // Always add basic external purchase entitlement when countries are specified
-    config.modResults['com.apple.developer.storekit.external-purchase'] = true;
-    logOnce(
-      '✅ Added com.apple.developer.storekit.external-purchase to entitlements',
-    );
-
-    // Add external purchase link entitlement if enabled
-    if (options.enableExternalPurchaseLink) {
-      config.modResults['com.apple.developer.storekit.external-purchase-link'] =
-        true;
-      logOnce(
-        '✅ Added com.apple.developer.storekit.external-purchase-link to entitlements',
-      );
-    }
-
-    // Add streaming entitlement if enabled
-    if (options.enableExternalPurchaseLinkStreaming) {
-      config.modResults[
-        'com.apple.developer.storekit.external-purchase-link-streaming'
-      ] = true;
-      logOnce(
-        '✅ Added com.apple.developer.storekit.external-purchase-link-streaming to entitlements',
-      );
-    }
-
-    return config;
-  });
-
-  // Add Info.plist configuration
-  config = withInfoPlist(config, (config) => {
-    const plist = config.modResults;
-
-    // 1. SKExternalPurchase (Required)
-    plist.SKExternalPurchase = options.countries;
-    logOnce(
-      `✅ Added SKExternalPurchase with countries: ${options.countries?.join(
-        ', ',
-      )}`,
-    );
+    // Add Meta Horizon App ID if provided
+    if (props?.horizonAppId) {
+      if (
+        !manifest.manifest.application ||
+        manifest.manifest.application.length === 0
+      ) {
+        manifest.manifest.application = [
+          {$: {'android:name': '.MainApplication'}},
+        ];
+      }
 
-    // 2. SKExternalPurchaseLink (Optional - iOS 15.4+)
-    if (options.links && Object.keys(options.links).length > 0) {
-      plist.SKExternalPurchaseLink = options.links;
-      logOnce(
-        `✅ Added SKExternalPurchaseLink for ${
-          Object.keys(options.links).length
-        } countries`,
-      );
-    }
+      const application = manifest.manifest.application![0];
+      if (!application['meta-data']) {
+        application['meta-data'] = [];
+      }
 
-    // 3. SKExternalPurchaseMultiLink (iOS 17.5+)
-    if (options.multiLinks && Object.keys(options.multiLinks).length > 0) {
-      plist.SKExternalPurchaseMultiLink = options.multiLinks;
-      logOnce(
-        `✅ Added SKExternalPurchaseMultiLink for ${
-          Object.keys(options.multiLinks).length
-        } countries`,
-      );
-    }
+      const metaData = application['meta-data'];
+      const horizonAppIdMeta = {
+        $: {
+          'android:name': 'com.oculus.vr.APP_ID',
+          'android:value': props.horizonAppId,
+        },
+      };
 
-    // 4. SKExternalPurchaseCustomLinkRegions (iOS 18.1+)
-    if (options.customLinkRegions && options.customLinkRegions.length > 0) {
-      plist.SKExternalPurchaseCustomLinkRegions = options.customLinkRegions;
-      logOnce(
-        `✅ Added SKExternalPurchaseCustomLinkRegions: ${options.customLinkRegions.join(
-          ', ',
-        )}`,
+      const existingIndex = metaData.findIndex(
+        (m) => m.$['android:name'] === 'com.oculus.vr.APP_ID',
       );
-    }
 
-    // 5. SKExternalPurchaseLinkStreamingRegions (iOS 18.2+)
-    if (
-      options.streamingLinkRegions &&
-      options.streamingLinkRegions.length > 0
-    ) {
-      plist.SKExternalPurchaseLinkStreamingRegions =
-        options.streamingLinkRegions;
-      logOnce(
-        `✅ Added SKExternalPurchaseLinkStreamingRegions: ${options.streamingLinkRegions.join(
-          ', ',
-        )}`,
-      );
+      if (existingIndex !== -1) {
+        metaData[existingIndex] = horizonAppIdMeta;
+        logOnce(
+          `✅ Updated com.oculus.vr.APP_ID to ${props.horizonAppId} in AndroidManifest.xml`,
+        );
+      } else {
+        metaData.push(horizonAppIdMeta);
+        logOnce(
+          `✅ Added com.oculus.vr.APP_ID: ${props.horizonAppId} to AndroidManifest.xml`,
+        );
+      }
     }
 
     return config;
@@ -310,12 +279,47 @@ export interface ExpoIapPluginOptions {
   /** Enable local development mode */
   enableLocalDev?: boolean;
   /**
-   * iOS Alternative Billing configuration.
-   * Configure external purchase countries, links, and entitlements.
-   * Requires approval from Apple.
+   * Optional modules configuration
+   */
+  modules?: {
+    /**
+     * Onside module for iOS alternative billing (Korea market)
+     * @platform ios
+     */
+    onside?: boolean;
+    /**
+     * Horizon module for Meta Quest/VR devices
+     * @platform android
+     */
+    horizon?: boolean;
+  };
+  /**
+   * iOS-specific configuration
    * @platform ios
    */
+  ios?: {
+    /**
+     * iOS Alternative Billing configuration.
+     * Configure external purchase countries, links, and entitlements.
+     * Requires approval from Apple.
+     */
+    alternativeBilling?: IOSAlternativeBillingConfig;
+  };
+  /**
+   * Android-specific configuration
+   * @platform android
+   */
+  android?: {
+    /**
+     * Meta Horizon App ID for Quest/VR devices.
+     * Required when modules.horizon is true.
+     */
+    horizonAppId?: string;
+  };
+  /** @deprecated Use ios.alternativeBilling instead */
   iosAlternativeBilling?: IOSAlternativeBillingConfig;
+  /** @deprecated Use android.horizonAppId instead */
+  horizonAppId?: string;
 }
 
 const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
@@ -323,10 +327,26 @@ const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
   options,
 ) => {
   try {
+    // Read Horizon configuration from modules
+    const isHorizonEnabled = options?.modules?.horizon ?? false;
+
+    const horizonAppId =
+      options?.android?.horizonAppId ?? options?.horizonAppId;
+    const iosAlternativeBilling =
+      options?.ios?.alternativeBilling ?? options?.iosAlternativeBilling;
+
+    logOnce(
+      `🔍 [expo-iap] Config values: horizonAppId=${horizonAppId}, isHorizonEnabled=${isHorizonEnabled}`,
+    );
+
     // Respect explicit flag; fall back to presence of localPath only when flag is unset
     const isLocalDev = options?.enableLocalDev ?? !!options?.localPath;
     // Apply Android modifications (skip adding deps when linking local module)
-    let result = withIapAndroid(config, {addDeps: !isLocalDev});
+    let result = withIapAndroid(config, {
+      addDeps: !isLocalDev,
+      horizonAppId,
+      isHorizonEnabled,
+    });
 
     // iOS: choose one path to avoid overlap
     if (isLocalDev) {
@@ -354,12 +374,14 @@ const withIap: ConfigPlugin<ExpoIapPluginOptions | void> = (
         logOnce(`🔧 [expo-iap] Enabling local OpenIAP: ${preview}`);
         result = withLocalOpenIAP(result, {
           localPath: resolved,
-          iosAlternativeBilling: options?.iosAlternativeBilling,
+          iosAlternativeBilling,
+          horizonAppId,
+          isHorizonEnabled, // Resolved from modules.horizon (line 467)
         });
       }
     } else {
       // Ensure iOS Podfile is set up to resolve public CocoaPods specs
-      result = withIapIOS(result, options?.iosAlternativeBilling);
+      result = withIapIOS(result, iosAlternativeBilling);
       logOnce('📦 [expo-iap] Using OpenIAP from CocoaPods');
     }
 

package/plugin/src/withIosAlternativeBilling.ts

@@ -0,0 +1,133 @@
+import {
+  ConfigPlugin,
+  withEntitlementsPlist,
+  withInfoPlist,
+} from 'expo/config-plugins';
+
+// Log a message only once per Node process
+const logOnce = (() => {
+  const printed = new Set<string>();
+  return (msg: string) => {
+    if (!printed.has(msg)) {
+      console.log(msg);
+      printed.add(msg);
+    }
+  };
+})();
+
+export interface IOSAlternativeBillingConfig {
+  /** Country codes where external purchases are supported (ISO 3166-1 alpha-2) */
+  countries?: string[];
+  /** External purchase URLs per country (iOS 15.4+) */
+  links?: Record<string, string>;
+  /** Multiple external purchase URLs per country (iOS 17.5+, up to 5 per country) */
+  multiLinks?: Record<string, string[]>;
+  /** Custom link regions (iOS 18.1+) */
+  customLinkRegions?: string[];
+  /** Streaming link regions for music apps (iOS 18.2+) */
+  streamingLinkRegions?: string[];
+  /** Enable external purchase link entitlement */
+  enableExternalPurchaseLink?: boolean;
+  /** Enable external purchase link streaming entitlement (music apps only) */
+  enableExternalPurchaseLinkStreaming?: boolean;
+}
+
+/** Add external purchase entitlements and Info.plist configuration */
+export const withIosAlternativeBilling: ConfigPlugin<
+  IOSAlternativeBillingConfig | undefined
+> = (config, options) => {
+  if (!options || !options.countries || options.countries.length === 0) {
+    return config;
+  }
+
+  // Add entitlements
+  config = withEntitlementsPlist(config, (config) => {
+    // Always add basic external purchase entitlement when countries are specified
+    config.modResults['com.apple.developer.storekit.external-purchase'] = true;
+    logOnce(
+      '✅ Added com.apple.developer.storekit.external-purchase to entitlements',
+    );
+
+    // Add external purchase link entitlement if enabled
+    if (options.enableExternalPurchaseLink) {
+      config.modResults['com.apple.developer.storekit.external-purchase-link'] =
+        true;
+      logOnce(
+        '✅ Added com.apple.developer.storekit.external-purchase-link to entitlements',
+      );
+    }
+
+    // Add streaming entitlement if enabled
+    if (options.enableExternalPurchaseLinkStreaming) {
+      config.modResults[
+        'com.apple.developer.storekit.external-purchase-link-streaming'
+      ] = true;
+      logOnce(
+        '✅ Added com.apple.developer.storekit.external-purchase-link-streaming to entitlements',
+      );
+    }
+
+    return config;
+  });
+
+  // Add Info.plist configuration
+  config = withInfoPlist(config, (config) => {
+    const plist = config.modResults;
+
+    // 1. SKExternalPurchase (Required)
+    plist.SKExternalPurchase = options.countries;
+    logOnce(
+      `✅ Added SKExternalPurchase with countries: ${options.countries?.join(
+        ', ',
+      )}`,
+    );
+
+    // 2. SKExternalPurchaseLink (Optional - iOS 15.4+)
+    if (options.links && Object.keys(options.links).length > 0) {
+      plist.SKExternalPurchaseLink = options.links;
+      logOnce(
+        `✅ Added SKExternalPurchaseLink for ${
+          Object.keys(options.links).length
+        } countries`,
+      );
+    }
+
+    // 3. SKExternalPurchaseMultiLink (iOS 17.5+)
+    if (options.multiLinks && Object.keys(options.multiLinks).length > 0) {
+      plist.SKExternalPurchaseMultiLink = options.multiLinks;
+      logOnce(
+        `✅ Added SKExternalPurchaseMultiLink for ${
+          Object.keys(options.multiLinks).length
+        } countries`,
+      );
+    }
+
+    // 4. SKExternalPurchaseCustomLinkRegions (iOS 18.1+)
+    if (options.customLinkRegions && options.customLinkRegions.length > 0) {
+      plist.SKExternalPurchaseCustomLinkRegions = options.customLinkRegions;
+      logOnce(
+        `✅ Added SKExternalPurchaseCustomLinkRegions: ${options.customLinkRegions.join(
+          ', ',
+        )}`,
+      );
+    }
+
+    // 5. SKExternalPurchaseLinkStreamingRegions (iOS 18.2+)
+    if (
+      options.streamingLinkRegions &&
+      options.streamingLinkRegions.length > 0
+    ) {
+      plist.SKExternalPurchaseLinkStreamingRegions =
+        options.streamingLinkRegions;
+      logOnce(
+        `✅ Added SKExternalPurchaseLinkStreamingRegions: ${options.streamingLinkRegions.join(
+          ', ',
+        )}`,
+      );
+    }
+
+    return config;
+  });
+
+  return config;
+};