@coinlist-co/react 0.12.1 → 0.12.2-rc.0fda52c

package/dist/client/index.d.cts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, ButtonHTMLAttributes } from 'react';
-import { A as AuthorizationCode, C as CodeVerifier, L as Logger, W as WalletError, E as Erc20Namespace, a as EthereumChain, b as EvmContractAddress, B as BlockchainAmount, c as CoinListTokenSaleNamespace, O as OfferId, d as OfferOptionId, e as AssetId, P as Participation, f as CoinListTokenSaleNamespaceImpl, U as UniversalNamespaceContext, g as OndoNamespace, h as AssetSymbol, i as OfferSwapContract, j as OndoBuyTransaction, k as OndoSellTransaction, l as OndoSwapTransactionCore, m as OrderBookSide, n as OndoNamespaceImpl, S as SuperstateSwapNamespace, o as WalletsNamespace, p as Bps, q as EvmWalletAddress, r as SuperstateSwapNamespaceImpl, R as RequirementsNamespace, s as Requirement, t as RequirementsNamespaceImpl, u as Config, v as OAuthAccessToken, w as OffersNamespace, T as TokensNamespace, x as StablecoinSymbol, y as Erc20Asset, z as OfferDetail, D as TokenMetadata, F as OfferType, G as OndoSwapOfferDetail, H as CoinListTokenSaleOfferDetail, I as SuperstateSwapOfferDetail, J as Offer, K as RequirementStatusInfo, M as RequirementType, N as RequirementStatusValue, Q as OfferOptionAddress, V as RequirementId, X as KycLevelName, Y as DocumentSubmission, Z as WalletChallengeType, _ as PinoLoggerOptions, $ as OndoTradingStatus, a0 as AssetDecimals, a1 as BuildOndoBuyParams, a2 as BuildOndoSellParams, a3 as OndoQuote, a4 as OndoQuoteSize, a5 as TokenIdentifier, a6 as OfferOptionAddressId, a7 as TokenLogo } from '../tokens-namespace-CIWBtgt2.cjs';
-export { a8 as DebugEvent, a9 as FrontlineEventId, aa as HttpError, ab as HttpResponse, ac as KycToken, ad as LogBinding, ae as LogBindings, af as LogCause, ag as LogLevel, ah as LogScope, ai as LogValue, aj as ProductionLogLevel, ak as RedactedWalletError, al as RequestId, am as RpcFailureReason, an as SafeEvent, ao as SafeFields, ap as UnredactedFields } from '../tokens-namespace-CIWBtgt2.cjs';
-import { P as PKCEConfig, E as EvmWallet, S as SwapQuote, A as AssetIconUrl, a as ShortenedWalletAddress, F as FormattedAmountAssetUi, b as FormattedPercentUi, T as TxExplorerUrl, C as ConnectWallet, N as NonEmptyArray, c as TokenRegistrySnapshot } from '../token-registry-snapshot-CqI6dXM_.cjs';
-export { B as BroadcastTxParams, d as EvmSigner, W as WriteContractParams } from '../token-registry-snapshot-CqI6dXM_.cjs';
+import { A as AuthorizationCode, C as CodeVerifier, L as Logger, W as WalletError, E as Erc20Namespace, a as EthereumChain, b as EvmContractAddress, B as BlockchainAmount, c as CoinListTokenSaleNamespace, O as OfferId, d as OfferOptionId, e as AssetId, P as Participation, f as CoinListTokenSaleNamespaceImpl, U as UniversalNamespaceContext, g as OndoNamespace, h as AssetSymbol, i as OfferSwapContract, j as OndoBuyTransaction, k as OndoSellTransaction, l as OndoSwapTransactionCore, m as OrderBookSide, n as OndoNamespaceImpl, S as SuperstateSwapNamespace, o as WalletsNamespace, p as Bps, q as EvmWalletAddress, r as SuperstateSwapNamespaceImpl, R as RequirementsNamespace, s as Requirement, t as RequirementsNamespaceImpl, u as Config, v as OAuthAccessToken, w as OffersNamespace, T as TokensNamespace, x as StablecoinSymbol, y as Erc20Asset, z as OfferDetail, D as TokenMetadata, F as OfferType, G as OndoSwapOfferDetail, H as CoinListTokenSaleOfferDetail, I as SuperstateSwapOfferDetail, J as Offer, K as RequirementStatusInfo, M as RequirementType, N as RequirementStatusValue, Q as OfferOptionAddress, V as RequirementId, X as KycLevelName, Y as DocumentSubmission, Z as WalletChallengeType, _ as PinoLoggerOptions, $ as OndoTradingStatus, a0 as AssetDecimals, a1 as BuildOndoBuyParams, a2 as BuildOndoSellParams, a3 as OndoQuote, a4 as OndoQuoteSize, a5 as TokenIdentifier, a6 as OfferOptionAddressId, a7 as TokenLogo } from '../tokens-namespace-BJfFeowE.cjs';
+export { a8 as DebugEvent, a9 as FrontlineEventId, aa as HttpError, ab as HttpResponse, ac as KycToken, ad as LogBinding, ae as LogBindings, af as LogCause, ag as LogLevel, ah as LogScope, ai as LogValue, aj as ProductionLogLevel, ak as RedactedWalletError, al as RequestId, am as RpcFailureReason, an as SafeEvent, ao as SafeFields, ap as UnredactedFields } from '../tokens-namespace-BJfFeowE.cjs';
+import { P as PKCEConfig, E as EvmWallet, S as SwapQuote, A as AssetIconUrl, a as ShortenedWalletAddress, F as FormattedAmountAssetUi, b as FormattedPercentUi, T as TxExplorerUrl, C as ConnectWallet, N as NonEmptyArray, c as TokenRegistrySnapshot } from '../token-registry-snapshot-DyjrA32p.cjs';
+export { B as BroadcastTxParams, d as EvmSigner, W as WriteContractParams } from '../token-registry-snapshot-DyjrA32p.cjs';
 import { Hash } from 'viem';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
