@mysuperwall/react-native 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 1.2.0 - 2026-10-15
+
+- Add setProductData for real localized billing prices and currency.
+- Scope rendered HTML caches by the exact price payload, rejecting late responses from previous price contexts.
+- Keep existing billing and store purchase flows owned by the host application.
+
 ## 1.1.0
 
 - Add compiled JavaScript and TypeScript declarations to npm packages.

package/README.md

@@ -156,3 +156,19 @@ Programmatic dismissal through the hook clears the modal without starting recove
 Manifest and offline event storage are isolated by app/server scope. Unscoped legacy
 caches are ignored; source updates need one successful manifest sync before offline use.
 No store billing is replaced by this SDK.
+
+## Localized store prices (1.2.0+)
+
+This SDK does not query StoreKit, Google Play Billing or RevenueCat products itself.
+Initialize the existing billing provider and fetch its products first. Build a map
+keyed by the exact store product ID. Each value must contain `displayPrice`,
+`priceString` and `currencyCode` from the store. Supply `subscriptionPeriod` and
+store-derived `pricePerDayText`, `pricePerWeekText`, `pricePerMonthText`,
+`pricePerYearText` where the template uses them. Never convert a USD catalog price
+using device locale or exchange rates. Storefront determines the currency.
+
+Call `setProductData` after SDK initialization and before presenting. Await its
+completion (Promise on React Native, callback on native platforms) and refresh it
+when store product prices change. Missing live product data is not proof that
+catalog/default prices are localized. Wait for successful manifest loading on a
+first installation. Existing displayed paywalls are not silently replaced.

package/lib/MySuperwall.d.ts

