@mmerterden/multi-agent-pipeline 8.6.2 → 10.0.6

package/pipeline/skills/shared/external/storekit/SKILL.md

@@ -5,13 +5,20 @@ description: "Implement, review, or improve in-app purchases and subscriptions u
 
 # StoreKit 2 In-App Purchases and Subscriptions
 
-Implement in-app purchases, subscriptions, and paywalls using StoreKit 2 on
-iOS 26+. Use only the modern `Product`, `Transaction`, `StoreView`, and
-`SubscriptionStoreView` APIs. Never use the deprecated original StoreKit
-(`SKProduct`, `SKPaymentQueue`, `SKStoreReviewController`).
+Implement in-app purchases, subscriptions, paywalls, and StoreKit testing using
+StoreKit 2 on iOS 26+. Use the modern Swift-based `Product`, `Transaction`,
+`PurchaseAction`, `StoreView`, and `SubscriptionStoreView` APIs. Avoid original
+In-App Purchase APIs (`SKProduct`, `SKPaymentQueue`) unless legacy OS support
+requires them.
+
+When reviewing StoreKit code, explicitly separate "preferred SwiftUI path" from
+"invalid API": `PurchaseAction` is the preferred custom SwiftUI button path, but
+direct `product.purchase(options:)` is still valid for lower-level custom
+StoreKit flows.
 
 ## Contents
 
