Skip to content

v0.1.0-beta.4

Pre-release
Pre-release

Choose a tag to compare

View all tags
@lynnswap lynnswap released this 23 Jul 12:20
· 3 commits to main since this release
v0.1.0-beta.4
83801f4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

StoreTransactionKit v0.1.0-beta.4

StoreTransactionKit centralizes verified StoreKit transaction handling, entitlement reconciliation, and Transaction.finish() authority in one process-owned, observable store.

This is a prerelease. Public API may change before the stable v0.1.0 release.

Requirements: Swift 6.3+; iOS 18.4+, macOS 15.4+, Mac Catalyst 18.4+, tvOS 18.4+, watchOS 11.4+, or visionOS 2.4+.

New Features

  • Define an App Store Connect auto-renewable subscription group with typed product identifiers, mapping multiple durations or service levels to app-defined entitlements.
  • Bridge the validated catalog to StoreKit product and subscription metadata through its subscription group ID, declaration-ordered Product IDs, and exact Product ID-to-entitlement lookup.
  • Use TransactionStore to process app-supplied purchase results, monitor verified deliveries and subscription-status changes, reconcile unfinished transactions and current entitlements, query history, restore purchases, and perform a drained shutdown.
  • Gate features with isEntitled(to:) while retaining explicit loading, failed, ready, and overridden entitlement states.
  • Automatically finish declared and upgraded same-group subscriptions, or provide an optional TransactionStoreDelegate for durable app-owned effects, out-of-group products, and background-failure notifications.
  • Handle valid same-group subscriptions unknown to the installed binary with an optional UnrecognizedSubscriptionDelegate, choosing whether to leave them unfinished, finish them, or map them to a known entitlement.
  • Override entitlements for previews, debug builds, UI tests, or app-defined distribution environments without starting StoreKit.
  • Test the production entitlement flow without a .storekit configuration using StoreTransactionKitTesting, including typed purchases, deterministic access loss, unrecognized subscriptions, arbitrary transaction deliveries, and TransactionStoreTestClock.
  • Diagnose transaction-store operations through typed errors with localized descriptions and recovery guidance.

Documentation

  • Includes app-owned Product.purchase(options:) and PurchaseIntent flows, automatic transaction monitoring, subscription-status reconciliation, unrecognized-product policies, entitlement overrides, and deterministic testing guidance.
Assets 2
Loading