@@ -698,10 +698,24 @@ declare class ClientSupportNamespaceImpl implements ClientSupportNamespace {
 
 interface ClientConfig extends Config {
     /**
-     * The SDK user must provide this function. It is responsible for fetching a
-     * valid {@link OAuthAccessToken}, or **null** for logged-out users. If your
-     * backend is in TypeScript, it is recommended to use
-     * `CoinListServer#auth.getAccessToken` from `@/server/core/coinlist-server`.
+     * The SDK user must provide this function. It fetches a valid
+     * {@link OAuthAccessToken} from your backend. If your backend is in
+     * TypeScript, serve `CoinListServer#auth.getAccessToken` from it.
+     *
+     * Two answers, and they must not be confused:
+     *
+     * - **Resolve `null`** when there is no session - e.g. your endpoint
+     *   answered 204. After a 401 the SDK asks once more a second later before
+     *   it believes it, then signs the user out and calls
+     *   {@link Config.onSessionExpired}.
+     * - **Throw** when you could not find out - a 5xx, a network failure. The
+     *   SDK keeps its current auth state and fails only the request in hand.
+     *
+     * So a backend that answers "no session" for its own failures turns every
+     * outage into a logout. Map those to an error status and throw on it.
+     *
+     * The SDK calls this at most once at a time: concurrent requests that all
+     * need a new token share one call.
      */
     getAccessToken: () => Promise<OAuthAccessToken | null>;
     /**
@@ -810,6 +824,10 @@ interface CoinListClient {
      * the user's {@link AuthState}. This is called automatically by
      * {@link CoinListProvider}; you typically do not need to call it yourself
      * unless you are using the client outside of the provider.
+     *
+     * @throws whatever {@link ClientConfig.getAccessToken} throws. The auth
+     * state is then left as it was (`'unknown'` on a first call), since a
+     * failure to find out is not a logout.
      */
     init(): Promise<AuthState>;
 }
@@ -2786,9 +2804,9 @@ interface SuperstateAmountViewProps {
  * Step 2 of the Superstate checkout. Pure: amounts arrive already formatted,
  * and every interaction leaves through `onEvent`.
  *
- * The field is dollar-denominated, so the `$` goes in `CheckoutAmountInput`'s
- * `prefix` slot — where Ondo puts the symbol of the token it charges. Nothing
- * here is submitted: confirming only moves the flow to the review step.
+ * The field is dollar-denominated, so the `$` leads the number via
+ * `CheckoutAmountInput`'s `prefix` slot. Nothing here is submitted: confirming
+ * only moves the flow to the review step.
  *
  * Self-scoped: renders fully styled on its own, with no `CoinListStyleScope`
  * needed around it.
@@ -2977,8 +2995,6 @@ type SuperstateOrderConfirmedUiState = {
     type: 'visible';
     /** What was bought. */
     asset: CheckoutAssetUi;
-    /** Who issues it, e.g. `Superstate`. */
-    issuer: string;
     /** How much of it arrived, e.g. `981.2431 USTB`. */
     outputAmount: FormattedAmountAssetUi;
     /**

package/dist/client/index.d.ts

@@ -1,9 +1,9 @@
 import * as react from 'react';
 import { ReactNode, ButtonHTMLAttributes } from 'react';
-import { A as AuthorizationCode, C as CodeVerifier, L as Logger, W as WalletError, E as Erc20Namespace, a as EthereumChain, b as EvmContractAddress, B as BlockchainAmount, c as CoinListTokenSaleNamespace, O as OfferId, d as OfferOptionId, e as AssetId, P as Participation, f as CoinListTokenSaleNamespaceImpl, U as UniversalNamespaceContext, g as OndoNamespace, h as AssetSymbol, i as OfferSwapContract, j as OndoBuyTransaction, k as OndoSellTransaction, l as OndoSwapTransactionCore, m as OrderBookSide, n as OndoNamespaceImpl, S as SuperstateSwapNamespace, o as WalletsNamespace, p as Bps, q as EvmWalletAddress, r as SuperstateSwapNamespaceImpl, R as RequirementsNamespace, s as Requirement, t as RequirementsNamespaceImpl, u as Config, v as OAuthAccessToken, w as OffersNamespace, T as TokensNamespace, x as StablecoinSymbol, y as Erc20Asset, z as OfferDetail, D as TokenMetadata, F as OfferType, G as OndoSwapOfferDetail, H as CoinListTokenSaleOfferDetail, I as SuperstateSwapOfferDetail, J as Offer, K as RequirementStatusInfo, M as RequirementType, N as RequirementStatusValue, Q as OfferOptionAddress, V as RequirementId, X as KycLevelName, Y as DocumentSubmission, Z as WalletChallengeType, _ as PinoLoggerOptions, $ as OndoTradingStatus, a0 as AssetDecimals, a1 as BuildOndoBuyParams, a2 as BuildOndoSellParams, a3 as OndoQuote, a4 as OndoQuoteSize, a5 as TokenIdentifier, a6 as OfferOptionAddressId, a7 as TokenLogo } from '../tokens-namespace-CIWBtgt2.js';
-export { a8 as DebugEvent, a9 as FrontlineEventId, aa as HttpError, ab as HttpResponse, ac as KycToken, ad as LogBinding, ae as LogBindings, af as LogCause, ag as LogLevel, ah as LogScope, ai as LogValue, aj as ProductionLogLevel, ak as RedactedWalletError, al as RequestId, am as RpcFailureReason, an as SafeEvent, ao as SafeFields, ap as UnredactedFields } from '../tokens-namespace-CIWBtgt2.js';
-import { P as PKCEConfig, E as EvmWallet, S as SwapQuote, A as AssetIconUrl, a as ShortenedWalletAddress, F as FormattedAmountAssetUi, b as FormattedPercentUi, T as TxExplorerUrl, C as ConnectWallet, N as NonEmptyArray, c as TokenRegistrySnapshot } from '../token-registry-snapshot-BNBNuDu1.js';
-export { B as BroadcastTxParams, d as EvmSigner, W as WriteContractParams } from '../token-registry-snapshot-BNBNuDu1.js';
+import { A as AuthorizationCode, C as CodeVerifier, L as Logger, W as WalletError, E as Erc20Namespace, a as EthereumChain, b as EvmContractAddress, B as BlockchainAmount, c as CoinListTokenSaleNamespace, O as OfferId, d as OfferOptionId, e as AssetId, P as Participation, f as CoinListTokenSaleNamespaceImpl, U as UniversalNamespaceContext, g as OndoNamespace, h as AssetSymbol, i as OfferSwapContract, j as OndoBuyTransaction, k as OndoSellTransaction, l as OndoSwapTransactionCore, m as OrderBookSide, n as OndoNamespaceImpl, S as SuperstateSwapNamespace, o as WalletsNamespace, p as Bps, q as EvmWalletAddress, r as SuperstateSwapNamespaceImpl, R as RequirementsNamespace, s as Requirement, t as RequirementsNamespaceImpl, u as Config, v as OAuthAccessToken, w as OffersNamespace, T as TokensNamespace, x as StablecoinSymbol, y as Erc20Asset, z as OfferDetail, D as TokenMetadata, F as OfferType, G as OndoSwapOfferDetail, H as CoinListTokenSaleOfferDetail, I as SuperstateSwapOfferDetail, J as Offer, K as RequirementStatusInfo, M as RequirementType, N as RequirementStatusValue, Q as OfferOptionAddress, V as RequirementId, X as KycLevelName, Y as DocumentSubmission, Z as WalletChallengeType, _ as PinoLoggerOptions, $ as OndoTradingStatus, a0 as AssetDecimals, a1 as BuildOndoBuyParams, a2 as BuildOndoSellParams, a3 as OndoQuote, a4 as OndoQuoteSize, a5 as TokenIdentifier, a6 as OfferOptionAddressId, a7 as TokenLogo } from '../tokens-namespace-BJfFeowE.js';
+export { a8 as DebugEvent, a9 as FrontlineEventId, aa as HttpError, ab as HttpResponse, ac as KycToken, ad as LogBinding, ae as LogBindings, af as LogCause, ag as LogLevel, ah as LogScope, ai as LogValue, aj as ProductionLogLevel, ak as RedactedWalletError, al as RequestId, am as RpcFailureReason, an as SafeEvent, ao as SafeFields, ap as UnredactedFields } from '../tokens-namespace-BJfFeowE.js';
+import { P as PKCEConfig, E as EvmWallet, S as SwapQuote, A as AssetIconUrl, a as ShortenedWalletAddress, F as FormattedAmountAssetUi, b as FormattedPercentUi, T as TxExplorerUrl, C as ConnectWallet, N as NonEmptyArray, c as TokenRegistrySnapshot } from '../token-registry-snapshot-C1NxdBmF.js';
+export { B as BroadcastTxParams, d as EvmSigner, W as WriteContractParams } from '../token-registry-snapshot-C1NxdBmF.js';
 import { Hash } from 'viem';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
@@ -698,10 +698,24 @@ declare class ClientSupportNamespaceImpl implements ClientSupportNamespace {
 
 interface ClientConfig extends Config {
     /**
-     * The SDK user must provide this function. It is responsible for fetching a
-     * valid {@link OAuthAccessToken}, or **null** for logged-out users. If your
-     * backend is in TypeScript, it is recommended to use
-     * `CoinListServer#auth.getAccessToken` from `@/server/core/coinlist-server`.
+     * The SDK user must provide this function. It fetches a valid
+     * {@link OAuthAccessToken} from your backend. If your backend is in
+     * TypeScript, serve `CoinListServer#auth.getAccessToken` from it.
+     *
+     * Two answers, and they must not be confused:
+     *
+     * - **Resolve `null`** when there is no session - e.g. your endpoint
+     *   answered 204. After a 401 the SDK asks once more a second later before
+     *   it believes it, then signs the user out and calls
+     *   {@link Config.onSessionExpired}.
+     * - **Throw** when you could not find out - a 5xx, a network failure. The
+     *   SDK keeps its current auth state and fails only the request in hand.
+     *
+     * So a backend that answers "no session" for its own failures turns every
+     * outage into a logout. Map those to an error status and throw on it.
+     *
+     * The SDK calls this at most once at a time: concurrent requests that all
+     * need a new token share one call.
      */
     getAccessToken: () => Promise<OAuthAccessToken | null>;
     /**
@@ -810,6 +824,10 @@ interface CoinListClient {
      * the user's {@link AuthState}. This is called automatically by
      * {@link CoinListProvider}; you typically do not need to call it yourself
      * unless you are using the client outside of the provider.
+     *
+     * @throws whatever {@link ClientConfig.getAccessToken} throws. The auth
+     * state is then left as it was (`'unknown'` on a first call), since a
+     * failure to find out is not a logout.
      */
     init(): Promise<AuthState>;
 }
@@ -2786,9 +2804,9 @@ interface SuperstateAmountViewProps {
  * Step 2 of the Superstate checkout. Pure: amounts arrive already formatted,
  * and every interaction leaves through `onEvent`.
  *
- * The field is dollar-denominated, so the `$` goes in `CheckoutAmountInput`'s
- * `prefix` slot — where Ondo puts the symbol of the token it charges. Nothing
- * here is submitted: confirming only moves the flow to the review step.
+ * The field is dollar-denominated, so the `$` leads the number via
+ * `CheckoutAmountInput`'s `prefix` slot. Nothing here is submitted: confirming
+ * only moves the flow to the review step.
  *
  * Self-scoped: renders fully styled on its own, with no `CoinListStyleScope`
  * needed around it.
@@ -2977,8 +2995,6 @@ type SuperstateOrderConfirmedUiState = {
     type: 'visible';
     /** What was bought. */
     asset: CheckoutAssetUi;
-    /** Who issues it, e.g. `Superstate`. */
-    issuer: string;
     /** How much of it arrived, e.g. `981.2431 USTB`. */
     outputAmount: FormattedAmountAssetUi;
     /**