chore: merge main

Author: hyochan

packages/docs/src/components/SearchModal.tsx

@@ -132,19 +132,10 @@ const apiData: ApiItem[] = [
     title: 'verifyPurchase',
     category: 'Purchase Verification',
     description: 'Verify purchases with your server or platform providers',
-    parameters: 'VerifyPurchaseProps!',
-    returns: 'VerifyPurchaseResult!',
+    parameters: 'ReceiptValidationProps!',
+    returns: 'ReceiptValidationResult!',
     path: '/docs/apis#verify-purchase',
   },
-  {
-    id: 'verify-purchase-with-provider',
-    title: 'verifyPurchaseWithProvider',
-    category: 'Receipt Validation',
-    description: 'Verify purchases against a specific provider (e.g., IAPKit)',
-    parameters: 'VerifyPurchaseWithProviderProps!',
-    returns: 'VerifyPurchaseWithProviderResult!',
-    path: '/docs/apis#verify-purchase-with-provider',
-  },
   // iOS APIs
   {
     id: 'clear-transaction-ios',
@@ -323,8 +314,8 @@ const apiData: ApiItem[] = [
     title: 'validateReceiptIOS',
     category: 'iOS APIs',
     description: 'Deprecated: use verifyPurchase for purchase verification',
-    parameters: 'options: VerifyPurchaseProps!',
-    returns: 'VerifyPurchaseResultIOS!',
+    parameters: 'options: ReceiptValidationProps!',
+    returns: 'ReceiptValidationResultIOS!',
     path: '/docs/apis#validate-receipt-ios',
   },
 

packages/docs/src/pages/docs/apis.tsx

@@ -1103,7 +1103,7 @@ Future<void> deepLinkToSubscriptions({
       </section>
       <section>
         <AnchorLink id="validation" level="h2">
-          Verify Purchase
+          Validation
         </AnchorLink>
 
         <AnchorLink id="verify-purchase" level="h3">
@@ -1116,18 +1116,40 @@ Future<void> deepLinkToSubscriptions({
             should be validated before granting entitlements.
           </strong>
         </p>
-        <CodeBlock language="graphql">{`"""
-Returns: VerifyPurchaseResult!
-"""
-verifyPurchase(options: VerifyPurchaseProps!): Future`}</CodeBlock>
+        <LanguageTabs>
+          {{
+            typescript: (
+              <CodeBlock language="typescript">{`// Function signature
+verifyPurchase(options: ReceiptValidationProps): Promise<ReceiptValidationResult>`}</CodeBlock>
+            ),
+            swift: (
+              <CodeBlock language="swift">{`// Function signature
+func verifyPurchase(
+    options: ReceiptValidationProps
+) async throws -> ReceiptValidationResult`}</CodeBlock>
+            ),
+            kotlin: (
+              <CodeBlock language="kotlin">{`// Function signature
+suspend fun verifyPurchase(
+    options: ReceiptValidationProps
+): ReceiptValidationResult`}</CodeBlock>
+            ),
+            dart: (
+              <CodeBlock language="dart">{`// Function signature
+Future<ReceiptValidationResult> verifyPurchase(
+  ReceiptValidationProps options,
+);`}</CodeBlock>
+            ),
+          }}
+        </LanguageTabs>
         <p className="type-link">
           See:{' '}
-          <Link to="/docs/types#verify-purchase-types">
-            VerifyPurchaseProps
+          <Link to="/docs/types#purchase-verification-types">
+            ReceiptValidationProps
           </Link>
           ,{' '}
-          <Link to="/docs/types#verify-purchase-result">
-            VerifyPurchaseResult
+          <Link to="/docs/types#receipt-validation-result">
+            ReceiptValidationResult
           </Link>
         </p>
         <p>Verifies purchases with the appropriate validation service.</p>
@@ -1146,78 +1168,6 @@ verifyPurchase(options: VerifyPurchaseProps!): Future`}</CodeBlock>
           can validate against the Google Play developer API.
         </p>
 
-        <AnchorLink id="verify-purchase-with-provider" level="h3">
-          verifyPurchaseWithProvider
-        </AnchorLink>
-        <p>
-          Verify purchases via an external provider without running your own
-          server. The first supported provider is IAPKit (
-          <a href="https://iapkit.com" target="_blank" rel="noopener noreferrer">
-            https://iapkit.com
-          </a>
-          ), which handles validation through its hosted API (optional
-          <code>Authorization: Bearer {'{apiKey}'}</code>).
-        </p>
-        <CodeBlock language="graphql">{`"""
-Returns: VerifyPurchaseWithProviderResult!
-"""
-# Future
-verifyPurchaseWithProvider(
-  options: VerifyPurchaseWithProviderProps!
-): Future`}</CodeBlock>
-        <p className="type-link">
-          See:{' '}
-          <Link to="/docs/types#purchase-verification-provider">
-            PurchaseVerificationProvider
-          </Link>
-          ,{' '}
-          <Link to="/docs/types#request-verify-purchase-with-iapkit-props">
-            RequestVerifyPurchaseWithIapkitProps
-          </Link>
-          ,{' '}
-          <Link to="/docs/types#verify-purchase-with-provider-props">
-            VerifyPurchaseWithProviderProps
-          </Link>
-          ,{' '}
-          <Link to="/docs/types#verify-purchase-with-provider-result">
-            VerifyPurchaseWithProviderResult
-          </Link>
-        </p>
-        <CodeBlock language="typescript">{`// IAPKit — Apple + Google in one request
-await verifyPurchaseWithProvider({
-  provider: 'iapkit',
-  iapkit: {
-    apiKey: process.env.IAPKIT_API_KEY,
-    apple: {
-      receipt: jwsTokenFromPurchase,
-      environment: 'production',
-      appId: 'com.example.app'
-    },
-    google: {
-      packageName: 'com.example.app',
-      purchaseId: 'premium_monthly',
-      purchaseToken: purchase.purchaseToken
-    }
-  }
-});`}</CodeBlock>
-        <ul>
-          <li>
-            <code>apiKey</code> is optional; when set it is sent as{' '}
-            <code>Authorization: Bearer {'{apiKey}'}</code>.
-          </li>
-          <li>
-            <code>apple.appId</code> is required when{' '}
-            <code>environment</code> is <code>production</code>.
-          </li>
-          <li>
-            For full API details, see{' '}
-            <a href="https://api.iapkit.com" target="_blank" rel="noopener noreferrer">
-              https://api.iapkit.com
-            </a>
-            .
-          </li>
-        </ul>
-
         <AnchorLink id="purchase-identifier-usage" level="h3">
           Purchase Identifier Usage
         </AnchorLink>
@@ -1643,11 +1593,11 @@ struct ExternalPurchaseLinkResultIOS {
                   <strong>Deprecated:</strong> Use <code>verifyPurchase</code>{' '}
                   instead for both platforms.
                 </p>
-                <CodeBlock language="graphql">{`"""
-Validate a receipt for a specific product
-"""
-# Future
-validateReceiptIOS(options: VerifyPurchaseProps!): VerifyPurchaseResultIOS! @deprecated(reason: "Use verifyPurchase")`}</CodeBlock>
+                <CodeBlock language="swift">{`// Deprecated: Use verifyPurchase() instead
+@available(*, deprecated, message: "Use verifyPurchase()")
+func validateReceiptIOS(
+    options: ReceiptValidationProps
+) async throws -> ReceiptValidationResult`}</CodeBlock>
                 <p>
                   Validates a receipt payload against the App Store using the
                   provided validation options. Returns the parsed validation