@livx.cc/appwrap 0.53.0 → 0.54.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@livx.cc/appwrap",
-  "version": "0.53.0",
+  "version": "0.54.0",
   "description": "Wrap any PWA into a native app with native capabilities (appwrap runtime + @livx.cc/native-kit).",
   "license": "MIT",
   "author": "Elya Livshitz",

package/runtime/app/shell/handlers-billing.ts

@@ -27,6 +27,7 @@ declare const com: any;
  */
 
 const PERIOD_UNIT = ['D', 'W', 'M', 'Y']; // SKProductPeriodUnit: Day/Week/Month/Year
+const DISCOUNT_FREE_TRIAL = 2; // SKProductDiscountPaymentMode.freeTrial (0=PayAsYouGo, 1=PayUpFront, 2=FreeTrial)
 const STATE = { Purchasing: 0, Purchased: 1, Failed: 2, Restored: 3, Deferred: 4 };
 const SK_ERR_CANCELLED = 2; // SKErrorPaymentCancelled
 
@@ -46,12 +47,40 @@ function appReceipt(): string {
   return data ? data.base64EncodedStringWithOptions(0 as unknown as NSDataBase64EncodingOptions) : '';
 }
 
+/**
+ * SKProductDiscount → the platform-neutral IntroOffer (parity with the Android mapper's zero-price
+ * phase, same `{ price, displayPrice, period, isFreeTrial }` shape native-kit's `IntroOffer` types).
+ *
+ * ⚠️ ELIGIBILITY CAVEAT: StoreKit 1 exposes `introductoryPrice` on the SKProduct REGARDLESS of whether
+ * this user is eligible — SK1 has no eligibility API (SK2's `isEligibleForIntroOffer` is Swift-async,
+ * unreachable via the ObjC bridge this handler uses). So a user who already consumed a trial in this
+ * group MAY see trial copy they won't actually get; StoreKit's own purchase sheet shows the truth at
+ * checkout. Gating on real eligibility is a follow-up if/when this handler moves to StoreKit 2.
+ */
+function mapIntroOffer(d: SKProductDiscount, locale: NSLocale): {
+  price: number; displayPrice: string; period: string | undefined; isFreeTrial: boolean;
+} {
+  const f = NSNumberFormatter.new();
+  f.numberStyle = 2; // CurrencyStyle
+  f.locale = locale;
+  const sp = d.subscriptionPeriod;
+  // The discount period is ONE cycle; numberOfPeriods is how many cycles it repeats. Total trial
+  // length = numberOfUnits × numberOfPeriods (e.g. 1 week × 1 = P1W).
+  const totalUnits = (sp ? sp.numberOfUnits : 0) * (d.numberOfPeriods || 1);
+  return {
+    price: d.price ? d.price.doubleValue : 0,
+    displayPrice: String(f.stringFromNumber(d.price as unknown as number) ?? ''),
+    period: sp ? `P${totalUnits}${PERIOD_UNIT[sp.unit] ?? 'D'}` : undefined,
+    isFreeTrial: d.paymentMode === DISCOUNT_FREE_TRIAL || (d.price ? d.price.doubleValue : 0) === 0,
+  };
+}
+
 function mapProduct(p: SKProduct) {
   const f = NSNumberFormatter.new();
   f.numberStyle = 2; // CurrencyStyle
   f.locale = p.priceLocale;
   const sp = p.subscriptionPeriod;
-  return {
+  const product: any = {
     id: String(p.productIdentifier),
     title: String(p.localizedTitle ?? ''),
     description: String(p.localizedDescription ?? ''),
@@ -62,6 +91,10 @@ function mapProduct(p: SKProduct) {
     type: sp ? 'autoRenewable' : 'unknown',
     subscriptionPeriod: sp ? `P${sp.numberOfUnits}${PERIOD_UNIT[sp.unit] ?? 'D'}` : undefined,
   };
+  // Surface the intro / free-trial phase so the paywall can show trial terms (see eligibility caveat
+  // on mapIntroOffer). Populated only when StoreKit reports an introductory price for this product.
+  if (p.introductoryPrice) product.introOffer = mapIntroOffer(p.introductoryPrice, p.priceLocale);
+  return product;
 }
 
 function receiptFor(productId: string, transactionId?: string) {