+- [Implementation Review Minimums](#implementation-review-minimums)
 - [Product Types](#product-types)
 - [Loading Products](#loading-products)
 - [Purchase Flow](#purchase-flow)
@@ -28,6 +35,33 @@ iOS 26+. Use only the modern `Product`, `Transaction`, `StoreView`, and
 - [Review Checklist](#review-checklist)
 - [References](#references)
 
+## Implementation Review Minimums
+
+When reviewing a paywall, purchase manager, or entitlement gate, include these
+points explicitly:
+
+- Standard SwiftUI paywalls should prefer `StoreView`, `ProductView`, or
+  `SubscriptionStoreView`; custom SwiftUI buy buttons should prefer
+  `PurchaseAction`; direct `product.purchase(options:)` is valid for
+  lower-level custom StoreKit flows.
+- `Transaction.updates` must start at app launch because it catches purchases
+  from other devices, Family Sharing changes, renewals, Ask to Buy approvals,
+  refunds, revocations, and unfinished transactions.
+- Include this entitlement-scope sentence verbatim when reviewing
+  `Transaction.currentEntitlements`: "It covers non-consumables, active or
+  grace-period auto-renewable subscriptions, and non-renewing subscriptions; it
+  does not include consumable purchase or delivery history."
+- Verify every `VerificationResult` before granting access. Deliver or persist
+  the entitlement first, then call `transaction.finish()`.
+- Pending purchases and user cancellations never unlock content; pending Ask to
+  Buy approvals unlock only after a verified transaction arrives through the
+  launch-time listener.
+- Exclude refunded or revoked transactions from active entitlement state and
+  re-check entitlements when refunds or revocations arrive through
+  `Transaction.updates`.
+- Provide a visible restore purchases path and Terms of Service / Privacy
+  Policy links on subscription paywalls.
+
 ## Product Types
 
 | Type | Enum Case | Behavior |
@@ -60,12 +94,22 @@ for product in products {
 
 ## Purchase Flow
 
-Call `product.purchase(options:)` and handle all three `PurchaseResult` cases.
-Always verify and finish transactions.
+Prefer StoreKit views for standard paywalls because they initiate purchases,
+restore purchases, and display policy controls. For custom SwiftUI purchase
+buttons, prefer `PurchaseAction` from the environment. Use direct
+`product.purchase(options:)` only for lower-level custom flows, and use
+`purchase(confirmIn:options:)` for UIKit or AppKit confirmation. Always handle
+every `PurchaseResult`, verify before access, deliver durably, then finish.
+
+Review wording: do not call `product.purchase(options:)` inherently wrong. Say
+"prefer `PurchaseAction` for SwiftUI buttons; keep `product.purchase(options:)`
+for lower-level custom flows that need direct StoreKit control."
 
 ```swift
-func purchase(_ product: Product) async throws {
-    let result = try await product.purchase(options: [
+@Environment(\.purchase) private var purchase
+
+func purchaseProduct(_ product: Product) async throws {
+    let result = try await purchase(product, options: [
         .appAccountToken(userAccountToken)
     ])
     switch result {
@@ -76,8 +120,8 @@ func purchase(_ product: Product) async throws {
     case .userCancelled:
         break
     case .pending:
-        // Ask to Buy or deferred approval -- do not unlock content yet
-        break
+        // Ask to Buy or deferred approval: show pending UI, no unlock yet.
+        showPendingApprovalMessage()
     @unknown default:
         break
     }
@@ -93,24 +137,30 @@ func checkVerified<T>(_ result: VerificationResult<T>) throws -> T {
 
 ## Transaction.updates Listener
 
-Start at app launch. Catches purchases from other devices, Family Sharing
-changes, renewals, Ask to Buy approvals, refunds, and revocations.
+Start at app launch, not when a paywall appears. Catches purchases from other
+devices, Family Sharing changes, renewals, Ask to Buy approvals, refunds,
+revocations, and unfinished transactions Apple emits once immediately after
+launch. Keep the task retained for the app lifetime.
+
+In implementation reviews, name the launch-time coverage explicitly: purchases
+made on other devices, Family Sharing changes, subscription renewals, Ask to Buy
+approvals, refunds, revocations, and unfinished transactions.
 
 ```swift
 @main
 struct MyApp: App {
-    private var transactionListener: Task<Void, Error>?
+    private let transactionListener: Task<Void, Never>
 
     init() {
-        transactionListener = listenForTransactions()
+        transactionListener = Self.listenForTransactions()
     }
 
     var body: some Scene {
         WindowGroup { ContentView() }
     }
 
-    func listenForTransactions() -> Task<Void, Error> {
-        Task.detached {
+    static func listenForTransactions() -> Task<Void, Never> {
+        Task(priority: .background) {
             for await result in Transaction.updates {
                 guard case .verified(let transaction) = result else { continue }
                 await StoreManager.shared.updateEntitlements()
@@ -123,8 +173,17 @@ struct MyApp: App {
 
 ## Entitlement Checking
 
-Use `Transaction.currentEntitlements` for non-consumable purchases and active
-subscriptions. Always check `revocationDate`.
+Use `Transaction.currentEntitlements` for non-consumables, active or grace
+period auto-renewable subscriptions, and non-renewing subscriptions. It excludes
+consumables and consumable delivery history; track consumable fulfillment in
+your own app or server ledger. It also excludes refunded or revoked
+transactions. Use `Transaction.unfinished` for unfinished consumables and
+recovery sweeps. Always check `revocationDate` when processing transactions.
+
+In reviews, include this sentence verbatim: "Transaction.currentEntitlements
+covers non-consumables, active or grace-period auto-renewable subscriptions, and
+non-renewing subscriptions; it does not include consumable purchase or delivery
+history." Do not replace this with only a code sample or a revocation check.
 
 ```swift
 @Observable
@@ -158,9 +217,10 @@ struct PremiumGatedView: View {
             switch state {
             case .loading: ProgressView()
             case .failure: PaywallView()
-            case .success(let transaction):
-                if transaction != nil { PremiumContentView() }
-                else { PaywallView() }
+            case .success(.some(.verified(let transaction))) where transaction.revocationDate == nil:
+                PremiumContentView()
+            case .success:
+                PaywallView()
             }
         }
         .currentEntitlementTask(for: ProductID.premium) { state in
@@ -184,7 +244,8 @@ SubscriptionStoreView(groupID: "YOUR_GROUP_ID")
     .subscriptionStorePolicyDestination(url: termsURL, for: .termsOfService)
     .subscriptionStorePolicyDestination(url: privacyURL, for: .privacyPolicy)
     .onInAppPurchaseCompletion { product, result in
-        if case .success(.verified(let transaction)) = result {
+        if case .success(.success(.verified(let transaction))) = result {
+            await deliverContent(for: transaction)
             await transaction.finish()
         }
     }
@@ -205,6 +266,10 @@ SubscriptionStoreView(groupID: "YOUR_GROUP_ID") {
 
 ### Hierarchical Layout
 
+`SubscriptionOptionGroup`, `SubscriptionOptionSection`, and
+`SubscriptionPeriodGroupSet` are iOS 18+ helper views for organizing options
+inside `SubscriptionStoreView`.
+
 ```swift
 SubscriptionStoreView(groupID: "YOUR_GROUP_ID") {
     SubscriptionPeriodGroupSet()
@@ -221,7 +286,8 @@ StoreView(ids: [ProductID.gems100, ProductID.premium], prefersPromotionalIcon: t
     .productViewStyle(.large)
     .storeButton(.visible, for: .restorePurchases)
     .onInAppPurchaseCompletion { product, result in
-        if case .success(.verified(let transaction)) = result {
+        if case .success(.success(.verified(let transaction))) = result {
+            await deliverContent(for: transaction)
             await transaction.finish()
         }
     }
@@ -244,7 +310,7 @@ ProductView(id: ProductID.premium) { iconPhase in
 
 ```swift
 func checkSubscriptionActive(groupID: String) async throws -> Bool {
-    let statuses = try await Product.SubscriptionInfo.Status.status(for: groupID)
+    let statuses = try await Product.SubscriptionInfo.status(for: groupID)
     for status in statuses {
         guard case .verified = status.renewalInfo,
               case .verified = status.transaction else { continue }
@@ -319,10 +385,11 @@ try await product.purchase(options: [.simulatesAskToBuyInSandbox(true)])
 
 ```swift
 .onInAppPurchaseStart { product in
-    return true  // Return false to cancel
+    await analytics.trackPurchaseStarted(product.id)
 }
 .onInAppPurchaseCompletion { product, result in
-    if case .success(.verified(let transaction)) = result {
+    if case .success(.success(.verified(let transaction))) = result {
+        await deliverContent(for: transaction)
         await transaction.finish()
     }
 }
@@ -350,9 +417,9 @@ try await product.purchase(options: [.simulatesAskToBuyInSandbox(true)])
 let transaction = try checkVerified(verification)
 unlockFeature(transaction.productID)
 
-// CORRECT: Always finish after delivering content
+// CORRECT: Deliver durably, then finish. If delivery fails, do not finish yet.
 let transaction = try checkVerified(verification)
-unlockFeature(transaction.productID)
+try await recordDelivery(transaction)
 await transaction.finish()
 ```
 
@@ -366,18 +433,16 @@ let transaction = verification.unsafePayloadValue
 let transaction = try checkVerified(verification)
 ```
 
-### 4. Using deprecated original StoreKit APIs
+### 4. Using original In-App Purchase APIs in new StoreKit 2 code
 
 ```swift
-// WRONG: Original StoreKit (deprecated)
+// AVOID: Original In-App Purchase APIs
 let request = SKProductsRequest(productIdentifiers: ["com.app.premium"])
 SKPaymentQueue.default().add(payment)
-SKStoreReviewController.requestReview()
 
-// CORRECT: StoreKit 2
+// PREFERRED: StoreKit 2
 let products = try await Product.products(for: ["com.app.premium"])
 let result = try await product.purchase()
-try await AppStore.requestReview(in: windowScene)
 ```
 
 ### 5. Not checking revocationDate
@@ -410,7 +475,7 @@ Text("Buy \(product.displayName) for \(product.displayPrice)")
 // WRONG: Silently drops pending Ask to Buy
 default: break
 
-// CORRECT: Inform user purchase is awaiting approval
+// CORRECT: Explain approval is pending; unlock only after Transaction.updates
 case .pending:
     showPendingApprovalMessage()
 ```
@@ -453,17 +518,17 @@ SubscriptionStoreView(groupID: "group_id")
 
 - [ ] `Transaction.updates` listener starts at app launch in App init
 - [ ] All transactions verified before granting access
-- [ ] `transaction.finish()` called after content delivery
-- [ ] Revoked transactions excluded from entitlements
-- [ ] `.pending` purchase result handled for Ask to Buy
+- [ ] `transaction.finish()` called only after durable content delivery
+- [ ] Revoked/refunded transactions excluded and entitlement state updated
+- [ ] `.pending` result shows Ask to Buy/deferred-approval feedback
 - [ ] Restore purchases button visible on paywall and store views
 - [ ] Terms of Service and Privacy Policy links on subscription views
 - [ ] Prices shown using `product.displayPrice`, never hardcoded
 - [ ] Subscription terms (price, duration, renewal) clearly displayed
 - [ ] Free trial states post-trial pricing clearly
-- [ ] No original StoreKit APIs (`SKProduct`, `SKPaymentQueue`)
+- [ ] No original In-App Purchase APIs (`SKProduct`, `SKPaymentQueue`) unless legacy OS support requires them
 - [ ] Product IDs defined as constants, not scattered strings
-- [ ] StoreKit configuration file set up for testing
+- [ ] StoreKit tests cover promotional offers, win-back, offer codes, Ask to Buy, renewals, refunds, and revocations
 - [ ] Entitlements re-checked on Transaction.updates and app foreground
 - [ ] Server-side validation uses `jwsRepresentation` if applicable
 - [ ] Consumables delivered and finished promptly
@@ -471,8 +536,9 @@ SubscriptionStoreView(groupID: "group_id")
 
 ## References
 
-- See `references/app-review-guidelines.md` for IAP rules (Guideline 3.1.1),
-  subscription display requirements, and rejection prevention.
-- See `references/storekit-advanced.md` for subscription control styles,
-  offer management, testing patterns, and advanced subscription handling.
-
+- See [references/app-review-guidelines.md](references/app-review-guidelines.md) for IAP rules (Guideline 3.1.1), subscription display requirements, and rejection prevention.
+- See [references/storekit-advanced.md](references/storekit-advanced.md) for subscription control styles, offer management, testing patterns, and advanced subscription handling.
+- For submission, privacy, metadata, screenshots, and rejection-risk audits use `app-store-review`.
+- For keyword, screenshot-caption, ranking, and conversion strategy use `app-store-optimization`.
+- Official Apple docs: [Choosing a StoreKit API](https://sosumi.ai/documentation/storekit/choosing-a-storekit-api-for-in-app-purchases), [Transaction.updates](https://sosumi.ai/documentation/storekit/transaction/updates), [Transaction.currentEntitlements](https://sosumi.ai/documentation/storekit/transaction/currententitlements),
+  [SubscriptionStoreView](https://sosumi.ai/documentation/storekit/subscriptionstoreview), and [PurchaseAction](https://sosumi.ai/documentation/storekit/purchaseaction).

package/pipeline/skills/shared/external/storekit/evals/evals.json

@@ -0,0 +1,44 @@
+{
+  "skill_name": "storekit",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Build a SwiftUI StoreKit 2 paywall for an iOS 26 app with monthly and yearly subscriptions. Include product loading, purchase handling, entitlement checks, restore purchases, transaction updates, and what to do for Ask to Buy or refunds.",
+      "expected_output": "A current StoreKit 2 subscription paywall plan that uses StoreKit views or PurchaseAction, verifies transactions, starts Transaction.updates at launch, handles current entitlements correctly, and exposes restore and policy links.",
+      "files": [],
+      "assertions": [
+        "Uses `SubscriptionStoreView`, `StoreView`, or SwiftUI `PurchaseAction` as the preferred purchase path instead of defaulting only to `product.purchase(options:)`.",
+        "Starts a `Transaction.updates` listener at app launch using a non-throwing task and notes that updates can deliver Ask to Buy approvals, refunds, renewals, and unfinished transactions.",
+        "Verifies `VerificationResult` before granting access and calls `transaction.finish()` after content delivery.",
+        "Explains that `Transaction.currentEntitlements` covers non-consumables, active or grace-period auto-renewable subscriptions, and non-renewing subscriptions, but not consumable delivery history.",
+        "Handles `.pending`, `.userCancelled`, refunds or revocations, restore purchases, and subscription policy links."
+      ]
+    },
+    {
+      "id": 2,
+      "prompt": "Review this StoreKit subscription-offer code plan: use `Product.SubscriptionInfo.Status.status(for:)`, show every `winBackOffers` entry to cancelled users, use `.subscriptionPromotionalOffer(offer: signature:)`, and inspect `transaction.offerType` / `transaction.offerID` on purchase. Correct the API and eligibility mistakes.",
+      "expected_output": "A correction-focused answer that updates stale StoreKit offer APIs, filters win-back offers through renewal eligibility, and verifies applied offers through the current transaction offer model.",
+      "files": [],
+      "assertions": [
+        "Replaces `Product.SubscriptionInfo.Status.status(for:)` with `Product.SubscriptionInfo.status(for:)`.",
+        "Explains that `product.subscription?.winBackOffers` is a raw list and must be filtered through verified `renewalInfo.eligibleWinBackOfferIDs` before display or purchase.",
+        "Uses the iOS 26 SwiftUI `subscriptionPromotionalOffer` closure plus `compactJWS` closure for StoreKit views, or clearly separates it from lower-level signed purchase options.",
+        "Uses `transaction.offer?.type` and `transaction.offer?.id` instead of stale `transaction.offerType` and `transaction.offerID`.",
+        "Mentions StoreKit configuration or sandbox testing for promotional, win-back, offer code, Ask to Buy, and renewal-state flows."
+      ]
+    },
+    {
+      "id": 3,
+      "prompt": "Use StoreKit guidance to review an iOS app that sells premium app features, has a reader-account sign-up link, and also wants App Store keywords and privacy manifest checks. Keep the answer scoped: what belongs in StoreKit, what belongs in App Store Review or ASO, and what IAP compliance caveats should be called out?",
+      "expected_output": "A boundary-aware response that keeps StoreKit focused on IAP implementation, routes broader submission and metadata work to sibling skills, and states current IAP/external-link rules without overclaiming.",
+      "files": [],
+      "assertions": [
+        "Keeps StoreKit guidance focused on IAP products, paywalls, purchase flows, transaction verification, restore, and entitlement handling.",
+        "Routes privacy manifests, ATT, screenshot, metadata rejection, and full submission readiness to the `app-store-review` skill.",
+        "Routes keyword strategy, ranking, screenshot-caption optimization, and conversion work to the `app-store-optimization` skill.",
+        "States that digital features generally require IAP unless a current guideline exception, storefront rule, or approved entitlement applies.",
+        "Avoids a blanket claim that all external purchase links are always rejected and instead calls out reader-app and regional or storefront-sensitive rules."
+      ]
+    }
+  ]
+}

package/pipeline/skills/shared/external/storekit/references/app-review-guidelines.md

@@ -1,58 +1,109 @@
 # App Review Guidelines -- In-App Purchases and Subscriptions
 
-App Store review rules relevant to in-app purchases, subscriptions, and
-payment compliance. Extracted from Apple's App Store Review Guidelines for
-self-contained reference.
+Use this as a StoreKit implementation guardrail for App Review payment issues.
+For full submission, privacy, metadata, entitlement, or rejection-risk audits,
+use the sibling `app-store-review` skill and re-check Apple's current App
+Review Guidelines.
 
-## In-App Purchase Rules (Guideline 3.1.1)
+## Contents
 
-IAP rules are strict and heavily enforced.
+- [Guideline 3.1.1 Baseline](#guideline-311-baseline)
+- [What Generally Requires IAP](#what-generally-requires-iap)
+- [What Generally Does Not Require IAP](#what-generally-does-not-require-iap)
+- [External Purchase Links and Reader Apps](#external-purchase-links-and-reader-apps)
+- [Subscription Display Requirements](#subscription-display-requirements)
+- [StoreKit Implementation Checklist](#storekit-implementation-checklist)
+- [Common IAP Rejection Risks](#common-iap-rejection-risks)
+- [Pre-Submission Payments Checklist](#pre-submission-payments-checklist)
+- [References](#references)
 
-### What Requires Apple IAP
+## Guideline 3.1.1 Baseline
 
-All digital content and services must use Apple's In-App Purchase system:
+Digital content, app features, subscriptions, virtual goods, and services
+unlocked in the app generally must use Apple's In-App Purchase system unless a
+specific App Review guideline exception, storefront-specific rule, or approved
+entitlement applies.
+
+Do not present this as a universal ban on every external purchase link. The
+rules differ by storefront, entitlement, and app type, and they change over
+time. For a release audit, quote the current guidelines directly.
+
+## What Generally Requires IAP
 
 - Premium features or content unlocks
 - Subscriptions to app functionality
-- Virtual currency, coins, gems
+- Virtual currency, coins, gems, or other digital goods
 - Ad removal
 - Digital tips or donations
+- Digital gift cards, certificates, vouchers, or coupons for digital goods
+
+## What Generally Does Not Require IAP
+
+- Physical products and e-commerce
+- Ride-sharing, food delivery, and real-world services
+- One-to-one services such as tutoring or consulting booked through the app
+- Enterprise or B2B apps distributed through Apple Business Manager
+
+## External Purchase Links and Reader Apps
+
+- Remove external purchase links, buttons, calls to action, and purchase paths
+  for digital goods unless the current storefront rules or an approved
+  entitlement explicitly allow them.
+- Reader apps may access content purchased elsewhere. Account-management or
+  sign-up links depend on current reader-app rules, storefront, and entitlement
+  status.
+- U.S. storefront behavior and some regional external-purchase entitlements are
+  different from the old blanket prohibition. Do not hardcode old guidance into
+  product or review advice.
+
+## Subscription Display Requirements
+
+- Clearly display price, duration, billing frequency, renewal behavior, and
+  cancellation terms before purchase.
+- Free trials must clearly state trial duration, post-trial price, billing
+  frequency, auto-renewal, and cancellation terms.
+- Subscriptions should provide ongoing value and be available across a user's
+  devices where the app supports them.
+
+## StoreKit Implementation Checklist
+
+- Categorize consumables, non-consumables, non-renewing subscriptions, and
+  auto-renewable subscriptions correctly in App Store Connect.
+- Provide working restore purchases for restorable products. StoreKit views can
+  expose this with `.storeButton(.visible, for: .restorePurchases)`.
+- Verify transactions with StoreKit 2 `VerificationResult`, current
+  entitlements, and server-side JWS validation when the business model requires
+  server authority.
+- Handle interrupted purchases, `.pending` Ask to Buy approvals, refunds,
+  revocations, Family Sharing changes, grace period, and billing retry.
+
+## Common IAP Rejection Risks
+
+1. **Unauthorized external purchase path.** The app links or directs users to
+   buy digital goods outside IAP without a current rule or entitlement allowing
+   that path.
+2. **Missing restore path.** Restorable products cannot be restored from the
+   paywall or store surface.
+3. **Unclear subscription terms.** Price, duration, renewal behavior, trial
+   conversion price, and cancellation terms are missing or hidden before
+   purchase.
+4. **Incorrect product categorization.** Consumables, non-consumables, and
+   auto-renewable subscriptions do not match the App Store Connect product
+   setup or the app's entitlement logic.
 
-### What Does NOT Require IAP
-
-- Physical products (e-commerce)
-- Ride-sharing, food delivery, real-world services
-- One-to-one services (tutoring, consulting booked through the app)
-- Enterprise/B2B apps distributed through Apple Business Manager
-
-### Subscription Display Requirements
-
-- Price, duration, and auto-renewal terms must be clearly displayed before purchase
-- Free trials must state what happens when they end (price, billing frequency)
-- No links, buttons, or language directing users to purchase outside the app
-- "Reader" apps (Netflix, Spotify) may link to external sign-up but cannot offer IAP bypass
-
-### StoreKit Implementation Checklist
-
-- Consumables, non-consumables, and subscriptions must be correctly categorized in App Store Connect
-- Restore purchases functionality must be present and working
-- Transaction verification should use StoreKit 2 `Transaction.currentEntitlements` or server-side validation
-- Handle interrupted purchases, deferred transactions, and ask-to-buy gracefully
-
-## Common IAP Rejection Reasons
+## Pre-Submission Payments Checklist
 
-1. **External payment links for digital content.** Any language or button directing users to purchase digital content outside the app is rejected.
-2. **Missing restore purchases.** A visible restore purchases button is required on any paywall or subscription view.
-3. **Unclear subscription terms.** Price, duration, and renewal behavior must be clearly displayed before the user commits. Free trials must state post-trial pricing.
-4. **Incorrect product categorization.** Consumables, non-consumables, and auto-renewable subscriptions must be correctly categorized in App Store Connect.
+- [ ] Digital goods and app-unlocked features use IAP unless a current exception or approved entitlement applies
+- [ ] Subscription terms are visible before purchase
+- [ ] Free trial copy states post-trial price and billing frequency
+- [ ] External purchase links and CTAs are either removed or justified by a current storefront rule or approved entitlement
+- [ ] Restore purchases path is visible and functional for restorable products
+- [ ] Product types match App Store Connect configuration
+- [ ] Transaction verification uses StoreKit 2 APIs and server validation where needed
+- [ ] Ask to Buy, deferred approvals, refunds, and revocations are handled
 
-## Pre-Submission Payments Checklist
+## References
 
-- [ ] All digital content uses Apple IAP
-- [ ] Subscription terms clearly displayed (price, duration, renewal behavior)
-- [ ] No external payment links for digital content
-- [ ] Free trial clearly states post-trial pricing
-- [ ] Restore purchases button present and functional
-- [ ] Consumables, non-consumables, and subscriptions correctly categorized
-- [ ] Transaction verification uses StoreKit 2 APIs or server-side validation
-- [ ] Ask to Buy / deferred transactions handled gracefully
+- [App Store Review Guidelines](https://developer.apple.com/app-store/review/guidelines/) -- use the original Apple URL because this guidelines page is not reliably available through Sosumi.
+- [StoreKit External Purchase Link Entitlement](https://sosumi.ai/documentation/bundleresources/entitlements/com_apple_developer_storekit_external-purchase-link)
+- [StoreKit External Purchase](https://sosumi.ai/documentation/storekit/external-purchase)