@@ -23,6 +23,7 @@ export declare class MySuperwall {
     country: string;
     appVersion?: string;
     private premium;
+    private productData;
     private epoch;
     private presentationSequence;
     private followUps;
@@ -42,6 +43,8 @@ export declare class MySuperwall {
     private resetFlow;
     private manifestOptions;
     setLocale(locale: string): Promise<void>;
+    /** Supply localized prices from StoreKit, Play Billing or RevenueCat before presenting. */
+    setProductData(products: Record<string, unknown>): Promise<void>;
     setCountry(country: string): void;
     setAppVersion(version: string): void;
     setSubscriptionStatus(premium: boolean): void;

package/lib/MySuperwall.js

@@ -13,6 +13,7 @@ class MySuperwall {
         this.locale = 'en';
         this.country = '';
         this.premium = false;
+        this.productData = {};
         this.epoch = 0;
         this.presentationSequence = 0;
         this.followUps = new followUpService_1.FollowUpService();
@@ -35,6 +36,7 @@ class MySuperwall {
         inst.resetFlow();
         inst.userAttributes = {};
         inst.premium = false;
+        inst.productData = {};
         inst.appKey = options.appKey;
         inst.baseUrl = options.baseUrl
             ? options.baseUrl.endsWith('/')
@@ -78,7 +80,7 @@ class MySuperwall {
     }
     resetFlow() { this.epoch++; this.followUps.reset(); this.activeFlow = undefined; }
     manifestOptions() {
-        return { baseUrl: this.baseUrl, appKey: this.appKey, bundleId: this.bundleId, platform: this.platform, lang: this.locale };
+        return { baseUrl: this.baseUrl, appKey: this.appKey, bundleId: this.bundleId, platform: this.platform, lang: this.locale, substitutionData: this.productData };
     }
     async setLocale(locale) {
         const normalized = locale.trim().replace(/_/g, '-').toLowerCase();
@@ -92,6 +94,16 @@ class MySuperwall {
         if (epoch === this.epoch)
             await this.manifestService.syncInBackground(this.manifestOptions());
     }
+    /** Supply localized prices from StoreKit, Play Billing or RevenueCat before presenting. */
+    async setProductData(products) {
+        const captured = JSON.parse(JSON.stringify(products));
+        if (JSON.stringify(captured) === JSON.stringify(this.productData))
+            return;
+        this.productData = captured;
+        const options = this.manifestOptions();
+        this.manifestService.configure(options); // Drops old price HTML and rejects stale responses.
+        await this.manifestService.syncInBackground(options);
+    }
     setCountry(country) { this.country = country.trim().toUpperCase(); }
     setAppVersion(version) { this.appVersion = version; }
     setSubscriptionStatus(premium) { this.premium = premium; }

package/lib/services/manifestService.d.ts

@@ -5,6 +5,7 @@ export interface ManifestScope {
     bundleId?: string;
     platform?: string;
     lang?: string;
+    substitutionData?: Record<string, unknown>;
 }
 export declare class ManifestService {
     private scope;

package/lib/services/manifestService.js

@@ -14,7 +14,7 @@ class ManifestService {
     }
     static scopeKey(options) {
         return JSON.stringify([options.baseUrl.replace(/\/+$/, '') + '/', options.appKey || '',
-            options.bundleId || '', options.platform || 'ios', options.lang || 'en']);
+            options.bundleId || '', options.platform || 'ios', options.lang || 'en', JSON.stringify(options.substitutionData || {})]);
     }
     configure(options) {
         const scope = ManifestService.scopeKey(options);
@@ -59,7 +59,7 @@ class ManifestService {
             const response = await fetch(options.baseUrl.replace(/\/+$/, '') + '/paywall/manifest', {
                 method: 'POST', headers, body: JSON.stringify({ platform: options.platform || 'ios',
                     appKey: options.appKey, bundleId: options.platform === 'android' ? undefined : options.bundleId,
-                    packageName: options.platform === 'android' ? options.bundleId : undefined, lang: options.lang || 'en', hash: this.manifest?.hash })
+                    packageName: options.platform === 'android' ? options.bundleId : undefined, lang: options.lang || 'en', hash: this.manifest?.hash, substitutionData: options.substitutionData || {} })
             });
             if (scope !== this.scope || generation !== this.generation)
                 return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mysuperwall/react-native",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "React Native SDK for MySuperWall paywalls, targeting and offline rule evaluation",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -45,7 +45,7 @@
   "homepage": "https://mysuperwall.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Unevenn/mysuperwall_react_native.git"
+    "url": "git+https://github.com/Unevenn/mysuperwall_react_native.git"
   },
   "publishConfig": {
     "access": "public"

package/src/MySuperwall.ts

@@ -28,6 +28,7 @@ export class MySuperwall {
   public country: string = '';
   public appVersion?: string;
   private premium = false;
+  private productData: Record<string, unknown> = {};
   private epoch = 0;
   private presentationSequence = 0;
   private followUps = new FollowUpService();
@@ -61,6 +62,7 @@ export class MySuperwall {
     inst.resetFlow();
     inst.userAttributes = {};
     inst.premium = false;
+    inst.productData = {};
     inst.appKey = options.appKey;
     inst.baseUrl = options.baseUrl
       ? options.baseUrl.endsWith('/')
@@ -102,7 +104,7 @@ export class MySuperwall {
 
   private resetFlow(): void { this.epoch++; this.followUps.reset(); this.activeFlow = undefined; }
   private manifestOptions() {
-    return { baseUrl: this.baseUrl, appKey: this.appKey, bundleId: this.bundleId, platform: this.platform, lang: this.locale };
+    return { baseUrl: this.baseUrl, appKey: this.appKey, bundleId: this.bundleId, platform: this.platform, lang: this.locale, substitutionData: this.productData };
   }
   public async setLocale(locale: string): Promise<void> {
     const normalized = locale.trim().replace(/_/g, '-').toLowerCase();
@@ -113,6 +115,16 @@ export class MySuperwall {
     await this.manifestService.loadFromDisk();
     if (epoch === this.epoch) await this.manifestService.syncInBackground(this.manifestOptions());
   }
+  /** Supply localized prices from StoreKit, Play Billing or RevenueCat before presenting. */
+  public async setProductData(products: Record<string, unknown>): Promise<void> {
+    const captured = JSON.parse(JSON.stringify(products)) as Record<string, unknown>;
+    if (JSON.stringify(captured) === JSON.stringify(this.productData)) return;
+    this.productData = captured;
+    const options = this.manifestOptions();
+    this.manifestService.configure(options); // Drops old price HTML and rejects stale responses.
+    await this.manifestService.syncInBackground(options);
+  }
+
   public setCountry(country: string): void { this.country = country.trim().toUpperCase(); }
   public setAppVersion(version: string): void { this.appVersion = version; }
   public setSubscriptionStatus(premium: boolean): void { this.premium = premium; }

package/src/services/manifestService.ts

@@ -1,7 +1,7 @@
 import { PaywallManifest } from '../models/manifest';
 
 export interface ManifestScope {
-  baseUrl: string; appKey?: string; bundleId?: string; platform?: string; lang?: string;
+  baseUrl: string; appKey?: string; bundleId?: string; platform?: string; lang?: string; substitutionData?: Record<string, unknown>;
 }
 
 export class ManifestService {
@@ -15,7 +15,7 @@ export class ManifestService {
   }
   static scopeKey(options: ManifestScope): string {
     return JSON.stringify([options.baseUrl.replace(/\/+$/, '') + '/', options.appKey || '',
-      options.bundleId || '', options.platform || 'ios', options.lang || 'en']);
+      options.bundleId || '', options.platform || 'ios', options.lang || 'en', JSON.stringify(options.substitutionData || {})]);
   }
   configure(options: ManifestScope): void {
     const scope = ManifestService.scopeKey(options);
@@ -48,7 +48,7 @@ export class ManifestService {
       const response = await fetch(options.baseUrl.replace(/\/+$/, '') + '/paywall/manifest', {
         method: 'POST', headers, body: JSON.stringify({ platform: options.platform || 'ios',
           appKey: options.appKey, bundleId: options.platform === 'android' ? undefined : options.bundleId,
-          packageName: options.platform === 'android' ? options.bundleId : undefined, lang: options.lang || 'en', hash: this.manifest?.hash })
+          packageName: options.platform === 'android' ? options.bundleId : undefined, lang: options.lang || 'en', hash: this.manifest?.hash, substitutionData: options.substitutionData || {} })
       });
       if (scope !== this.scope || generation !== this.generation) return null;
       if (response.status === 304) return this.manifest;