@unifold/core 0.1.68-beta.1 → 0.1.68

package/dist/index.d.mts

@@ -568,6 +568,23 @@ interface ProjectConfigResponse {
          */
         is_hidden?: boolean;
     };
+    stripe_link?: {
+        /**
+         * Developer/merchant toggle for the "Pay with Link" on-ramp, overridable by
+         * the SDK `enableStripeLink` prop. There is no dashboard control yet, so it
+         * currently resolves to `false` (SDK prop governs). Mirrors `fiat_onramp`.
+         */
+        enabled?: boolean;
+        /**
+         * Platform-controlled hard hide for the "Pay with Link" on-ramp. Defaults
+         * to false. Stripe Link's crypto on-ramp is only available in a limited set
+         * of countries (currently the US); when true, the SDK MUST hide it
+         * regardless of `enabled` or the `enableStripeLink` prop. Resolved
+         * server-side from the caller's country (`country_code` query param / IP
+         * geolocation).
+         */
+        is_hidden?: boolean;
+    };
     deposit_tracker?: {
         enabled: boolean;
     };
@@ -663,7 +680,7 @@ interface AddressBalancesResponse {
  */
 declare function getAddressBalances(address: string, chainType: ChainType, publishableKey?: string): Promise<AddressBalancesResponse>;
 /** Wallet ids supported by the connect-wallet flow. */
-type WalletMobileDeepLinkWallet = 'phantom' | 'metamask' | 'coinbase' | 'trust' | 'rainbow' | 'rabby' | 'okx';
+type WalletMobileDeepLinkWallet = 'phantom' | 'metamask' | 'coinbase' | 'trust' | 'rainbow' | 'rabby' | 'okx' | 'solflare' | 'backpack';
 /** Chain types an external wallet can connect on. */
 type ExternalWalletChainType = 'ethereum' | 'solana';
 /** A supported external (self-custody) wallet from the directory endpoint. */
@@ -1703,6 +1720,132 @@ interface CoinbaseApplePaySessionResponse {
     destination_amount?: string;
     total_fee?: number;
 }
+/**
+ * One Coinbase guest-checkout limit bucket. Field names are snake_case
+ * to match the wire format (every API response is recursively
+ * snake_cased by `TransformInterceptor` on the way out).
+ */
+interface CoinbaseApplePayLimit {
+    /** `weekly_spending` (rolling 7-day USD cap) or `lifetime_transactions` (all-time count). */
+    limit_type: 'weekly_spending' | 'lifetime_transactions';
+    /** USD for spending limits; absent for count limits. */
+    currency?: string;
+    /** Max limit value (stringified). */
+    limit: string;
+    /** Remaining capacity (`"0"` once the cap is exhausted). */
+    remaining: string;
+}
+/**
+ * State machine for a single limit-upgrade option, per Coinbase's
+ * headless-onramp limits-upgrade guide:
+ *
+ *   unrequested → user has never submitted; collect `fields` and POST
+ *                 /limits/upgrade.
+ *   pending     → submission under review by Coinbase; poll /limits
+ *                 until a terminal state.
+ *   resubmit    → previous submission was rejected but retryable;
+ *                 collect corrected `fields` and POST /limits/upgrade
+ *                 again.
+ *   active      → terminal. Upgrade approved.
+ *   inactive    → terminal. User permanently blocked; do not retry.
+ */
+type ApplePayLimitUpgradeStatus = 'unrequested' | 'pending' | 'resubmit' | 'active' | 'inactive';
+/** One available limit-upgrade option (shape is loose; Coinbase may add fields). */
+interface CoinbaseApplePayLimitUpgradeOption {
+    /** State machine value. May be absent on partial / pre-eligible responses. */
+    status?: ApplePayLimitUpgradeStatus | string;
+    /** Field keys to collect from the user (today: `ssnLast4`, `dateOfBirth`). */
+    fields?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Wire-format response from `POST /apple_pay/limits`. The two `limit_*`
+ * fields come straight from Coinbase (via our snake_casing
+ * passthrough); the two derived fields (`limit_reached`,
+ * `upgrade_status`) are appended by the SDK function for caller
+ * ergonomics — see `getCoinbaseApplePayLimits`.
+ */
+interface CoinbaseApplePayLimitsResponse {
+    limits: CoinbaseApplePayLimit[];
+    limit_upgrade_options?: CoinbaseApplePayLimitUpgradeOption[];
+    /**
+     * Convenience flag baked in by the SDK function. True iff EITHER
+     * `weekly_spending` OR `lifetime_transactions` is exhausted —
+     * Coinbase rejects a new order if it would exceed *either* cap, so
+     * either bucket at `"0"` blocks the user from transacting.
+     * Equivalent to `isApplePayLimitReached(response)`.
+     */
+    limit_reached: boolean;
+    /**
+     * Convenience flag baked in by the SDK function — the status of
+     * `limit_upgrade_options[0]` when present, `null` otherwise.
+     * Equivalent to `getApplePayLimitUpgradeStatus(response)`.
+     */
+    upgrade_status: ApplePayLimitUpgradeStatus | null;
+}
+/**
+ * True iff EITHER `weekly_spending` OR `lifetime_transactions` bucket
+ * is exhausted (`remaining === "0"`). Coinbase rejects a new order if
+ * it would exceed *either* cap — so a user with `weekly=985` but
+ * `lifetime=0` still can't transact, and we should route to the
+ * upgrade flow (or terminal screen if no upgrade is available).
+ *
+ * Defensive on missing buckets: an absent bucket is treated as "not at
+ * cap" for that dimension. All buckets absent ⇒ false (safe default —
+ * we have no evidence they're blocked).
+ */
+declare function isApplePayLimitReached(response: Pick<CoinbaseApplePayLimitsResponse, 'limits'>): boolean;
+/**
+ * Extract the upgrade option's `status` from a limits response. Returns
+ * `null` when the user has no `limit_upgrade_options` at all
+ * (ineligible) or when the upstream omits the field; the caller should
+ * treat that case the same as an `inactive` terminal — there's no
+ * upgrade path.
+ *
+ * Today Coinbase only ever returns a single entry in
+ * `limit_upgrade_options`; if that changes we'll need to scope this by
+ * payment-method type. For now indexing `[0]` is what the
+ * limits-upgrade guide itself does.
+ */
+declare function getApplePayLimitUpgradeStatus(response: Pick<CoinbaseApplePayLimitsResponse, 'limit_upgrade_options'>): ApplePayLimitUpgradeStatus | null;
+/**
+ * Fetch the user's current Apple Pay (guest-checkout) limits + any
+ * available upgrade options. Safe to call before the verification OTP —
+ * callers usually pair this with `isApplePayBothLimitsReached` to decide
+ * whether to surface the limit-upgrade flow instead of sending the SMS.
+ *
+ * @see https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/get-onramp-user-limits
+ */
+declare function getCoinbaseApplePayLimits(
+/** US phone in E.164 (e.g. `+12345678901`). */
+phone: string, publishableKey?: string, signal?: AbortSignal): Promise<CoinbaseApplePayLimitsResponse>;
+interface RequestCoinbaseApplePayLimitUpgradeRequest {
+    /** US phone in E.164. Must match a phone the user controls (Coinbase verifies via the prior OTP). */
+    phone: string;
+    fields: {
+        /** Last 4 SSN digits, no dashes/spaces. */
+        ssnLast4: string;
+        /** Zero-padded day/month, 4-digit year. */
+        dateOfBirth: {
+            day: string;
+            month: string;
+            year: string;
+        };
+    };
+}
+interface RequestCoinbaseApplePayLimitUpgradeResponse {
+    /** Always `"accepted"`. The upgrade decision is asynchronous — poll the limits endpoint. */
+    status: 'accepted';
+}
+/**
+ * Submit identity fields (DOB + SSN last 4) to request an Apple Pay limit
+ * upgrade. The decision is asynchronous on Coinbase's side; poll
+ * `getCoinbaseApplePayLimits` after this to observe whether the new caps
+ * landed.
+ *
+ * @see https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/request-limit-upgrade
+ */
+declare function requestCoinbaseApplePayLimitUpgrade(request: RequestCoinbaseApplePayLimitUpgradeRequest, publishableKey?: string, signal?: AbortSignal): Promise<RequestCoinbaseApplePayLimitUpgradeResponse>;
 /**
  * Create an Apple Pay onramp session. Requires a fresh `onrampToken` from
  * `exchangeOnrampVerificationToken`.
@@ -2021,4 +2164,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutMethod, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositMethod, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionResponse, type DirectExecutionSucceededEvent, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type ExternalWalletChainType, type ExternalWalletInfo, type ExternalWalletsResponse, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetBankTransferProvidersOptions, type GetExchangesQuery, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseLegalAgreements, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type ApplePayLimitUpgradeStatus, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutMethod, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePayLimit, type CoinbaseApplePayLimitUpgradeOption, type CoinbaseApplePayLimitsResponse, type CoinbaseApplePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositMethod, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionResponse, type DirectExecutionSucceededEvent, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type ExternalWalletChainType, type ExternalWalletInfo, type ExternalWalletsResponse, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetBankTransferProvidersOptions, type GetExchangesQuery, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, type RequestCoinbaseApplePayLimitUpgradeRequest, type RequestCoinbaseApplePayLimitUpgradeResponse, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayLimitUpgradeStatus, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseApplePayLimits, getCoinbaseLegalAgreements, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, i18n, isApplePayLimitReached, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, requestCoinbaseApplePayLimitUpgrade, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };

package/dist/index.d.ts

@@ -568,6 +568,23 @@ interface ProjectConfigResponse {
          */
         is_hidden?: boolean;
     };
+    stripe_link?: {
+        /**
+         * Developer/merchant toggle for the "Pay with Link" on-ramp, overridable by
+         * the SDK `enableStripeLink` prop. There is no dashboard control yet, so it
+         * currently resolves to `false` (SDK prop governs). Mirrors `fiat_onramp`.
+         */
+        enabled?: boolean;
+        /**
+         * Platform-controlled hard hide for the "Pay with Link" on-ramp. Defaults
+         * to false. Stripe Link's crypto on-ramp is only available in a limited set
+         * of countries (currently the US); when true, the SDK MUST hide it
+         * regardless of `enabled` or the `enableStripeLink` prop. Resolved
+         * server-side from the caller's country (`country_code` query param / IP
+         * geolocation).
+         */
+        is_hidden?: boolean;
+    };
     deposit_tracker?: {
         enabled: boolean;
     };
@@ -663,7 +680,7 @@ interface AddressBalancesResponse {
  */
 declare function getAddressBalances(address: string, chainType: ChainType, publishableKey?: string): Promise<AddressBalancesResponse>;
 /** Wallet ids supported by the connect-wallet flow. */
-type WalletMobileDeepLinkWallet = 'phantom' | 'metamask' | 'coinbase' | 'trust' | 'rainbow' | 'rabby' | 'okx';
+type WalletMobileDeepLinkWallet = 'phantom' | 'metamask' | 'coinbase' | 'trust' | 'rainbow' | 'rabby' | 'okx' | 'solflare' | 'backpack';
 /** Chain types an external wallet can connect on. */
 type ExternalWalletChainType = 'ethereum' | 'solana';
 /** A supported external (self-custody) wallet from the directory endpoint. */
@@ -1703,6 +1720,132 @@ interface CoinbaseApplePaySessionResponse {
     destination_amount?: string;
     total_fee?: number;
 }
+/**
+ * One Coinbase guest-checkout limit bucket. Field names are snake_case
+ * to match the wire format (every API response is recursively
+ * snake_cased by `TransformInterceptor` on the way out).
+ */
+interface CoinbaseApplePayLimit {
+    /** `weekly_spending` (rolling 7-day USD cap) or `lifetime_transactions` (all-time count). */
+    limit_type: 'weekly_spending' | 'lifetime_transactions';
+    /** USD for spending limits; absent for count limits. */
+    currency?: string;
+    /** Max limit value (stringified). */
+    limit: string;
+    /** Remaining capacity (`"0"` once the cap is exhausted). */
+    remaining: string;
+}
+/**
+ * State machine for a single limit-upgrade option, per Coinbase's
+ * headless-onramp limits-upgrade guide:
+ *
+ *   unrequested → user has never submitted; collect `fields` and POST
+ *                 /limits/upgrade.
+ *   pending     → submission under review by Coinbase; poll /limits
+ *                 until a terminal state.
+ *   resubmit    → previous submission was rejected but retryable;
+ *                 collect corrected `fields` and POST /limits/upgrade
+ *                 again.
+ *   active      → terminal. Upgrade approved.
+ *   inactive    → terminal. User permanently blocked; do not retry.
+ */
+type ApplePayLimitUpgradeStatus = 'unrequested' | 'pending' | 'resubmit' | 'active' | 'inactive';
+/** One available limit-upgrade option (shape is loose; Coinbase may add fields). */
+interface CoinbaseApplePayLimitUpgradeOption {
+    /** State machine value. May be absent on partial / pre-eligible responses. */
+    status?: ApplePayLimitUpgradeStatus | string;
+    /** Field keys to collect from the user (today: `ssnLast4`, `dateOfBirth`). */
+    fields?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Wire-format response from `POST /apple_pay/limits`. The two `limit_*`
+ * fields come straight from Coinbase (via our snake_casing
+ * passthrough); the two derived fields (`limit_reached`,
+ * `upgrade_status`) are appended by the SDK function for caller
+ * ergonomics — see `getCoinbaseApplePayLimits`.
+ */
+interface CoinbaseApplePayLimitsResponse {
+    limits: CoinbaseApplePayLimit[];
+    limit_upgrade_options?: CoinbaseApplePayLimitUpgradeOption[];
+    /**
+     * Convenience flag baked in by the SDK function. True iff EITHER
+     * `weekly_spending` OR `lifetime_transactions` is exhausted —
+     * Coinbase rejects a new order if it would exceed *either* cap, so
+     * either bucket at `"0"` blocks the user from transacting.
+     * Equivalent to `isApplePayLimitReached(response)`.
+     */
+    limit_reached: boolean;
+    /**
+     * Convenience flag baked in by the SDK function — the status of
+     * `limit_upgrade_options[0]` when present, `null` otherwise.
+     * Equivalent to `getApplePayLimitUpgradeStatus(response)`.
+     */
+    upgrade_status: ApplePayLimitUpgradeStatus | null;
+}
+/**
+ * True iff EITHER `weekly_spending` OR `lifetime_transactions` bucket
+ * is exhausted (`remaining === "0"`). Coinbase rejects a new order if
+ * it would exceed *either* cap — so a user with `weekly=985` but
+ * `lifetime=0` still can't transact, and we should route to the
+ * upgrade flow (or terminal screen if no upgrade is available).
+ *
+ * Defensive on missing buckets: an absent bucket is treated as "not at
+ * cap" for that dimension. All buckets absent ⇒ false (safe default —
+ * we have no evidence they're blocked).
+ */
+declare function isApplePayLimitReached(response: Pick<CoinbaseApplePayLimitsResponse, 'limits'>): boolean;
+/**
+ * Extract the upgrade option's `status` from a limits response. Returns
+ * `null` when the user has no `limit_upgrade_options` at all
+ * (ineligible) or when the upstream omits the field; the caller should
+ * treat that case the same as an `inactive` terminal — there's no
+ * upgrade path.
+ *
+ * Today Coinbase only ever returns a single entry in
+ * `limit_upgrade_options`; if that changes we'll need to scope this by
+ * payment-method type. For now indexing `[0]` is what the
+ * limits-upgrade guide itself does.
+ */
+declare function getApplePayLimitUpgradeStatus(response: Pick<CoinbaseApplePayLimitsResponse, 'limit_upgrade_options'>): ApplePayLimitUpgradeStatus | null;
+/**
+ * Fetch the user's current Apple Pay (guest-checkout) limits + any
+ * available upgrade options. Safe to call before the verification OTP —
+ * callers usually pair this with `isApplePayBothLimitsReached` to decide
+ * whether to surface the limit-upgrade flow instead of sending the SMS.
+ *
+ * @see https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/get-onramp-user-limits
+ */
+declare function getCoinbaseApplePayLimits(
+/** US phone in E.164 (e.g. `+12345678901`). */
+phone: string, publishableKey?: string, signal?: AbortSignal): Promise<CoinbaseApplePayLimitsResponse>;
+interface RequestCoinbaseApplePayLimitUpgradeRequest {
+    /** US phone in E.164. Must match a phone the user controls (Coinbase verifies via the prior OTP). */
+    phone: string;
+    fields: {
+        /** Last 4 SSN digits, no dashes/spaces. */
+        ssnLast4: string;
+        /** Zero-padded day/month, 4-digit year. */
+        dateOfBirth: {
+            day: string;
+            month: string;
+            year: string;
+        };
+    };
+}
+interface RequestCoinbaseApplePayLimitUpgradeResponse {
+    /** Always `"accepted"`. The upgrade decision is asynchronous — poll the limits endpoint. */
+    status: 'accepted';
+}
+/**
+ * Submit identity fields (DOB + SSN last 4) to request an Apple Pay limit
+ * upgrade. The decision is asynchronous on Coinbase's side; poll
+ * `getCoinbaseApplePayLimits` after this to observe whether the new caps
+ * landed.
+ *
+ * @see https://docs.cdp.coinbase.com/api-reference/v2/rest-api/onramp/request-limit-upgrade
+ */
+declare function requestCoinbaseApplePayLimitUpgrade(request: RequestCoinbaseApplePayLimitUpgradeRequest, publishableKey?: string, signal?: AbortSignal): Promise<RequestCoinbaseApplePayLimitUpgradeResponse>;
 /**
  * Create an Apple Pay onramp session. Requires a fresh `onrampToken` from
  * `exchangeOnrampVerificationToken`.
@@ -2021,4 +2164,4 @@ declare const i18n: {
 };
 type I18nStrings = typeof i18n;
 
-export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutMethod, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositMethod, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionResponse, type DirectExecutionSucceededEvent, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type ExternalWalletChainType, type ExternalWalletInfo, type ExternalWalletsResponse, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetBankTransferProvidersOptions, type GetExchangesQuery, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseLegalAgreements, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, i18n, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };
+export { ActionType, type AddressBalanceResponse, type AddressBalancesResponse, type AddressValidationFailureCode, type AddressValidationMetadata, type ApplePayLimitUpgradeStatus, type ApplePayProvider, type ApplePayProvidersResponse, type AuthenticateOAuthResult, type AutoSwapRequest, type AutoSwapResponse, type BankTransferConfig, type BankTransferProvider, type BankTransferProvidersResponse, type BlockedCountrySubdivision, type BuildHypercoreTransactionRequest, type BuildHypercoreTransactionResponse, type BuildSolanaTransactionRequest, type BuildSolanaTransactionResponse, type CashAppLimits, type CashAppSessionRequest, type CashAppSessionResponse, type CashAppSessionStatusResponse, type ChainType, type CheckoutEvent, CheckoutEventType, type CheckoutMethod, type CheckoutPaymentIntent, type CheckoutPaymentIntentData, type CheckoutPaymentIntentSucceededEvent, type CoinbaseApplePayLimit, type CoinbaseApplePayLimitUpgradeOption, type CoinbaseApplePayLimitsResponse, type CoinbaseApplePaySessionResponse, type CoinbaseLegalAgreement, type CoinbaseLegalAgreementsResponse, type ConfirmIntegrationTransferResult, type CreateCoinbaseApplePaySessionRequest, type CreateDepositAddressRequest, type CreateExchangeSessionRequest, type CreateExchangeSessionResponse, type CreateIntegrationTransferParams, type CreateIntegrationTransferResult, type CreateOnrampVerificationSessionRequest, type DefaultTokenChain, type DefaultTokenMetadata, type DefaultTokenResponse, type DepositAddressResponse, type DepositEvent, DepositEventType, type DepositMethod, type DepositQuote, type DepositQuoteRequest, type DestinationToken, type DestinationTokenChain, type DirectExecution, type DirectExecutionResponse, type DirectExecutionSucceededEvent, type EvmContractCall, type ExchangeProviderInfo, type ExchangeProvidersResponse, type ExchangeSessionStartParams, type ExchangeWalletAddress, ExecutionStatus, type ExternalWalletChainType, type ExternalWalletInfo, type ExternalWalletsResponse, type FeaturedToken, type FeaturedWallet, type FiatCurrenciesResponse, type FiatCurrency, type GetBankTransferProvidersOptions, type GetExchangesQuery, type HypercoreActivationRequest, type HypercoreActivationResponse, type I18nStrings, type IconUrl, IneligibilityReason, type IntegrationAccount, type IntegrationExchangeInfo, type IntegrationExchangesResponse, type IntegrationFeeAmount, type IntegrationHoldingsResponse, IntegrationProvider, type IpAddressResponse, type LockedQuoteLimits, type LockedQuotePreview, type LockedQuotePreviewRequest, type OnrampQuote, type OnrampQuotesRequest, type OnrampQuotesResponse, type OnrampSessionCreatedData, type OnrampSessionCreatedEvent, type OnrampSessionPaymentMethod, type OnrampSessionRequest, type OnrampSessionResponse, type OnrampVerificationFactor, type OnrampVerificationFactorStatus, type OnrampVerificationSession, type OnrampVerificationStatus, type OnrampVerificationTokenResponse, type PaymentIntent, type PaymentIntentDepositAddress, type PaymentIntentExecutionsResponse, type PaymentIntentStatus, type PaymentIntentType, type PaymentNetwork, type PollExecutionsRequest, type PollExecutionsResponse, type ProductType, type ProjectConfigResponse, type QueryExecutionsRequest, type QueryExecutionsResponse, type RefreshIntegrationTokenResult, type RequestCoinbaseApplePayLimitUpgradeRequest, type RequestCoinbaseApplePayLimitUpgradeResponse, SOLANA_USDC_ADDRESS, type SendHypercoreTransactionRequest, type SendHypercoreTransactionResponse, type SendSolanaTransactionRequest, type SendSolanaTransactionResponse, type SourceToken, type SourceTokenNetwork, type StartIntegrationOAuthResult, type StripeAccessTokenResponse, StripeApiResponseError, type StripeAuthIntentResponse, type StripeConfigResponse, type StripeConfirmRequest, type StripeConsumerWallet, type StripeCreateSessionRequest, type StripeCryptoCustomer, type StripeCustomerVerification, type StripeDefaultTokenResponse, type StripeListResponse, type StripeOnrampErrorType, type StripeOnrampSession, type StripeOnrampTransactionDetails, type StripePaymentToken, type StripeQuoteRequest, type StripeQuotesResponse, type StripeTransactionLimitEntry, type StripeTransactionLimitsResponse, type SupportedChain, type SupportedDepositTokensResponse, type SupportedDestinationTokensResponse, type SupportedSourceTokensQuery, type SupportedSourceTokensResponse, type SupportedToken, type TokenBalance, type TokenChain, type TokenChainIconUrl, type TokenChainsResponse, type TokenIconUrl, type TokenInfo, type TokenMetadata, type TransferDefaultTokenParams, type TransferDefaultTokenResult, type UserIpInfo, type VerifyAddressRequest, type VerifyAddressResponse, type Wallet, type WalletMobileDeepLinkDepositAddress, type WalletMobileDeepLinkResponse, type WalletMobileDeepLinkWallet, type WithdrawDirectExecutionSucceededEvent, type WithdrawEvent, WithdrawEventType, authenticateIntegrationOAuth, buildHypercoreTransaction, buildSolanaTransaction, checkHypercoreActivation, confirmIntegrationTransfer, createCashAppSession, createCoinbaseApplePaySession, createDepositAddress, createExchangeSession, createIntegrationTransfer, createOnrampSession, createOnrampVerificationSession, exchangeOnrampVerificationToken, formatStablecoinAmount, generateKSUID, generatePrefixedKSUID, getAddressBalance, getAddressBalances, getApiBaseUrl, getApplePayLimitUpgradeStatus, getApplePayProviders, getBankTransferProviders, getCashAppLimits, getCashAppSessionStatus, getChainName, getCoinbaseApplePayLimits, getCoinbaseLegalAgreements, getDefaultOnrampToken, getDepositAddress, getDepositQuote, getExchangeSessionStartUrl, getExchanges, getExternalWallets, getFiatCurrencies, getIconUrl, getIconUrlWithCdn, getIntegrationExchanges, getIntegrationHoldings, getIntegrationTransferDefaultToken, getIpAddress, getOnrampQuotes, getOnrampSessionStartUrl, getOnrampVerificationSession, getPreferredIconUrl, getProjectConfig, getSupportedDepositTokens, getSupportedDestinationTokens, getTokenChains, getTokenMetadata, getWalletByChainType, getWalletMobileDeepLink, i18n, isApplePayLimitReached, listPaymentIntentExecutions, pollDirectExecutions, queryExecutions, refreshIntegrationToken, requestCoinbaseApplePayLimitUpgrade, retrievePaymentIntent, revokeIntegrationToken, sendHypercoreTransaction, sendOnrampVerificationOtp, sendSolanaTransaction, setApiConfig, startIntegrationOAuth, stripeConfirmSession, stripeCreateAuthIntent, stripeCreateSession, stripeExchangeTokens, stripeGetConfig, stripeGetCustomer, stripeGetDefaultToken, stripeGetQuotes, stripeGetSession, stripeGetTransactionLimits, stripeListPaymentTokens, stripeListWallets, stripeRefreshQuote, stripeRefreshToken, useUserIp, verifyOnrampVerificationOtp, verifyRecipientAddress };

package/dist/index.js

@@ -48,11 +48,13 @@ __export(index_exports, {
   getAddressBalance: () => getAddressBalance,
   getAddressBalances: () => getAddressBalances,
   getApiBaseUrl: () => getApiBaseUrl,
+  getApplePayLimitUpgradeStatus: () => getApplePayLimitUpgradeStatus,
   getApplePayProviders: () => getApplePayProviders,
   getBankTransferProviders: () => getBankTransferProviders,
   getCashAppLimits: () => getCashAppLimits,
   getCashAppSessionStatus: () => getCashAppSessionStatus,
   getChainName: () => getChainName,
+  getCoinbaseApplePayLimits: () => getCoinbaseApplePayLimits,
   getCoinbaseLegalAgreements: () => getCoinbaseLegalAgreements,
   getDefaultOnrampToken: () => getDefaultOnrampToken,
   getDepositAddress: () => getDepositAddress,
@@ -79,10 +81,12 @@ __export(index_exports, {
   getWalletByChainType: () => getWalletByChainType,
   getWalletMobileDeepLink: () => getWalletMobileDeepLink,
   i18n: () => i18n,
+  isApplePayLimitReached: () => isApplePayLimitReached,
   listPaymentIntentExecutions: () => listPaymentIntentExecutions,
   pollDirectExecutions: () => pollDirectExecutions,
   queryExecutions: () => queryExecutions,
   refreshIntegrationToken: () => refreshIntegrationToken,
+  requestCoinbaseApplePayLimitUpgrade: () => requestCoinbaseApplePayLimitUpgrade,
   retrievePaymentIntent: () => retrievePaymentIntent,
   revokeIntegrationToken: () => revokeIntegrationToken,
   sendHypercoreTransaction: () => sendHypercoreTransaction,
@@ -1535,6 +1539,59 @@ async function getOnrampVerificationSession(id, clientSecret, publishableKey) {
   });
   return jsonOrThrow(response, "Failed to fetch verification session");
 }
+function isApplePayLimitReached(response) {
+  return response.limits.some((l) => l.remaining === "0");
+}
+function getApplePayLimitUpgradeStatus(response) {
+  const opt = response.limit_upgrade_options?.[0];
+  if (!opt || typeof opt.status !== "string") return null;
+  return opt.status;
+}
+async function getCoinbaseApplePayLimits(phone, publishableKey, signal) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/headless/coinbase/apple_pay/limits`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ phone }),
+      signal
+    }
+  );
+  const raw = await jsonOrThrow(response, "Failed to fetch Apple Pay limits");
+  return {
+    limits: raw.limits,
+    limit_upgrade_options: raw.limit_upgrade_options,
+    limit_reached: isApplePayLimitReached(raw),
+    upgrade_status: getApplePayLimitUpgradeStatus(raw)
+  };
+}
+async function requestCoinbaseApplePayLimitUpgrade(request, publishableKey, signal) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/headless/coinbase/apple_pay/limits/upgrade`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(request),
+      signal
+    }
+  );
+  return jsonOrThrow(
+    response,
+    "Failed to request Apple Pay limit upgrade"
+  );
+}
 async function createCoinbaseApplePaySession(request, onrampToken, publishableKey, signal) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -1734,11 +1791,13 @@ var i18n = en_default;
   getAddressBalance,
   getAddressBalances,
   getApiBaseUrl,
+  getApplePayLimitUpgradeStatus,
   getApplePayProviders,
   getBankTransferProviders,
   getCashAppLimits,
   getCashAppSessionStatus,
   getChainName,
+  getCoinbaseApplePayLimits,
   getCoinbaseLegalAgreements,
   getDefaultOnrampToken,
   getDepositAddress,
@@ -1765,10 +1824,12 @@ var i18n = en_default;
   getWalletByChainType,
   getWalletMobileDeepLink,
   i18n,
+  isApplePayLimitReached,
   listPaymentIntentExecutions,
   pollDirectExecutions,
   queryExecutions,
   refreshIntegrationToken,
+  requestCoinbaseApplePayLimitUpgrade,
   retrievePaymentIntent,
   revokeIntegrationToken,
   sendHypercoreTransaction,

package/dist/index.mjs

@@ -1423,6 +1423,59 @@ async function getOnrampVerificationSession(id, clientSecret, publishableKey) {
   });
   return jsonOrThrow(response, "Failed to fetch verification session");
 }
+function isApplePayLimitReached(response) {
+  return response.limits.some((l) => l.remaining === "0");
+}
+function getApplePayLimitUpgradeStatus(response) {
+  const opt = response.limit_upgrade_options?.[0];
+  if (!opt || typeof opt.status !== "string") return null;
+  return opt.status;
+}
+async function getCoinbaseApplePayLimits(phone, publishableKey, signal) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/headless/coinbase/apple_pay/limits`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ phone }),
+      signal
+    }
+  );
+  const raw = await jsonOrThrow(response, "Failed to fetch Apple Pay limits");
+  return {
+    limits: raw.limits,
+    limit_upgrade_options: raw.limit_upgrade_options,
+    limit_reached: isApplePayLimitReached(raw),
+    upgrade_status: getApplePayLimitUpgradeStatus(raw)
+  };
+}
+async function requestCoinbaseApplePayLimitUpgrade(request, publishableKey, signal) {
+  const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
+  validatePublishableKey(pk);
+  const response = await fetch(
+    `${API_BASE_URL}/v1/public/onramps/headless/coinbase/apple_pay/limits/upgrade`,
+    {
+      method: "POST",
+      headers: {
+        accept: "application/json",
+        "x-publishable-key": pk,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(request),
+      signal
+    }
+  );
+  return jsonOrThrow(
+    response,
+    "Failed to request Apple Pay limit upgrade"
+  );
+}
 async function createCoinbaseApplePaySession(request, onrampToken, publishableKey, signal) {
   const pk = publishableKey || DEFAULT_PUBLISHABLE_KEY;
   validatePublishableKey(pk);
@@ -1621,11 +1674,13 @@ export {
   getAddressBalance,
   getAddressBalances,
   getApiBaseUrl,
+  getApplePayLimitUpgradeStatus,
   getApplePayProviders,
   getBankTransferProviders,
   getCashAppLimits,
   getCashAppSessionStatus,
   getChainName,
+  getCoinbaseApplePayLimits,
   getCoinbaseLegalAgreements,
   getDefaultOnrampToken,
   getDepositAddress,
@@ -1652,10 +1707,12 @@ export {
   getWalletByChainType,
   getWalletMobileDeepLink,
   i18n,
+  isApplePayLimitReached,
   listPaymentIntentExecutions,
   pollDirectExecutions,
   queryExecutions,
   refreshIntegrationToken,
+  requestCoinbaseApplePayLimitUpgrade,
   retrievePaymentIntent,
   revokeIntegrationToken,
   sendHypercoreTransaction,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unifold/core",
-  "version": "0.1.68-beta.1",
+  "version": "0.1.68",
   "description": "Unifold Core SDK - Core types, API client, and business logic",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",