@dexterai/x402 1.9.0 → 1.9.1

package/dist/react/index.d.cts

@@ -1,5 +1,8 @@
-import { a as X402Client } from '../x402-client-BDaOwfgE.cjs';
+import { a as X402Client } from '../sponsored-access-BCB2CxdG.cjs';
+export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-BCB2CxdG.cjs';
 import { W as WalletSet, B as BalanceInfo } from '../types-DmqH9yD8.cjs';
+import { SponsoredRecommendation } from '@dexterai/x402-ads-types';
+export { SponsoredRecommendation } from '@dexterai/x402-ads-types';
 import { a as AccessPassTier } from '../types-BQvaF8lB.cjs';
 export { A as AccessPassClientConfig, b as AccessPassInfo, X as X402Error } from '../types-BQvaF8lB.cjs';
 
@@ -114,6 +117,12 @@ interface UseX402PaymentReturn {
         /** Seconds remaining on the pass */
         remainingSeconds: number | null;
     } | null;
+    /**
+     * Sponsored recommendations from the most recent payment.
+     * Populated when the facilitator returns sponsored-access extensions
+     * in the settlement response. Null if no recommendations were delivered.
+     */
+    sponsoredRecommendations: SponsoredRecommendation[] | null;
 }
 /**
  * React hook for managing x402 v2 payments across chains

package/dist/react/index.d.ts

@@ -1,5 +1,8 @@
-import { a as X402Client } from '../x402-client-DIcp-PvX.js';
+import { a as X402Client } from '../sponsored-access-H1EX6zpi.js';
+export { f as fireImpressionBeacon, b as getSponsoredRecommendations } from '../sponsored-access-H1EX6zpi.js';
 import { W as WalletSet, B as BalanceInfo } from '../types-ENcnkof8.js';
+import { SponsoredRecommendation } from '@dexterai/x402-ads-types';
+export { SponsoredRecommendation } from '@dexterai/x402-ads-types';
 import { a as AccessPassTier } from '../types-BQvaF8lB.js';
 export { A as AccessPassClientConfig, b as AccessPassInfo, X as X402Error } from '../types-BQvaF8lB.js';
 
@@ -114,6 +117,12 @@ interface UseX402PaymentReturn {
         /** Seconds remaining on the pass */
         remainingSeconds: number | null;
     } | null;
+    /**
+     * Sponsored recommendations from the most recent payment.
+     * Populated when the facilitator returns sponsored-access extensions
+     * in the settlement response. Null if no recommendations were delivered.
+     */
+    sponsoredRecommendations: SponsoredRecommendation[] | null;
 }
 /**
  * React hook for managing x402 v2 payments across chains

package/dist/react/index.js

@@ -449,6 +449,9 @@ function isKnownUSDC(asset) {
 
 // src/client/x402-client.ts
 var receiptStore = /* @__PURE__ */ new WeakMap();
+function getPaymentReceipt(response) {
+  return receiptStore.get(response);
+}
 function createX402Client(config) {
   const {
     adapters = [createSolanaAdapter({ verbose: config.verbose }), createEvmAdapter({ verbose: config.verbose })],
@@ -878,6 +881,28 @@ function getExplorerUrl(txSignature, network) {
   return `https://solscan.io/tx/${txSignature}`;
 }
 
+// src/client/sponsored-access.ts
+function getSponsoredAccessInfo(response) {
+  const receipt = getPaymentReceipt(response);
+  if (!receipt?.extensions?.["sponsored-access"]) return void 0;
+  return receipt.extensions["sponsored-access"];
+}
+function getSponsoredRecommendations(response) {
+  const info = getSponsoredAccessInfo(response);
+  if (!info?.recommendations?.length) return void 0;
+  return info.recommendations;
+}
+async function fireImpressionBeacon(response) {
+  const info = getSponsoredAccessInfo(response);
+  const beaconUrl = info?.tracking?.impressionBeacon;
+  if (!beaconUrl) return false;
+  try {
+    await fetch(beaconUrl, { method: "GET" });
+  } catch {
+  }
+  return true;
+}
+
 // src/react/useX402Payment.ts
 function useX402Payment(config) {
   const {
@@ -893,6 +918,7 @@ function useX402Payment(config) {
   const [transactionId, setTransactionId] = useState(null);
   const [transactionNetwork, setTransactionNetwork] = useState(null);
   const [balances, setBalances] = useState([]);
+  const [sponsoredRecommendations, setSponsoredRecommendations] = useState(null);
   const log = useCallback((...args) => {
     if (verbose) console.log("[useX402Payment]", ...args);
   }, [verbose]);
@@ -980,6 +1006,7 @@ function useX402Payment(config) {
     setError(null);
     setTransactionId(null);
     setTransactionNetwork(null);
+    setSponsoredRecommendations(null);
   }, []);
   const client = useMemo(() => createX402Client({
     adapters,
@@ -1017,6 +1044,13 @@ function useX402Payment(config) {
           log("Could not parse PAYMENT-RESPONSE header");
         }
       }
+      const recs = getSponsoredRecommendations(response);
+      setSponsoredRecommendations(recs ?? null);
+      if (recs) {
+        log("Sponsored recommendations received:", recs.length);
+        fireImpressionBeacon(response).catch(() => {
+        });
+      }
       setStatus("success");
       return response;
     } catch (err) {
@@ -1047,8 +1081,9 @@ function useX402Payment(config) {
     isAnyWalletConnected,
     reset,
     refreshBalances,
-    accessPass: null
+    accessPass: null,
     // Access pass state managed by useAccessPass hook for granular control
+    sponsoredRecommendations
   };
 }
 
@@ -1246,6 +1281,8 @@ function useAccessPass(config) {
 }
 export {
   X402Error,
+  fireImpressionBeacon,
+  getSponsoredRecommendations,
   useAccessPass,
   useX402Payment
 };