Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@revenuecat/purchases-typescript-internal

RevenueCat202.5kMIT13.29.1TypeScript support: included

Typescript code to be used by RevenueCat's hybrid SDKs. Not meant for external usage.

RevenueCat

readme

purchases-hybrid-common

Common files for the Hybrid SDKs

changelog

13.29.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.22.0 => 5.22.2 Android 8.17.0 => 8.17.1 JS 1.2.0 => 1.2.1 (#1136) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Add job to deploy purchases-js-hybrid-mappings (#1133) via Toni Rico (@tonidero)
  • Bump nokogiri from 1.18.7 to 1.18.8 (#1129) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.11.6 to 1.11.11 (#1128) via dependabot[bot] (@dependabot[bot])
  • Automate update of purchases-js in purchases-js-hybrid-mappings (#1132) via Toni Rico (@tonidero)
  • [purchases-js-hybrid-mappings] Fix logIn result mapping (#1130) via Toni Rico (@tonidero)
  • Do not include tsconfig in purchases-typescript-internal (#1131) via Toni Rico (@tonidero)
  • [purchases-js-hybrid-mappings] Finalize last APIs + export UMD files (#1127) via Toni Rico (@tonidero)
  • [purchases-js-hybrid-mappings] Add rollup to generate minified library outputs (#1120) via Toni Rico (@tonidero)
  • [purchases-js-hybrid-mappings] Add remaining APIs mappings (#1118) via Toni Rico (@tonidero)
  • [purchases-js-hybrid-mapping] Add purchasePackage function (#1116) via Toni Rico (@tonidero)

13.29.0

RevenueCat SDK

✨ New Features

  • Add getStorefront APIs (#1125) via Toni Rico (@tonidero)

    📦 Dependency Updates

  • [AUTOMATIC] iOS 5.21.2 => 5.22.0 Android 8.16.1 => 8.17.0 (#1123) via RevenueCat Git Bot (@RCGitBot)

13.28.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.21.0 => 5.21.2 Android 8.16.0 => 8.16.1 (#1121) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • [purchases-js-hybrid-mappings] Add login/logout functions and set PlatformInfo (#1115) via Toni Rico (@tonidero)
  • [purchases-js-hybrid-mapping] Add mapping for errors and run prettier in the library (#1109) via Toni Rico (@tonidero)
  • Add offerings mapping purchases js hybrid mappings (#1106) via Toni Rico (@tonidero)
  • Create purchases-js-hybrid-mappings module with CustomerInfo model mappings (#1104) via Toni Rico (@tonidero)
  • Bump fastlane from 2.227.0 to 2.227.1 (#1114) via dependabot[bot] (@dependabot[bot])

13.28.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.20.3 => 5.21.0 (#1111) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump fastlane-plugin-revenuecat_internal from 05ef095 to 9a29f63 (#1096) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.11.3 to 1.11.6 (#1102) via dependabot[bot] (@dependabot[bot])

13.27.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.20.2 => 5.20.3 Android 8.15.1 => 8.16.0 (#1107) via RevenueCat Git Bot (@RCGitBot)

13.26.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.20.0 => 5.20.2 Android 8.15.0 => 8.15.1 (#1101) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump nokogiri from 1.18.3 to 1.18.4 (#1097) via dependabot[bot] (@dependabot[bot])

13.26.0

RevenueCat SDK

✨ New Features

  • Add more events to iOS CustomerCenterViewControllerDelegateWrapper (#1084) via Cesar de la Vega (@vegaro)

    📦 Dependency Updates

  • [AUTOMATIC] Android 8.14.1 => 8.14.2 (#1090) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump fastlane from 2.226.0 to 2.227.0 (#1089) via dependabot[bot] (@dependabot[bot])
  • Add automatic changes on .idea files (#1077) via Cesar de la Vega (@vegaro)

13.25.0

RevenueCat SDK

✨ New Features

  • Create CustomerCenterListenerWrapper (#1076) via Cesar de la Vega (@vegaro)

    📦 Dependency Updates

  • [AUTOMATIC] Android 8.13.0 => 8.14.1 (#1086) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • chore: test pod_push_with_error_handling for new pods (#1081) via Facundo Menzella (@facumenzella)
  • Bump lefthook from 1.11.0 to 1.11.3 (#1082) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane-plugin-revenuecat_internal from 177d985 to 05ef095 (#1083) via dependabot[bot] (@dependabot[bot])

13.24.0

RevenueCat SDK

✨ New Features

  • feat: Add missing onCloseHandler to CustomerCenterUIViewController for custom close (#1079) via Facundo Menzella (@facumenzella)

🔄 Other Changes

  • Update detekt and enable autocorrect (#1078) via Cesar de la Vega (@vegaro)

13.23.0

RevenueCat SDK

🐞 Bugfixes

  • Add subscriptionsByProductIdentifier to CustomerInfo in typescript interface (#1072) via Toni Rico (@tonidero)

    📦 Dependency Updates

  • [AUTOMATIC] iOS 5.18.0 => 5.19.0 (#1074) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump fastlane-plugin-revenuecat_internal from 4ee8579 to 177d985 (#1070) via dependabot[bot] (@dependabot[bot])

13.22.0

RevenueCat SDK

✨ New Features

  • Add subscriptionsByProductIdentifier map of SubscriptionInfo by productId to CustomerInfo (#1067) via Toni Rico (@tonidero)
  • [EXTERNAL] feat(ios): expose showManageSubscriptions (#1064) by @dylancom (#1065) via Toni Rico (@tonidero)

🔄 Other Changes

  • Bump lefthook from 1.10.10 to 1.11.0 (#1056) via dependabot[bot] (@dependabot[bot])
  • Bump nokogiri from 1.17.1 to 1.18.3 (#1048) via dependabot[bot] (@dependabot[bot])

13.21.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] Android 8.12.2 => 8.13.0 (#1062) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • chore: Ignore idea caches (#1049) via Facundo Menzella (@facumenzella)

13.20.0

RevenueCatUI SDK

✨ New Features

  • feat: Introduce CustomerCenterProxy (#1046) via Facundo Menzella (@facumenzella)

13.19.0

RevenueCat SDK

📦 Dependency Updates

  • Version bump iOS 5.16.1 => 5.18.0, add PREPAID periodType, address iOS 18.4 build failures (#1054) via RevenueCat Git Bot (@RCGitBot)

13.18.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] Android 8.12.0 => 8.12.2 (#1044) via RevenueCat Git Bot (@RCGitBot)

13.18.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] Android 8.11.0 => 8.12.0 (#1041) via RevenueCat Git Bot (@RCGitBot)

13.17.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.16.0 => 5.16.1 (#1036) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Adds IntroEligibility to public API surface (#1037) via JayShortway (@JayShortway)

13.17.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.15.0 => 5.16.0 (#1034) via RevenueCat Git Bot (@RCGitBot)

13.16.2

RevenueCat SDK

🐞 Bugfixes

  • Import foundation in IOSAPIAvailabilityChecker (#1031) via Will Taylor (@fire-at-will)

🔄 Other Changes

  • Bump lefthook from 1.10.7 to 1.10.10 (#1022) via dependabot[bot] (@dependabot[bot])
  • [CI] Remove requirement for pod push to succeed to continue release process (#1030) via Toni Rico (@tonidero)

13.16.1

RevenueCat SDK

🐞 Bugfixes

  • Expose iOS PurchaseParamsBuilder API to KMP (#1028) via Will Taylor (@fire-at-will)

13.16.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.14.5 => 5.15.0 Android 8.10.8 => 8.11.0 (#1024) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Adds API availability check for enableAdServicesAttributionTokenCollection() (#1026) via JayShortway (@JayShortway)
  • Introduce IOSAPIAvailabilityChecker for KMP (#1008) via Will Taylor (@fire-at-will)

13.15.2

RevenueCat SDK

🐞 Bugfixes

  • Dismiss PaywallFragment after PaywallActivity is dismissed (#1016) via Toni Rico (@tonidero)

🔄 Other Changes

  • Bump lefthook from 1.10.4 to 1.10.7 (#1015) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.9.2 to 1.10.4 (#1012) via dependabot[bot] (@dependabot[bot])

13.15.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.14.0 => 5.14.5 Android 8.10.5 => 8.10.8 (#1010) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Expose storeError for iOS if any (#1011) via Toni Rico (@tonidero)

13.15.0

RevenueCat SDK

✨ New Features

  • Add parseAsWebPurchaseRedemption API to iOS (#1004) via Toni Rico (@tonidero)

🔄 Other Changes

  • Update docstring for diagnostics to clarify meaning (#1001) via Toni Rico (@tonidero)

13.14.0

RevenueCat SDK

✨ New Features

  • Add diagnostics support (#995) via Toni Rico (@tonidero)

13.13.1

RevenueCat SDK

🐞 Bugfixes

  • Updates Package.swift and Package.resolved (#997) via JayShortway (@JayShortway)

13.13.0

RevenueCat SDK

✨ New Features

  • Support Web Redemption Links (#987) via Toni Rico (@tonidero)

    🐞 Bugfixes

  • Add empty NSPrivacyCollectedDataTypes (#990) via Cesar de la Vega (@vegaro)

🔄 Other Changes

  • Bump fastlane from 2.225.0 to 2.226.0 (#984) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.8.4 to 1.9.2 (#986) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane-plugin-revenuecat_internal from 3b1e7cf to 4ee8579 (#985) via dependabot[bot] (@dependabot[bot])
  • Change dependency-update job to macos machine (#979) via Toni Rico (@tonidero)

13.12.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.12.0 => 5.12.1 (#980) via RevenueCat Git Bot (@RCGitBot)

13.11.0

RevenueCat SDK

✨ New Features

  • Expose fetching & redeeming win-backs on custom paywalls to hybrids (#968) via Will Taylor (@fire-at-will)

13.10.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.8.0 => 5.10.0 (#970) via Will Taylor (@fire-at-will)

🔄 Other Changes

  • Syncs version in Package.swift and Package.resolved with other iOS version files (#969) via JayShortway (@JayShortway)
  • Bump fastlane from 2.224.0 to 2.225.0 (#942) via dependabot[bot] (@dependabot[bot])

13.9.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] Android 8.10.1 => 8.10.2 (#962) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] iOS 5.7.1 => 5.8.0 Android 8.9.0 => 8.10.1 (#960) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump cocoapods from 1.15.2 to 1.16.2 (#957) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.8.1 to 1.8.2 (#953) via dependabot[bot] (@dependabot[bot])

13.8.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.7.0 => 5.7.1 Android 8.8.1 => 8.9.0 (#958) via RevenueCat Git Bot (@RCGitBot)

13.7.0

RevenueCat SDK

✨ New Features

  • Support SK win-back offer messages (#947) via Will Taylor (@fire-at-will)

    🐞 Bugfixes

  • Add Amazon freeTrialPeriod to introPrice (#952) via Cesar de la Vega (@vegaro)

    📦 Dependency Updates

  • [AUTOMATIC] iOS 5.6.0 => 5.7.0 (#946) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump danger from 9.5.0 to 9.5.1 (#943) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.7.18 to 1.8.1 (#945) via dependabot[bot] (@dependabot[bot])
  • Bump rexml from 3.3.8 to 3.3.9 (#948) via dependabot[bot] (@dependabot[bot])

13.6.0

RevenueCat SDK

✨ New Features

  • Adds Offerings.currentOfferingForPlacement() (#938) via JayShortway (@JayShortway)

13.5.1

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] Android 8.8.0 => 8.8.1 (#936) via RevenueCat Git Bot (@RCGitBot)

13.5.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.4.0 => 5.6.0 (#933) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump fastlane from 2.223.1 to 2.224.0 (#934) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane-plugin-revenuecat_internal from 5b2e35c to 3b1e7cf (#932) via dependabot[bot] (@dependabot[bot])
  • [CI] Fix update dependencies job to use correct labels (#930) via Toni Rico (@tonidero)

13.4.0

RevenueCat SDK

📦 Dependency Updates

  • [AUTOMATIC] iOS 5.3.4 => 5.4.0 Android 8.7.2 => 8.8.0 (#928) via RevenueCat Git Bot (@RCGitBot)

🔄 Other Changes

  • Bump lefthook from 1.7.17 to 1.7.18 (#929) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane from 2.222.0 to 2.223.1 (#927) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.7.15 to 1.7.17 (#926) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane-plugin-revenuecat_internal from 55a0455 to 5b2e35c (#925) via dependabot[bot] (@dependabot[bot])

13.3.0

RevenueCat SDK

✨ New Features

  • Support integration via Swift Package Manager (#922) via JayShortway (@JayShortway)

🔄 Other Changes

  • [AUTOMATIC] iOS 5.3.3 => 5.3.4 (#921) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from 5140dbc to 55a0455 (#920) via dependabot[bot] (@dependabot[bot])

13.2.1

Dependency Updates

  • Bump fastlane-plugin-revenuecat_internal from 85e1c83 to 5140dbc (#914) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • [AUTOMATIC] iOS 5.3.2 => 5.3.3 Android 8.7.1 => 8.7.2 (#918) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] iOS 5.3.1 => 5.3.2 Android 8.7.0 => 8.7.1 (#916) via RevenueCat Git Bot (@RCGitBot)

13.2.0

Dependency Updates

  • Bump lefthook from 1.7.14 to 1.7.15 (#912) via dependabot[bot] (@dependabot[bot])
  • [AUTOMATIC] iOS 5.3.0 => 5.3.1 (#909) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from 4c4b8ce to 85e1c83 (#901) via dependabot[bot] (@dependabot[bot])
  • [AUTOMATIC] Android 8.6.0 => 8.7.0 (#906) via RevenueCat Git Bot (@RCGitBot)
  • Bump rexml from 3.3.3 to 3.3.6 (#905) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Adds StoreProduct.priceAmount and StoreProductDiscount.priceAmount on iOS. (#911) via JayShortway (@JayShortway)

13.1.0

Dependency Updates

  • iOS 5.2.3 => 5.3.0 Android 8.4.0 => 8.6.0 (#903) via Toni Rico (@tonidero)
  • Bump lefthook from 1.7.12 to 1.7.14 (#899) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.6.18 to 1.7.12 (#896) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane-plugin-revenuecat_internal from d5f0742 to 4c4b8ce (#897) via dependabot[bot] (@dependabot[bot])
  • Bump rexml from 3.2.9 to 3.3.3 (#893) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • StoreKitVersion Docstring Typo Fix (#894) via Will Taylor (@fire-at-will)

13.0.1

Dependency Updates

  • [AUTOMATIC] iOS 5.2.2 => 5.2.3 Android 8.3.1 => 8.4.0 (#890) via RevenueCat Git Bot (@RCGitBot)
  • Bump danger from 9.4.3 to 9.5.0 (#888) via dependabot[bot] (@dependabot[bot])

13.0.0

Breaking Changes

  • Require STOREKIT_VERSION when PURCHASES_ARE_COMPLETED_BY is MY_APP (#884) via Will Taylor (@fire-at-will)

Dependency Updates

  • Bump fastlane from 2.221.1 to 2.222.0 (#880) via dependabot[bot] (@dependabot[bot])

12.0.0

Breaking Changes

  • Update Android to v8 of the native SDK (#859) via Toni Rico (@tonidero)
  • Update iOS to v5.2.2 of the native SDK (#858) via Will Taylor (@fire-at-will)

    New Features

  • add pricePerPeriod properties (#621) via Andy Boedo (@aboedo)
  • Amazon: Add getAmazonLWAConsentStatus method to support Quick Subscribe (#779) via Mark Villacampa (@MarkVillacampa)

    Dependency Updates

  • [AUTOMATIC] Android 8.3.0 => 8.3.1 (#878) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from 5f55466 to d5f0742 (#872) via dependabot[bot] (@dependabot[bot])
  • [AUTOMATIC] Android 8.2.0 => 8.3.0 (#869) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Fix typescript API tests (#860) via Toni Rico (@tonidero)

11.1.1

Bugfixes

  • Add DEFERRED to typescript enum (#854) via Toni Rico (@tonidero)

11.1.0

Dependency Updates

  • Bump Android 7.12.0 (#851) via Toni Rico (@tonidero)
  • [AUTOMATIC] iOS 4.43.1 => 4.43.2 (#849) via RevenueCat Git Bot (@RCGitBot)

11.0.0

Breaking Changes

  • purchasesAreCompletedBy. Remove observerMode. iOS 4.43.0 => 4.43.1 (#845) via RevenueCat Git Bot (@RCGitBot)

    Dependency Updates

  • Bump lefthook from 1.6.16 to 1.6.18 (#842) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane from 2.221.0 to 2.221.1 (#841) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Adds .aiexclude (#843) via JayShortway (@JayShortway)

10.10.0

New Features

  • Exposes PHC version (#838) via JayShortway (@JayShortway)

    Dependency Updates

  • Bump fastlane from 2.220.0 to 2.221.0 (#836) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane-plugin-revenuecat_internal from 8ec0072 to 5f55466 (#829) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.6.14 to 1.6.16 (#832) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Adds KMP to trigger-dependent-updates (#833) via JayShortway (@JayShortway)

10.9.0

Dependency Updates

  • [AUTOMATIC] iOS 4.42.0 => 4.43.0 Android 7.11.0 => 7.11.1 (#830) via RevenueCat Git Bot (@RCGitBot)

10.8.0

Dependency Updates

  • [AUTOMATIC] iOS 4.41.2 => 4.42.0 Android 7.10.1 => 7.11.0 (#826) via RevenueCat Git Bot (@RCGitBot)
  • Bump lefthook from 1.6.11 to 1.6.14 (#824) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.6.10 to 1.6.11 (#816) via dependabot[bot] (@dependabot[bot])
  • Bump rexml from 3.2.6 to 3.2.8 (#820) via dependabot[bot] (@dependabot[bot])

10.7.0

New Features

  • Add support for new OneSignal setOnesignalUserID method for OneSignal 11+ (#817) via Toni Rico (@tonidero)

10.6.2

Bugfixes

  • Add PrivacyInfo.xcprivacy (#814) via Cesar de la Vega (@vegaro)

    Dependency Updates

  • Bump fastlane-plugin-revenuecat_internal from dd5e21f to 8ec0072 (#812) via dependabot[bot] (@dependabot[bot])

10.6.1

Dependency Updates

  • [AUTOMATIC] iOS 4.41.1 => 4.41.2 (#810) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] Android 7.10.0 => 7.10.1 (#808) via RevenueCat Git Bot (@RCGitBot)

10.6.0

Dependency Updates

  • [AUTOMATIC] Android 7.9.0 => 7.10.0 (#806) via RevenueCat Git Bot (@RCGitBot)

10.5.1

Dependency Updates

  • [AUTOMATIC] iOS 4.41.0 => 4.41.1 (#804) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from f88dcd4 to dd5e21f (#802) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Add api-extractor to automate API tests (#796) via Toni Rico (@tonidero)

10.5.0

Dependency Updates

  • [AUTOMATIC] iOS 4.40.1 => 4.41.0 Android 7.8.2 => 7.9.0 (#800) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from 1e62420 to f88dcd4 (#798) via dependabot[bot] (@dependabot[bot])

10.4.2

Bugfixes

  • [EXTERNAL] fix(PaywallProxy): check if root view controller is already presenting (#792) via @MegaMaddin (#793) via Toni Rico (@tonidero)

    Dependency Updates

  • Bump fastlane-plugin-revenuecat_internal from 8d4d9b1 to 1e62420 (#791) via dependabot[bot] (@dependabot[bot])

10.4.1

Dependency Updates

  • Bump lefthook from 1.6.9 to 1.6.10 (#787) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.6.8 to 1.6.9 (#784) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.6.7 to 1.6.8 (#778) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Add shouldBlockTouchEvents optional property to presentPaywall methods (#789) via Toni Rico (@tonidero)

10.4.0

Dependency Updates

  • [AUTOMATIC] iOS 4.39.1 => 4.40.0 (#782) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane from 2.219.0 to 2.220.0 (#780) via dependabot[bot] (@dependabot[bot])

10.3.2

Dependency Updates

  • [AUTOMATIC] iOS 4.39.0 => 4.39.1 Android 7.8.0 => 7.8.1 (#776) via RevenueCat Git Bot (@RCGitBot)

10.3.1

Bugfixes

  • Fix compilation in xcode 14 (Swift 5.8) (#774) via Cesar de la Vega (@vegaro)

10.3.0

New Features

  • Add font support to presentPaywall (#769) via Cesar de la Vega (@vegaro)

    Dependency Updates

  • [AUTOMATIC] Android 7.7.2 => 7.8.0 (#770) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from 9c82c7a to 8d4d9b1 (#766) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.6.5 to 1.6.7 (#767) via dependabot[bot] (@dependabot[bot])

10.2.0

New Features

  • Add paywallViewControllerRequestedDismissal (#746) via Cesar de la Vega (@vegaro)

    Dependency Updates

  • [AUTOMATIC] iOS 4.38.1 => 4.39.0 Android 7.7.1 => 7.7.2 (#761) via RevenueCat Git Bot (@RCGitBot)

10.1.0

New Features

  • Fix revision type in PresentedOfferingTargetingContext context and add API testers (#759) via Josh Holtz (@joshdholtz)

    Other Changes

  • Update RELEASING.md (#757) via Cesar de la Vega (@vegaro)
  • Update CHANGELOG.md (#755) via Cesar de la Vega (@vegaro)

10.0.0

Breaking Changes

  • Add targeting placements and custom attributes (#748) via Josh Holtz (@joshdholtz)

9.9.0

Dependency Updates

  • [AUTOMATIC] Android 7.6.0 => 7.7.1 (#751) via RevenueCat Git Bot (@RCGitBot)
  • Bump lefthook from 1.6.4 to 1.6.5 (#749) via dependabot[bot] (@dependabot[bot])
  • Bump lefthook from 1.6.1 to 1.6.4 (#745) via dependabot[bot] (@dependabot[bot])

9.8.0

New Features

  • Add didStartRestore (#734) via Cesar de la Vega (@vegaro)
  • Add didStartPurchaseWithPackage (#735) via Cesar de la Vega (@vegaro)

    Dependency Updates

  • [AUTOMATIC] iOS 4.36.3 => 4.37.0 Android 7.5.2 => 7.6.0 (#738) via RevenueCat Git Bot (@RCGitBot)

9.7.2

Dependency Updates

  • [AUTOMATIC] iOS 4.36.2 => 4.36.3 Android 7.5.1 => 7.5.2 (#736) via RevenueCat Git Bot (@RCGitBot)

9.7.1

Dependency Updates

  • [AUTOMATIC] iOS 4.36.1 => 4.36.2 (#731) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Add lanes to trigger dependency updates and bump (#729) via Cesar de la Vega (@vegaro)

9.7.0

New Features

  • Add paywallViewControllerDidStartPurchase to wrapper delegate (#725) via Cesar de la Vega (@vegaro)

    Bugfixes

  • Set delegate for PaywallViewController (#724) via Cesar de la Vega (@vegaro)

    Dependency Updates

  • [AUTOMATIC] iOS 4.35.0 => 4.36.1 Android 7.5.0 => 7.5.1 (#728) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.15.1 to 1.15.2 (#722) via dependabot[bot] (@dependabot[bot])

9.6.0

New Features

  • Add PaywallViewControllerDelegateWrapper (#706) via Cesar de la Vega (@vegaro)

    Dependency Updates

  • [AUTOMATIC] Android 7.4.1 => 7.5.0 (#720) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.15.0 to 1.15.1 (#715) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • PurchasesHybridCommon.podspec: remove SwiftUI dependency (#718) via NachoSoto (@NachoSoto)

9.5.0

RevenueCatUI

  • [AUTOMATIC] iOS 4.34.0 => 4.35.0 (#713) via RevenueCat Git Bot (@RCGitBot)

    Dependency Updates

  • Bump danger from 9.4.2 to 9.4.3 (#711) via dependabot[bot] (@dependabot[bot])
  • [AUTOMATIC] iOS 4.33.0 => 4.34.0 (#707) via RevenueCat Git Bot (@RCGitBot)

9.4.0

New Features

  • Create PaywallListenerWrapper and expose mappers (#704) via Cesar de la Vega (@vegaro)

9.3.0

New Features

  • Add support for visionOS (#700) via NachoSoto (@NachoSoto)

    Dependency Updates

  • [AUTOMATIC] iOS 4.32.3 => 4.33.0 Android 7.4.0 => 7.4.1 (#701) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.14.3 to 1.15.0 (#694) via dependabot[bot] (@dependabot[bot])

9.2.1

Dependency Updates

  • [AUTOMATIC] iOS 4.32.2 => 4.32.3 (#693) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from e6ba247 to 9c82c7a (#695) via dependabot[bot] (@dependabot[bot])

9.2.0

New Features

  • MakePurchaseResult: added transaction (#690) via NachoSoto (@NachoSoto)

9.1.0

New Features

  • Common: purchase methods also return StoreTransaction (#686) via NachoSoto (@NachoSoto)
  • CommonFunctionality: purchase methods also return StoreTransaction (#685) via NachoSoto (@NachoSoto)

    Dependency Updates

  • [AUTOMATIC] Android 7.3.5 => 7.4.0 (#688) via RevenueCat Git Bot (@RCGitBot)

9.0.1

Dependency Updates

  • [AUTOMATIC] iOS 4.32.1 => 4.32.2 (#683) via RevenueCat Git Bot (@RCGitBot)
  • Bump lefthook from 1.6.0 to 1.6.1 (#681) via dependabot[bot] (@dependabot[bot])

9.0.0

Breaking Changes

  • Separate PurchasesHybridCommonUI (#672) via NachoSoto (@NachoSoto)

    Other Changes

  • CircleCI: don't skip major bumps (#679) via NachoSoto (@NachoSoto)

8.12.0

RevenueCatUI

  • Paywalls: add methods for presenting paywalls with an offering identifier (Android) (#670) via Cesar de la Vega (@vegaro)
  • Paywalls: add methods for presenting paywalls with an offering identifier (iOS) (#675) via NachoSoto (@NachoSoto)

    Dependency Updates

  • [AUTOMATIC] iOS 4.32.0 => 4.32.1 (#674) via RevenueCat Git Bot (@RCGitBot)
  • Bump lefthook from 1.5.7 to 1.6.0 (#671) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Update Android orb (#669) via Cesar de la Vega (@vegaro)

8.11.2

RevenueCatUI

  • Fix getting rootViewController (#667) via Cesar de la Vega (@vegaro)

    Other Changes

  • CircleCI: change jobs to use Apple Silicon (#665) via NachoSoto (@NachoSoto)
  • Fix stable-release-tags filter in config.yaml (#664) via Cesar de la Vega (@vegaro)

8.11.1

Dependency Updates

  • [AUTOMATIC] Android 7.3.4 => 7.3.5 (#662) via RevenueCat Git Bot (@RCGitBot)

8.11.0

RevenueCatUI

  • Paywalls: fix UIApplication.keyWindow deprecation warning (#656) via NachoSoto (@NachoSoto)

    Dependency Updates

  • [AUTOMATIC] iOS 4.31.9 => 4.32.0 Android 7.3.3 => 7.3.4 (#660) via RevenueCat Git Bot (@RCGitBot)
  • Bump lefthook from 1.5.6 to 1.5.7 (#658) via dependabot[bot] (@dependabot[bot])

8.10.1

Dependency Updates

  • [AUTOMATIC] iOS 4.31.8 => 4.31.9 Android 7.3.2 => 7.3.3 (#653) via RevenueCat Git Bot (@RCGitBot)
  • Bump lefthook from 1.5.5 to 1.5.6 (#651) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Fix update native versions job after hybrid common android split (#652) via Toni Rico (@tonidero)
  • Update fastlane internal plugin (#650) via Toni Rico (@tonidero)

8.10.0

RevenueCatUI

  • RevenueCatUI (#647) via NachoSoto (@NachoSoto)

    Dependency Updates

  • [AUTOMATIC] iOS 4.31.7 => 4.31.8 (#645) via RevenueCat Git Bot (@RCGitBot)

    8.2.2

    Dependency Updates

  • [AUTOMATIC] iOS 4.31.6 => 4.31.7 (#640) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] Android 7.3.1 => 7.3.2 (#632) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane from 2.218.0 to 2.219.0 (#629) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane from 2.217.0 to 2.218.0 (#626) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Add lefthook to configure a pre-push hook that runs detekt (#615) via Cesar de la Vega (@vegaro)

8.2.1

Dependency Updates

  • [AUTOMATIC] Android 7.3.0 => 7.3.1 (#618) via RevenueCat Git Bot (@RCGitBot)

8.2.0

Dependency Updates

  • [AUTOMATIC] iOS 4.31.5 => 4.31.6 Android 7.2.8 => 7.3.0 (#613) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] iOS 4.31.4 => 4.31.5 (#599) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Trim version file contents (#607) via Toni Rico (@tonidero)

8.1.2

Dependency Updates

  • [AUTOMATIC] iOS 4.31.2 => 4.31.4 Android 7.2.7 => 7.2.8 (#596) via RevenueCat Git Bot (@RCGitBot)
  • Bump danger from 9.4.1 to 9.4.2 (#594) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Merge dependency-update workflows and fix automatic-release being triggered when executing action (#591) via Cesar de la Vega (@vegaro)

8.1.1

Dependency Updates

  • [AUTOMATIC] iOS 4.31.1 => 4.31.2 Android 7.2.6 => 7.2.7 (#588) via RevenueCat Git Bot (@RCGitBot)
  • Bump danger from 9.4.0 to 9.4.1 (#583) via dependabot[bot] (@dependabot[bot])

8.1.0

Dependency Updates

  • [AUTOMATIC] iOS 4.30.5 => 4.31.1 Android 7.2.4 => 7.2.6 (#584) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.14.2 to 1.14.3 (#576) via dependabot[bot] (@dependabot[bot])

8.0.0

Breaking Changes

  • Fix entitlement verification name typo (#574) via Toni Rico (@tonidero)

    Bugfixes

  • Fix breaking change in objc in 7.4.0 (#572) via Toni Rico (@tonidero)

    Dependency Updates

  • [AUTOMATIC] Android 7.2.3 => 7.2.4 (#573) via RevenueCat Git Bot (@RCGitBot)

7.4.0

New Features

  • Trusted Entitlements: Add verification field to EntitlementInfo and EntitlementInfos (#569) via Toni Rico (@tonidero)
  • Trusted Entitlements: add support for setting VerificationMode (#451) via NachoSoto (@NachoSoto)

    Dependency Updates

  • Bump fastlane from 2.216.0 to 2.217.0 (#566) via dependabot[bot] (@dependabot[bot])
  • Bump danger from 9.3.2 to 9.4.0 (#565) via dependabot[bot] (@dependabot[bot])

7.3.3

Dependency Updates

  • [AUTOMATIC] iOS 4.30.4 => 4.30.5 (#562) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] Android 7.2.2 => 7.2.3 (#560) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Improve circleci deploy automation (#559) via Toni Rico (@tonidero)
  • Fix deploy android circleci job (#558) via Toni Rico (@tonidero)

7.3.2

Dependency Updates

  • [AUTOMATIC] Android 7.2.1 => 7.2.2 (#556) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Android: bump gradle version (#552) via NachoSoto (@NachoSoto)

7.3.1

Dependency Updates

  • [AUTOMATIC] iOS 4.30.2 => 4.30.4 Android 7.2.0 => 7.2.1 (#550) via RevenueCat Git Bot (@RCGitBot)

7.3.0

Dependency Updates

  • [AUTOMATIC] iOS 4.29.0 => 4.30.2 Android 7.0.1 => 7.2.0 (#546) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from a297205 to 0ddee10 (#541) via dependabot[bot] (@dependabot[bot])

7.2.0

Dependency Updates

  • [AUTOMATIC] iOS 4.28.1 => 4.29.0 (#539) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.14.0 to 1.14.2 (#537) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Use RevenueCat orb for bundle install cache (#536) via Josh Holtz (@joshdholtz)

7.1.1

Dependency Updates

  • [AUTOMATIC] iOS 4.28.0 => 4.28.1 (#532) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.13.0 to 1.14.0 (#533) via dependabot[bot] (@dependabot[bot])

7.1.0

New Features

  • Add product_plan_identifier to EntitlementInfo in iOS (#528) via Toni Rico (@tonidero)

    Dependency Updates

  • [AUTOMATIC] iOS 4.27.2 => 4.28.0 Android 7.0.0 => 7.0.1 (#526) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] iOS 4.27.0 => 4.27.2 (#524) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Improve breaking changes changelog for 7.0 (#523) via Toni Rico (@tonidero)

7.0.0

Breaking Changes

  • Add in app messages API support (#510) via Toni Rico (@tonidero)
    • This may cause in-app billing messages to start showing automatically in Android (this was already the behavior in iOS). To disable this behavior, change the shouldShowInAppMessagesAutomatically property during SDK configuration
  • Temporarily remode DEFERRED proration mode in preparation for upgrade to Billing Client 6 (#506) via Mark Villacampa (@MarkVillacampa)
    • If you use DEFERRED proration mode, you should not upgrade to this version of the SDK yet, you should wait until support is re-added in a future version.
  • Update android to 7.0 (#520) via Toni Rico (@tonidero)
    • This new version of the Android SDK uses Google's Billing Client 6. In case you're using observer mode and are using BC6, you need to upgrade to this version of the SDK.
    • This version moves our minSdk in android from API 14 to 19.

      Dependency Updates

  • [AUTOMATIC] iOS 4.26.1 => 4.27.0 (#519) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.12.1 to 1.13.0 (#505) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane from 2.215.1 to 2.216.0 (#503) via dependabot[bot] (@dependabot[bot])
  • Bump danger from 9.3.1 to 9.3.2 (#502) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • CI: run iOS 17 tests (#521) via NachoSoto (@NachoSoto)
  • URL(string:): add clarifying comment (#511) via Andy Boedo (@aboedo)
  • Add documentation for productType field in StoreProduct in typescript (#515) via Toni Rico (@tonidero)

6.3.2

Dependency Updates

  • Bump android to 6.9.7

6.3.1

Dependency Updates

  • Bump android to 6.9.6 (#708) via Toni Rico (@tonidero)

6.3.0

New Features

  • Add product type to typescript types (#507) via Cesar de la Vega (@vegaro)

    Bugfixes

  • Add product_plan_identifier to EntitlementInfo model (#512) via Toni Rico (@tonidero)

    Dependency Updates

  • [AUTOMATIC] iOS 4.26.0 => 4.26.1 Android 6.9.4 => 6.9.5 (#504) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • fix proxyURL not crashing if invalid url is passed (#508) via Andy Boedo (@aboedo)

6.2.0

Dependency Updates

  • Bump fastlane from 2.214.0 to 2.215.1 (#500) via dependabot[bot] (@dependabot[bot])
  • [AUTOMATIC] iOS 4.25.10 => 4.26.0 (#498) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Trigger automatic PHC updates in Capacitor plugin (#497) via Toni Rico (@tonidero)

6.1.3

Dependency Updates

  • [AUTOMATIC] iOS 4.25.9 => 4.25.10 (#495) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Support deploying separate ESNext typescript package (#494) via Toni Rico (@tonidero)

6.1.2

Dependency Updates

  • [AUTOMATIC] iOS 4.25.8 => 4.25.9 (#492) via RevenueCat Git Bot (@RCGitBot)

6.1.1

Dependency Updates

  • [AUTOMATIC] iOS 4.25.7 => 4.25.8 Android 6.9.3 => 6.9.4 (#489) via RevenueCat Git Bot (@RCGitBot)

6.1.0

New Features

  • Expose CommonFunctionality.encode(customerInfo:) (#487) via NachoSoto (@NachoSoto)

6.0.0

Breaking Changes

  • Changed iOS HybridAdditions to internal (#485) via NachoSoto (@NachoSoto)

    Dependency Updates

  • Bump fastlane-plugin-revenuecat_internal from b2108fb to a297205 (#483) via dependabot[bot] (@dependabot[bot])

    5.6.4

    Dependency Updates

  • [AUTOMATIC] iOS 4.25.6 => 4.25.7 Android 6.9.2 => 6.9.3 (#481) via RevenueCat Git Bot (@RCGitBot)
  • Bump activesupport from 7.0.4.3 to 7.0.7.2 (#479) via dependabot[bot] (@dependabot[bot])

5.6.3

Dependency Updates

  • [AUTOMATIC] Android 6.9.1 => 6.9.2 (#477) via RevenueCat Git Bot (@RCGitBot)

5.6.2

Dependency Updates

  • [AUTOMATIC] iOS 4.25.4 => 4.25.6 (#475) via RevenueCat Git Bot (@RCGitBot)

5.6.1

Dependency Updates

  • [AUTOMATIC] iOS 4.25.2 => 4.25.4 Android 6.9.0 => 6.9.1 (#473) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • re-enable job to update PHC in unity (#472) via Mark Villacampa (@MarkVillacampa)
  • Improvements typescript interfaces (#471) via Toni Rico (@tonidero)

5.6.0

Dependency Updates

  • [AUTOMATIC] Android 6.8.0 => 6.9.0 (#469) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Add API tests to typescript interfaces (#459) via Toni Rico (@tonidero)
  • Move typescript interfaces to PHC (#455) via Toni Rico (@tonidero)

5.5.0

Dependency Updates

  • [AUTOMATIC] iOS 4.25.1 => 4.25.2 Android 6.7.0 => 6.8.0 (#466) via RevenueCat Git Bot (@RCGitBot)

5.4.1

Dependency Updates

  • [AUTOMATIC] iOS 4.25.0 => 4.25.1 (#464) via RevenueCat Git Bot (@RCGitBot)

5.4.0

Dependency Updates

  • [AUTOMATIC] iOS 4.24.1 => 4.25.0 Android 6.5.2 => 6.7.0 (#460) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane from 2.213.0 to 2.214.0 (#461) via dependabot[bot] (@dependabot[bot])

5.3.0

Dependency Updates

  • [AUTOMATIC] iOS 4.23.1 => 4.24.1 (#457) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Remove latestDependencies variant (#445) via Cesar de la Vega (@vegaro)

5.2.4

Bugfixes

  • Fix free trial and intro price to derive from defaultOption (#449) via Josh Holtz (@joshdholtz)

    Other Changes

  • .composite-enable: fixed file reference (#450) via NachoSoto (@NachoSoto)
  • CI: wait until pods have been pushed to trigger dependent updates (#448) via Mark Villacampa (@MarkVillacampa)

5.2.3

Bugfixes

  • Android: retrieve free trial period from the free phase (#446) via Mark Villacampa (@MarkVillacampa)

    Dependency Updates

  • Bump fastlane-plugin-revenuecat_internal from 13773d2 to b2108fb (#443) via dependabot[bot] (@dependabot[bot])

5.2.2

Dependency Updates

  • [AUTOMATIC] Android 6.5.1 => 6.5.2 (#440) via RevenueCat Git Bot (@RCGitBot)

5.2.1

Dependency Updates

  • [AUTOMATIC] iOS 4.23.0 => 4.23.1 (#438) via RevenueCat Git Bot (@RCGitBot)

5.2.0

Dependency Updates

  • [AUTOMATIC] iOS 4.22.0 => 4.23.0 Android 6.5.0 => 6.5.1 (#435) via RevenueCat Git Bot (@RCGitBot)

5.1.0

Dependency Updates

  • [AUTOMATIC] iOS 4.21.0 => 4.22.0 Android 6.4.0 => 6.5.0 (#433) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Add Detekt linter to android codebase (#431) via Toni Rico (@tonidero)

5.0.0

RevenueCat Purchases Hybrid Common v5 is here!! 😻

This latest release updates the Android SDK dependency from v5 to v6 to use BillingClient 5. This version of BillingClient brings an entire new subscription model which has resulted in large changes across the entire SDK.

Migration Guides

  • See Android Native - 5.x to 6.x Migration for a more thorough explanation of the new Google subscription model announced with BillingClient 5 and how to take advantage of it in V6. This guide includes tips on product setup with the new model.

New SubscriptionOption concept

Purchasing

In v4, a Google Play Android Package or StoreProduct represented a single purchaseable entity, and free trials or intro offers would automatically be applied to the purchase if the user was eligible.

Now, in Hybrid Common v5, an Google Play Android Package or StoreProduct represents a duration of a subscription and contains all the ways to purchase that duration -- any offers and its base plan. Each of these purchase options are SubscriptionOptions. When passing a Package to purchasePackage() or StoreProduct to purchaseStoreProduct(), the SDK will use the following logic to choose which SubscriptionOption to purchase:

  • Filters out offers with "rc-ignore-offer" tag
  • Uses SubscriptionOption with the longest free trial or cheapest first phase
    • Only offers the user is eligible will be applied
  • Falls back to base plan

For more control, purchase subscription options with the new purchaseSubscriptionOption() method.

Models

StoreProduct now has a few new properties use for Google Play Android:

  • defaultOption
    • A subscription option that will automatically be applie when purchasing a Package or StoreProduct
  • subscriptionOptions
    • A list of subscription options (could be null)
Subscription Option

Below is an example of what a subscription option:

{
    "id": "basePlan",
    "storeProductId": "subId:basePlanId",
    "productId": "subId",
    "pricingPhases": [
        {
            "price": 0,
            "priceString": "FREE",
            "period": "P1M",
            "cycles": 1
        },
        {
            "price": 4.99,
            "priceString": "$4.99",
            "period": "P1M",
            "cycles": 0
        }
    ],
    "tags": ["free-offers"],
    "isBasePlan": false,
    "billingPeriod": {
        "periodUnit": "MONTH",
        "periodNumberOfUnits": 0
    },
    "isPrepaid": false,
    "fullPricePhase": {
        "price": 4.99,
        "priceString": "$4.99",
        "period": "P1M",
        "cycles": 0
    },
    "freePhase" {
        "price": 0,
        "priceString": "FREE",
        "period": "P1M",
        "cycles": 1
    },
    "introPhase": null
}

Observer Mode

Observer mode is still supported in v5. Other than updating the SDK version, there are no changes required.

Offline Entitlements

✨ With this new feature, even if our main and backup servers are down, the SDK can continue to process purchases. This is enabled transparently to the user, and when the servers come back online, the SDK automatically syncs the information so it can be visible in the dashboard.

Offering Metadata

✨ Metadata allows attaching arbitrary information as key/value pairs to your Offering to control how to display your products inside your app. The metadata you configure in an Offering is available from the RevenueCat SDK. For example, you could use it to remotely configure strings on your paywall, or even URLs of images shown on the paywall.

See the metadata documentation for more info!

5.0.0-rc.1

New Features

  • Add offering metadata (#419) via Josh Holtz (@joshdholtz)

5.0.0-beta.6

Breaking Changes

  • Reverted breaking change for productType on StoreProduct mapper (#386) via Josh Holtz (@joshdholtz)

    New Features

  • Add productCategory support in getProductInfo() and purchaseProduct() (#387) via Josh Holtz (@joshdholtz)

5.0.0-beta.5

Breaking Changes

  • iOS rename productCategory to product type and productType to productSubtype (#377) via Josh Holtz (@joshdholtz)
  • Android rename productCategory to productType and productType to productSubtype (#376) via Josh Holtz (@joshdholtz)

    Other Changes

  • Use new mapped product type values for purchaseProduct() and getProductInfo() (#384) via Josh Holtz (@joshdholtz)

5.0.0-beta.4

Bugfixes

  • Add platform check,OfferPaymentMode, and presentedOfferingIdentifier (#371) via Josh Holtz (@joshdholtz)

5.0.0-beta.3

Breaking Changes

  • [BC5] Use Int for Google proration mode to make mapping logic to GoogleProrationMode reusable (#368) via Josh Holtz (@joshdholtz)

    New Features

  • [BC5] Add iso8601 to Period for subscription option pricing phases (#369) via Josh Holtz (@joshdholtz)

5.0.0-beta.2

Breaking Changes

  • [BC5] Rename Period fields to unit and value (#365) via Josh Holtz (@joshdholtz)

    Bug Fixes

  • [BC5] Fix purchaseProduct to work with productIdentifiers with base plans (#366) via Josh Holtz (@joshdholtz)

5.0.0-beta.1

The first beta of RevenueCat Purchases Hybrid Common v5 is here!! 😻

This latest release updates the Android SDK dependency from v5 to v6 to use BillingClient 5. This version of BillingClient brings an entire new subscription model which has resulted in large changes across the entire SDK.

Migration Guides

  • See Android Native - 5.x to 6.x Migration for a more thorough explanation of the new Google subscription model announced with BillingClient 5 and how to take advantage of it in V6. This guide includes tips on product setup with the new model.

New SubscriptionOption concept

Purchasing

In v4, a Google Play Android Package or StoreProduct represented a single purchaseable entity, and free trials or intro offers would automatically be applied to the purchase if the user was eligible.

Now, in Hybrid Common v5, an Google Play Android Package or StoreProduct represents a duration of a subscription and contains all the ways to purchase that duration -- any offers and its base plan. Each of these purchase options are SubscriptionOptions. When passing a Package to purchasePackage() or StoreProduct to purchaseStoreProduct(), the SDK will use the following logic to choose which SubscriptionOption to purchase:

  • Filters out offers with "rc-ignore-offer" tag
  • Uses SubscriptionOption with the longest free trial or cheapest first phase
    • Only offers the user is eligible will be applied
  • Falls back to base plan

For more control, purchase subscription options with the new purchaseSubscriptionOption() method.

Models

StoreProduct now has a few new properties use for Google Play Android:

  • defaultOption
    • A subscription option that will automatically be applie when purchasing a Package or StoreProduct
  • subscriptionOptions
    • A list of subscription options (could be null)
Subscription Option

Below is an example of what a subscription option:

{
    "id": "basePlan",
    "storeProductId": "subId:basePlanId",
    "productId": "subId",
    "pricingPhases": [
        {
            "price": 0,
            "priceString": "FREE",
            "period": "P1M",
            "cycles": 1
        },
        {
            "price": 4.99,
            "priceString": "$4.99",
            "period": "P1M",
            "cycles": 0
        }
    ],
    "tags": ["free-offers"],
    "isBasePlan": false,
    "billingPeriod": {
        "periodUnit": "MONTH",
        "periodNumberOfUnits": 0
    },
    "fullPricePhase": {
        "price": 4.99,
        "priceString": "$4.99",
        "period": "P1M",
        "cycles": 0
    },
    "freePhase" {
        "price": 0,
        "priceString": "FREE",
        "period": "P1M",
        "cycles": 1
    },
    "introPhase": null
}

Observer Mode

Observer mode is still supported in v5. Other than updating the SDK version, there are no changes required.

4.18.0

Dependency Updates

  • [AUTOMATIC] iOS 4.20.0 => 4.21.0 (#420) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Makes pushing to Cocoapods its own job (#417) via Cesar de la Vega (@vegaro)

4.17.0

New Features

  • Add metadata to offering for iOS (#415) via Josh Holtz (@joshdholtz)
  • Remove watchOS as a supported platform (#411) via NachoSoto (@NachoSoto)

    Dependency Updates

  • [AUTOMATIC] iOS 4.19.0 => 4.20.0 (#409) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane from 2.212.2 to 2.213.0 (#407) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • CI: changed Xcode 13 job to 13.4 (#410) via NachoSoto (@NachoSoto)
  • Xcode 14.3: fixed warning (#405) via NachoSoto (@NachoSoto)

4.16.0

Dependency Updates

  • [AUTOMATIC] iOS 4.18.0 => 4.19.0 (#404) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from fe45299 to 13773d2 (#402) via dependabot[bot] (@dependabot[bot])

4.15.0

Dependency Updates

  • [AUTOMATIC] iOS 4.17.11 => 4.18.0 (#400) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-revenuecat_internal from 8482a43 to fe4529988aa6dd9ec1d507950416091302e6f56e (#392) via dependabot[bot] (@dependabot[bot])
  • Bump danger from 9.2.0 to 9.3.0 (#397) via dependabot[bot] (@dependabot[bot])

4.14.3

Dependency Updates

  • [AUTOMATIC] iOS 4.17.10 => 4.17.11 (#394) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.12.0 to 1.12.1 (#393) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane from 2.212.1 to 2.212.2 (#391) via dependabot[bot] (@dependabot[bot])
  • [AUTOMATIC] iOS 4.17.9 => 4.17.10 (#389) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Bump fastlane-plugin-revenuecat_internal from 9255366 to 8482a43 (#375) via dependabot[bot] (@dependabot[bot])

4.14.2

Dependency Updates

  • [AUTOMATIC] iOS 4.17.8 => 4.17.9 (#379) via RevenueCat Git Bot (@RCGitBot)
  • Bump activesupport from 7.0.4.2 to 7.0.4.3 (#360) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • CommonFunctionality.beginRefundRequest: available on Catalyst (#374) via NachoSoto (@NachoSoto)

4.14.1

Dependency Updates

  • [AUTOMATIC] iOS 4.17.7 => 4.17.8 (#361) via RevenueCat Git Bot (@RCGitBot)

4.14.0

Dependency Updates

  • [AUTOMATIC] Android 5.8.0 => 5.8.2 (#353) via RevenueCat Git Bot (@RCGitBot)
  • [AUTOMATIC] Android 5.7.1 => 5.8.0 (#351) via RevenueCat Git Bot (@RCGitBot)
  • Bump cocoapods from 1.11.3 to 1.12.0 (#344) via dependabot[bot] (@dependabot[bot])

4.13.5

Bugfixes

  • EntitlementInfo: fixed unsubscribeDetectedAt typo (#345) via NachoSoto (@NachoSoto)

    Other Changes

  • CommonFunctionality.setLogHandler: fixed docstring warning (#346) via NachoSoto (@NachoSoto)
  • Bump fastlane from 2.212.0 to 2.212.1 (#343) via dependabot[bot] (@dependabot[bot])

4.13.4

Dependency Updates

  • [AUTOMATIC] iOS 4.17.6 => 4.17.7 (#341) via RevenueCat Git Bot (@RCGitBot)

4.13.3

Bugfixes

  • Send unsupported error for versions of iOS incompatible with discounts instead of nil (#338) via Cesar de la Vega (@vegaro)

4.13.2

Dependency Updates

  • [AUTOMATIC] iOS 4.17.5 => 4.17.6 (#333) via RevenueCat Git Bot (@RCGitBot)
  • Bump fastlane-plugin-versioning_android from 0.1.0 to 0.1.1 (#332) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane from 2.211.0 to 2.212.0 (#334) via dependabot[bot] (@dependabot[bot])

4.13.1

Dependency Updates

  • [AUTOMATIC] iOS 4.17.4 => 4.17.5 Android 5.7.0 => 5.7.1 (#330) via RevenueCat Git Bot (@RCGitBot)

4.13.0

New Features

  • Add setLogHandlerWithOnResult (#328) via Cesar de la Vega (@vegaro)

    Dependency Updates

  • Bump fastlane-plugin-revenuecat_internal from 738f255 to 9255366 (#323) via dependabot[bot] (@dependabot[bot])

4.12.1

Dependency Updates

  • [AUTOMATIC] iOS 4.17.3 => 4.17.4 (#322) via RevenueCat Git Bot (@RCGitBot)
  • Bump git from 1.12.0 to 1.13.1 (#318) via dependabot[bot] (@dependabot[bot])
  • Bump danger from 8.6.1 to 9.2.0 (#320) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane-plugin-revenuecat_internal from 92650e4 to 738f255 (#319) via dependabot[bot] (@dependabot[bot])
  • Bump fastlane from 2.210.1 to 2.211.0 (#321) via dependabot[bot] (@dependabot[bot])
  • Bump activesupport from 6.1.6.1 to 6.1.7.2 (#317) via dependabot[bot] (@dependabot[bot])

    Other Changes

  • Fix for dependabot issue parsing Gemfile (#316) via Cesar de la Vega (@vegaro)
  • Update dependabot.yml package system (#314) via Cesar de la Vega (@vegaro)
  • Create dependabot.yml to automatically update Gemfile (#312) via Cesar de la Vega (@vegaro)

4.12.0

New Features

  • Adds setLogHandler (#307) via Cesar de la Vega (@vegaro)

4.11.0

New Features

  • Android: added CommonKt.setLogLevel (#301) via NachoSoto (@NachoSoto)

    Dependency Updates

  • [AUTOMATIC] iOS 4.17.2 => 4.17.3 Android 5.6.7 => 5.7.0 (#305) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • DEVELOPMENT.md: added section for pointing to local purchases-android (#303) via NachoSoto (@NachoSoto)
  • Upgrade AGP to 7.4.0 (#302) via Cesar de la Vega (@vegaro)

4.10.0

New Features

  • Added CommonFunctionality.setLogLevel (#297) via NachoSoto (@NachoSoto)

4.9.0

Dependency Updates

  • [AUTOMATIC] iOS 4.16.0 => 4.17.2 Android 5.6.6 => 5.6.7 (#298) via RevenueCat Git Bot (@RCGitBot)

    Other Changes

  • Update Gemfile.lock (#296) via Cesar de la Vega (@vegaro)

4.8.0

New Features

  • Add beginRefundRequest APIs in iOS (#290) via Toni Rico (@tonidero)

    Other Changes

  • CommonFunctionality.sharedInstance: changed type to PurchasesType & PurchasesSwiftType (#294) via NachoSoto (@NachoSoto)
  • Update secring (#293) via Cesar de la Vega (@vegaro)

4.7.0

New Features

  • Adds subscriptionPeriod (#286) via Cesar de la Vega (@vegaro)

    Other Changes

  • Add StoreProduct mapper iOS tests (#285) via Cesar de la Vega (@vegaro)

4.6.0

Other Changes

  • [AUTOMATIC] iOS 4.15.5 => 4.16.0 (#289) via RevenueCat Git Bot (@RCGitBot)
  • Fix warnings when running pod install (#288) via Cesar de la Vega (@vegaro)
  • Add StoreProduct Android Tests (#284) via Cesar de la Vega (@vegaro)
  • Update fastlane-plugin-revenuecat_internal to latest version (#287) via Cesar de la Vega (@vegaro)
  • Renames SKProduct and SKProductDiscount HybridAdditions files (#283) via Cesar de la Vega (@vegaro)

4.5.4

Other Changes

  • [AUTOMATIC] iOS 4.15.4 => 4.15.5 (#281) via RevenueCat Git Bot (@RCGitBot)

4.5.3

Other Changes

  • [AUTOMATIC] iOS 4.15.3 => 4.15.4 (#278) via RevenueCat Git Bot (@RCGitBot)
  • Integration Tests: enabled receipt fetch retry mechanism (#279) via NachoSoto (@NachoSoto)

4.5.2

Other Changes

  • [AUTOMATIC] iOS 4.15.2 => 4.15.3 Android 5.6.5 => 5.6.6 (#276) via RevenueCat Git Bot (@RCGitBot)

4.5.1

Other Changes

  • [AUTOMATIC] iOS 4.15.0 => 4.15.2 (#274) via RevenueCat Git Bot (@RCGitBot)

4.5.0

Other Changes

  • [AUTOMATIC] iOS 4.14.3 => 4.15.0 (#272) via RevenueCat Git Bot (@RCGitBot)

4.4.4

Other Changes

  • [AUTOMATIC] iOS 4.14.2 => 4.14.3 (#270) via RevenueCat Git Bot (@RCGitBot)

4.4.3

Other Changes

  • [AUTOMATIC] Android 5.6.4 => 5.6.5 (#268) via RevenueCat Git Bot (@RCGitBot)

4.4.2

Other Changes

  • [AUTOMATIC] iOS 4.14.1 => 4.14.2 (#266) via RevenueCat Git Bot (@RCGitBot)

4.4.1

Other Changes

  • [AUTOMATIC] iOS 4.14.0 => 4.14.1 Android 5.6.3 => 5.6.4 (#264) via RevenueCat Git Bot (@RCGitBot)

4.4.0

Other Changes

  • [AUTOMATIC] iOS 4.13.4 => 4.14.0 (#262) via RevenueCat Git Bot (@RCGitBot)
  • CI: added Xcode 13.2 job (#256) via NachoSoto (@NachoSoto)
  • Update fastlane-plugin-revenuecat_internal (#261) via Cesar de la Vega (@vegaro)

4.3.6

Other Changes

  • [AUTOMATIC] iOS 4.13.2 => 4.13.4 (#259) via RevenueCat Git Bot (@RCGitBot)
  • Adds missing repositories to trigger-dependent-updates workflow (#248) via Cesar de la Vega (@vegaro)

4.3.5

Other Changes

  • Updated SnapshotTesting to 1.10.0 (#231) via NachoSoto (@NachoSoto)
  • CI: using Xcode 14.1 (#232) via NachoSoto (@NachoSoto)

4.3.4

Other Changes

  • [AUTOMATIC] Android 5.6.2 => 5.6.3 (#254) via RevenueCat Git Bot (@RCGitBot)

4.3.3

Bugfixes

  • re-add error message if SDK hasn't been configured (#253) via Andy Boedo (@aboedo)

4.3.2

Other Changes

  • [AUTOMATIC] iOS 4.13.1 => 4.13.2 Android 5.6.1 => 5.6.2 (#250) via RevenueCat Git Bot (@RCGitBot)
  • Improvements on automatic upgrading iOS and Android version depending type of change (#249) via Cesar de la Vega (@vegaro)

4.3.1

Other Changes

  • Upgrade iOS to 4.13.1 and Android to 5.6.1 (#246) via RevenueCat Git Bot (@RCGitBot)
  • Update maven-publish-plugin (#245) via Cesar de la Vega (@vegaro)
  • Adds parameters to run bump and dependency updates manually instead of approval jobs (#243) via Cesar de la Vega (@vegaro)
  • IntegrationTests: don't initialize Purchases until SKTestSession has been re-created (#244) via NachoSoto (@NachoSoto)

4.3.0

Other Changes

  • Upgrade iOS to 4.13.0 and Android to 5.6.1 (#235) via RevenueCat Git Bot (@RCGitBot)
  • Remove step from automatic-release to trigger Flutter update. Use its own job instead (#240) via Cesar de la Vega (@vegaro)
  • Trigger purchases-flutter dependency upgrade when release is made (#238) via Cesar de la Vega (@vegaro)
  • Remove upload of the PurchasesHybridCommon.framework (#239) via Cesar de la Vega (@vegaro)
  • Update Dangerfile to use repository (#237) via Cesar de la Vega (@vegaro)
  • Store PurchasesHybridCommon.framework.zip artifact (#236) via Cesar de la Vega (@vegaro)

4.2.2

Bugfixes

  • CommonFunctionality: fixed unknown error creation (#233) via NachoSoto (@NachoSoto)

    Other Changes

  • Integration Tests: added test for promotionalOffer (#228) via NachoSoto (@NachoSoto)

4.2.1

Bugfixes

  • purchase(productIdentifier:) fixed SK2 implementation (#226) via NachoSoto (@NachoSoto)

    Other Changes

  • Upgrade iOS to 4.11.0 (#224) via RevenueCat Git Bot (@RCGitBot)
  • Adds hold jobs to manual trigger automatic dependency updates (#223) via Cesar de la Vega (@vegaro)

4.2.0

New Features

  • Add in missing attribution functions (#219) via Joshua Liebowitz (@taquitos)

4.1.5

Other Changes

  • Upgrade iOS to 4.10.2 and Android to 5.5.0 (#220) via RevenueCat Git Bot (@RCGitBot)
  • Fix CircleCI caches (#217) via Cesar de la Vega (@vegaro)
  • Skip next version if there are no public changes (#218) via Cesar de la Vega (@vegaro)

4.1.4

API Changes

  • Rename revenueCatId and productId to transactionIdentifier and productIdentifier. Old values still exist but are deprecated (#211) via Toni Rico (@tonidero)

Other Changes

  • Update common fastlane plugin (#215) via Cesar de la Vega (@vegaro)
  • Replace build with dependencies on automatic upgrade PRs (#213) via Cesar de la Vega (@vegaro)
  • IntegrationTests: actually fail test if tests aren't configured (#210) via NachoSoto (@NachoSoto)

4.1.3

Other Changes

  • automaticAppleSearchAdsAttributionCollection: changed implementation to call method directly (#199) via NachoSoto (@NachoSoto)
  • Release train (#202) via Cesar de la Vega (@vegaro)
  • Adds Danger (#204) via Cesar de la Vega (@vegaro)
  • Upgrade iOS to 4.10.2 (#207) (@NachoSoto)

4.1.2

Other Changes

  • Upgrade iOS to 4.10.1 (#201) via RevenueCat Git Bot (@RCGitBot)

4.1.1

  • Added missing availability check for catalyst (#197) via aboedo (@aboedo)
  • Adds .bundle and vendor to gitignore (#196) via Cesar de la Vega (@vegaro)
  • Schedule automatic PR to update native dependencies (#179) via Cesar de la Vega (@vegaro)

4.1.0

  • Update iOS 4.10.0 (and add AdServices) (#194) via Josh Holtz (@joshdholtz)

4.0.2

  • Redeploy updates from 4.0.1 - bad deploy.

4.0.1

  • Updated purchases-android to 5.4.1

4.0.0

  • Fixed snake_case and camelCase serialization inconsistency in StoreProduct (https://github.com/RevenueCat/purchases-hybrid-common/pull/187):
    • Renamed price_string to priceString
    • Renamed currency_code to currencyCode
    • Renamed intro_price to introPrice
    • Renamed product_category to productCategory
    • Renamed product_type to productType
  • Updated purchases-ios to 4.9.1

3.3.0

3.2.4

  • Update Podspec version

3.2.3

3.2.2

3.2.1

3.2.0

3.1.0

3.0.0

2.0.1

2.0.0

Breaking changes

  • Updated configureWithAPIKey: method to accept a DangerousSettings object

Other

1.11.2

1.11.1

1.11.0

Add ownershipType to EntitlementInfo

- https://github.com/RevenueCat/purchases-hybrid-common/pull/101

1.10.1

1.10.0

1.9.3

1.9.2

1.9.1

1.9.0

1.8.2

1.8.1

1.8.0

Identity V3

New methods
  • Introduces logIn, a new way of identifying users, which also returns whether a new user has been registered in the system. logIn uses a new backend endpoint.
  • Introduces logOut, a replacement for reset.
Deprecations
  • deprecates createAlias in favor of logIn
  • deprecates identify in favor of logIn
  • deprecates reset in favor of logOut
  • deprecates allowSharingStoreAccount in favor of dashboard-side configuration

Dependency updates

Bug Fixes

1.7.1

1.7.0

1.6.3

1.6.2

1.6.1

1.6.0

1.5.1

1.5.0

1.4.5

1.4.4

1.4.3

1.4.2

1.4.1

1.4.0

1.3.1

1.3.0

1.2.0

1.1.2

1.1.1

1.1.0

1.0.14

1.0.13

1.0.12

1.0.11

  • Converts all NSNull attributes to string or nil

1.0.10

  • Fix crash when setting NSNull in setAttributes

1.0.9

  • Added subscription offers support

1.0.8

  • Fixes a call in Subscriber Attributes when setting a push token as string

1.0.7

  • Adds compatibility with Subscriber Attributes and invalidate purchaser info cache.

1.0.6

  • Updates completion block for checkTrialOrIntroductoryPriceEligibility

1.0.5

  • Fixes issue with older versions of Kotlin