@coinlist-co/react 0.4.0 → 0.5.0

package/dist/client/hooks/index.d.cts

@@ -1,126 +0,0 @@
-import { a as CoinListClient, O as OauthClientErrorReason } from '../../coinlist-client-Cah5c_aF.cjs';
-import { a as OfferDetail, b as OfferId } from '../../requirement-XWT0T_zO.cjs';
-export { L as LoadOffersReason, a as LoadOffersState, b as LoadRequirementsReason, c as LoadRequirementsState, U as UseCoinListOffersOptions, d as UseCoinListOffersResult, e as UseCoinListRequirementsOptions, f as UseCoinListRequirementsResult, u as useCoinListOffers, g as useCoinListRequirements } from '../../useCoinListRequirements-Cuc32Tqw.cjs';
-import { A as AuthorizationCode, c as CodeVerifier, j as Participation } from '../../participation-DMMEDxON.cjs';
-
-interface UseCoinListResult {
-    /**
-     * Indicates whether the CoinList client has been initialized and ready to use.
-     * While isReady is false, then the current user state will be `unknown`.
-     */
-    isReady: boolean;
-    coinlist: CoinListClient;
-}
-declare function useCoinList(): UseCoinListResult;
-
-type LoadOfferDetailsReason = 'not-authenticated' | 'generic-error';
-type LoadOfferDetailsState = {
-    type: 'LOADING';
-} | {
-    type: 'ERROR';
-    reason: LoadOfferDetailsReason;
-} | {
-    type: 'CONTENT';
-    offerDetail: OfferDetail;
-};
-interface UseCoinListOfferDetailsOptions {
-    /**
-     * Offer detail pre-fetched on the server (e.g. via `CoinListServer.fetchOfferDetails()`).
-     * When provided, the hook uses this data as-is and skips the client-side fetch entirely.
-     */
-    serverData?: OfferDetail;
-}
-interface UseCoinListOfferDetailsResult {
-    offerDetailsState: LoadOfferDetailsState;
-}
-/**
- * Loads CoinList offer details for a given offer id and exposes a UI-friendly state.
- *
- * Pass `serverData` (pre-fetched server-side) to use that data as-is and skip
- * the client-side fetch entirely.
- *
- * Returns `LOADING` while CoinList is initializing or while details are being fetched.
- * Returns `CONTENT` with the offer when `fetchOfferDetails()` succeeds.
- * Returns `ERROR` with:
- * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
- * - `generic-error` for any other failure
- */
-declare function useCoinListOfferDetails(offerId: OfferId, options?: UseCoinListOfferDetailsOptions): UseCoinListOfferDetailsResult;
-
-/**
- * Reasons passed to {@link UseCompleteCoinListOAuthOptions.onFailure} when the
- * OAuth callback cannot be completed. Includes PKCE / redirect validation
- * errors from {@link CoinListClient.completeOAuth} and a dedicated value when
- * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails or rejects.
- */
-type CompleteCoinListOAuthFailureReason = OauthClientErrorReason | 'complete_request_failed';
-interface UseCompleteCoinListOAuthOptions {
-    /**
-     * Exchange the authorization code on your backend (e.g. POST to your API).
-     * Return `true` when the session was established successfully, `false` when
-     * the request completed but signing in failed. Rejections are treated like
-     * `false` and reported as {@link CompleteCoinListOAuthFailureReason}
-     * `"complete_request_failed"`.
-     */
-    postOAuthComplete: (payload: {
-        code: AuthorizationCode;
-        codeVerifier: CodeVerifier;
-    }) => Promise<boolean>;
-    /**
-     * Called when the user denied access (`error` query parameter), when
-     * {@link CoinListClient.completeOAuth} fails PKCE/state validation, or when
-     * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails.
-     */
-    onFailure: (reason: CompleteCoinListOAuthFailureReason) => void | Promise<void>;
-    /** Invoked after {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} succeeds and {@link CoinListClient.init} has refreshed the client session. */
-    onSuccess: () => void | Promise<void>;
-}
-/**
- * Runs the CoinList OAuth callback once on mount: validates the redirect URL via
- * {@link CoinListClient.completeOAuth}, exchanges the code via {@link UseCompleteCoinListOAuthOptions.postOAuthComplete},
- * refreshes tokens with {@link CoinListClient.init}, then calls {@link UseCompleteCoinListOAuthOptions.onSuccess}.
- *
- * Framework-agnostic: reads `window.location` like {@link CoinListClient.completeOAuth}. Supply
- * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete}, {@link UseCompleteCoinListOAuthOptions.onFailure},
- * and {@link UseCompleteCoinListOAuthOptions.onSuccess} to perform redirects or routing in your app.
- *
- * Must be used within {@link CoinListProvider}.
- */
-declare function useCompleteCoinListOAuth(options: UseCompleteCoinListOAuthOptions): void;
-
-type LoadParticipationsReason = 'not-authenticated' | 'generic-error';
-type LoadParticipationsState = {
-    type: 'LOADING';
-} | {
-    type: 'ERROR';
-    reason: LoadParticipationsReason;
-} | {
-    type: 'CONTENT';
-    participations: Participation[];
-};
-interface UseParticipationsOptions {
-    /**
-     * Participations pre-fetched on the server (e.g. via `CoinListServer.fetchAllParticipations()`).
-     * When provided, the hook uses this data as-is and skips the client-side fetch entirely.
-     */
-    serverData?: Participation[];
-}
-interface UseParticipationsResult {
-    participationsState: LoadParticipationsState;
-}
-/**
- * Loads all CoinList participations for the current user and exposes a UI-friendly state.
- * Optionally filters by offer when `offerId` is provided.
- *
- * Pass `serverData` (pre-fetched server-side) to use that data as-is and skip
- * the client-side fetch entirely.
- *
- * Returns `LOADING` while CoinList is initializing or while participations are being fetched.
- * Returns `CONTENT` with all participations when `fetchAllParticipations()` succeeds.
- * Returns `ERROR` with:
- * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
- * - `generic-error` for any other failure
- */
-declare function useParticipations(offerId?: OfferId, options?: UseParticipationsOptions): UseParticipationsResult;
-
-export { type CompleteCoinListOAuthFailureReason, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadParticipationsReason, type LoadParticipationsState, type UseCoinListOfferDetailsOptions, type UseCoinListOfferDetailsResult, type UseCompleteCoinListOAuthOptions, type UseParticipationsOptions, type UseParticipationsResult, useCoinList, useCoinListOfferDetails, useCompleteCoinListOAuth, useParticipations };

package/dist/client/hooks/index.d.ts

@@ -1,126 +0,0 @@
-import { a as CoinListClient, O as OauthClientErrorReason } from '../../coinlist-client-BSxpqylo.js';
-import { a as OfferDetail, b as OfferId } from '../../requirement-XWT0T_zO.js';
-export { L as LoadOffersReason, a as LoadOffersState, b as LoadRequirementsReason, c as LoadRequirementsState, U as UseCoinListOffersOptions, d as UseCoinListOffersResult, e as UseCoinListRequirementsOptions, f as UseCoinListRequirementsResult, u as useCoinListOffers, g as useCoinListRequirements } from '../../useCoinListRequirements-B5-ZPOMz.js';
-import { A as AuthorizationCode, c as CodeVerifier, j as Participation } from '../../participation-E-bT-GXJ.js';
-
-interface UseCoinListResult {
-    /**
-     * Indicates whether the CoinList client has been initialized and ready to use.
-     * While isReady is false, then the current user state will be `unknown`.
-     */
-    isReady: boolean;
-    coinlist: CoinListClient;
-}
-declare function useCoinList(): UseCoinListResult;
-
-type LoadOfferDetailsReason = 'not-authenticated' | 'generic-error';
-type LoadOfferDetailsState = {
-    type: 'LOADING';
-} | {
-    type: 'ERROR';
-    reason: LoadOfferDetailsReason;
-} | {
-    type: 'CONTENT';
-    offerDetail: OfferDetail;
-};
-interface UseCoinListOfferDetailsOptions {
-    /**
-     * Offer detail pre-fetched on the server (e.g. via `CoinListServer.fetchOfferDetails()`).
-     * When provided, the hook uses this data as-is and skips the client-side fetch entirely.
-     */
-    serverData?: OfferDetail;
-}
-interface UseCoinListOfferDetailsResult {
-    offerDetailsState: LoadOfferDetailsState;
-}
-/**
- * Loads CoinList offer details for a given offer id and exposes a UI-friendly state.
- *
- * Pass `serverData` (pre-fetched server-side) to use that data as-is and skip
- * the client-side fetch entirely.
- *
- * Returns `LOADING` while CoinList is initializing or while details are being fetched.
- * Returns `CONTENT` with the offer when `fetchOfferDetails()` succeeds.
- * Returns `ERROR` with:
- * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
- * - `generic-error` for any other failure
- */
-declare function useCoinListOfferDetails(offerId: OfferId, options?: UseCoinListOfferDetailsOptions): UseCoinListOfferDetailsResult;
-
-/**
- * Reasons passed to {@link UseCompleteCoinListOAuthOptions.onFailure} when the
- * OAuth callback cannot be completed. Includes PKCE / redirect validation
- * errors from {@link CoinListClient.completeOAuth} and a dedicated value when
- * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails or rejects.
- */
-type CompleteCoinListOAuthFailureReason = OauthClientErrorReason | 'complete_request_failed';
-interface UseCompleteCoinListOAuthOptions {
-    /**
-     * Exchange the authorization code on your backend (e.g. POST to your API).
-     * Return `true` when the session was established successfully, `false` when
-     * the request completed but signing in failed. Rejections are treated like
-     * `false` and reported as {@link CompleteCoinListOAuthFailureReason}
-     * `"complete_request_failed"`.
-     */
-    postOAuthComplete: (payload: {
-        code: AuthorizationCode;
-        codeVerifier: CodeVerifier;
-    }) => Promise<boolean>;
-    /**
-     * Called when the user denied access (`error` query parameter), when
-     * {@link CoinListClient.completeOAuth} fails PKCE/state validation, or when
-     * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails.
-     */
-    onFailure: (reason: CompleteCoinListOAuthFailureReason) => void | Promise<void>;
-    /** Invoked after {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} succeeds and {@link CoinListClient.init} has refreshed the client session. */
-    onSuccess: () => void | Promise<void>;
-}
-/**
- * Runs the CoinList OAuth callback once on mount: validates the redirect URL via
- * {@link CoinListClient.completeOAuth}, exchanges the code via {@link UseCompleteCoinListOAuthOptions.postOAuthComplete},
- * refreshes tokens with {@link CoinListClient.init}, then calls {@link UseCompleteCoinListOAuthOptions.onSuccess}.
- *
- * Framework-agnostic: reads `window.location` like {@link CoinListClient.completeOAuth}. Supply
- * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete}, {@link UseCompleteCoinListOAuthOptions.onFailure},
- * and {@link UseCompleteCoinListOAuthOptions.onSuccess} to perform redirects or routing in your app.
- *
- * Must be used within {@link CoinListProvider}.
- */
-declare function useCompleteCoinListOAuth(options: UseCompleteCoinListOAuthOptions): void;
-
-type LoadParticipationsReason = 'not-authenticated' | 'generic-error';
-type LoadParticipationsState = {
-    type: 'LOADING';
-} | {
-    type: 'ERROR';
-    reason: LoadParticipationsReason;
-} | {
-    type: 'CONTENT';
-    participations: Participation[];
-};
-interface UseParticipationsOptions {
-    /**
-     * Participations pre-fetched on the server (e.g. via `CoinListServer.fetchAllParticipations()`).
-     * When provided, the hook uses this data as-is and skips the client-side fetch entirely.
-     */
-    serverData?: Participation[];
-}
-interface UseParticipationsResult {
-    participationsState: LoadParticipationsState;
-}
-/**
- * Loads all CoinList participations for the current user and exposes a UI-friendly state.
- * Optionally filters by offer when `offerId` is provided.
- *
- * Pass `serverData` (pre-fetched server-side) to use that data as-is and skip
- * the client-side fetch entirely.
- *
- * Returns `LOADING` while CoinList is initializing or while participations are being fetched.
- * Returns `CONTENT` with all participations when `fetchAllParticipations()` succeeds.
- * Returns `ERROR` with:
- * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
- * - `generic-error` for any other failure
- */
-declare function useParticipations(offerId?: OfferId, options?: UseParticipationsOptions): UseParticipationsResult;
-
-export { type CompleteCoinListOAuthFailureReason, type LoadOfferDetailsReason, type LoadOfferDetailsState, type LoadParticipationsReason, type LoadParticipationsState, type UseCoinListOfferDetailsOptions, type UseCoinListOfferDetailsResult, type UseCompleteCoinListOAuthOptions, type UseParticipationsOptions, type UseParticipationsResult, useCoinList, useCoinListOfferDetails, useCompleteCoinListOAuth, useParticipations };

package/dist/client/hooks/index.js

@@ -1,19 +0,0 @@
-import {
-  useCoinList,
-  useCoinListOfferDetails,
-  useCoinListOffers,
-  useCoinListRequirements,
-  useCompleteCoinListOAuth,
-  useParticipations
-} from "../../chunk-UGJUTRXC.js";
-import "../../chunk-RIFATQB5.js";
-import "../../chunk-NC45IO63.js";
-export {
-  useCoinList,
-  useCoinListOfferDetails,
-  useCoinListOffers,
-  useCoinListRequirements,
-  useCompleteCoinListOAuth,
-  useParticipations
-};
-//# sourceMappingURL=index.js.map

package/dist/client/hooks/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/coinlist-client-BSxpqylo.d.ts

@@ -1,158 +0,0 @@
-import { A as AuthorizationCode, c as CodeVerifier, o as Config, O as OAuthAccessToken, i as PaginationParams, P as PaginatedResponse, j as Participation, m as ParticipationsPaginationParams, k as ParticipationId, d as CreateParticipationParams } from './participation-E-bT-GXJ.js';
-import { O as Offer, b as OfferId, a as OfferDetail, d as OfferOptionId, R as Requirement, h as RequirementStatusInfo } from './requirement-XWT0T_zO.js';
-
-type AuthState = 'unknown' | 'logged-in' | 'logged-out';
-/** Discriminated error reasons from {@link CoinListClient.completeOAuth}. */
-type OauthClientErrorReason = 'user_canceled' | 'missing_state' | 'invalid_state' | 'missing_code' | 'missing_code_verifier';
-type OauthClientResult = {
-    type: 'ok';
-    code: AuthorizationCode;
-    codeVerifier: CodeVerifier;
-} | {
-    type: 'error';
-    reason: OauthClientErrorReason;
-};
-
-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
-     * {@link CoinListServer#accessToken} from `@/server/coinlist.server`.
-     */
-    getAccessToken: () => Promise<OAuthAccessToken | null>;
-    /**
-     * Recommended to leave undefined. Used to change the CoinList environment;
-     * default is production.
-     */
-    coinlistBaseUrl?: string;
-}
-interface CoinListClient {
-    /**
-     * Calls the provided {@link ClientConfig.getAccessToken} lambda to determine
-     * 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.
-     */
-    init(): Promise<AuthState>;
-    /**
-     * Returns the current auth state: `'logged-in'`, `'logged-out'`, or `'unknown'`.
-     * Returns **unknown** until {@link CoinListClient.init} has completed. It is
-     * recommended to use the `const { isReady, coinlist } = useCoinList()` hook to know when
-     * the SDK has initialized, or to manually await {@link CoinListClient.init}
-     * before relying on this value.
-     */
-    getAuthState(): AuthState;
-    /**
-     * Starts the OAuth flow with PKCE. Generates a random `state` and `code_verifier`,
-     * stores them in sessionStorage (for validation in {@link CoinListClient.completeOAuth}
-     * on redirect), then redirects the user to the CoinList authorization page. After
-     * the user authorizes, they are sent back to your application's redirect URI; call
-     * {@link CoinListClient.completeOAuth} on that page to finish the flow.
-     */
-    startOAuth(): Promise<void>;
-    /**
-     * Completes the OAuth flow on the FE with PKCE and state validation. Parses the
-     * redirect URL (state, code) and validates them against sessionStorage
-     * (state, code_verifier). The state check protects against CSRF (cross-site
-     * request forgery). Call this on the frontend page the user is redirected
-     * to after authorizing.
-     *
-     * On `ok`: Call your backend to exchange the short-lived `authorizationCode`
-     * (and the returned `codeVerifier`) for a long-lived session. If your backend
-     * is in TypeScript, you can use {@link CoinListServer#completeOAuth} from
-     * `@/server/coinlist.server` (CoinListServer) to perform that exchange.
-     *
-     * On `error`: `reason` is an {@link OauthClientErrorReason} (e.g. `'missing_state'`, `'invalid_state'`) so you can switch on it and surface a message to the user.
-     */
-    completeOAuth(): OauthClientResult;
-    /**
-     * Clears the in-memory access token. Note: you need to manually
-     * also logout on the backend via CoinListServer#logout to clear the session cookie.
-     */
-    logout(): void;
-    /**
-     * Fetches all offers by iterating through every paginated response.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchAllOffers(): Promise<Offer[]>;
-    /**
-     * Fetches a single page of offers.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOffersPage(params: PaginationParams): Promise<PaginatedResponse<Offer>>;
-    /**
-     * Fetches details for a given offer by its id.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOfferDetails(id: OfferId): Promise<OfferDetail>;
-    /**
-     * Fetches all participations by iterating through every paginated response.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchAllParticipations(offerId?: OfferId): Promise<Participation[]>;
-    /**
-     * Fetches a single page of participations, optionally filtered by offer.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchParticipationsPage(params: ParticipationsPaginationParams): Promise<PaginatedResponse<Participation>>;
-    /**
-     * Fetches a participation by id.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchParticipation(id: ParticipationId): Promise<Participation>;
-    /**
-     * Creates a participation.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    createParticipation(params: CreateParticipationParams): Promise<Participation>;
-    /**
-     * Fetches the requirements for all options of a given offer, grouped by option ID.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOfferRequirements(offerId: OfferId): Promise<Record<OfferOptionId, Requirement[]>>;
-    /**
-     * Fetches the user's requirement statuses for a given offer.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchRequirementStatuses(offerId: OfferId): Promise<RequirementStatusInfo[]>;
-    /**
-     * Opens the CoinList page for completing a given requirement in a new tab.
-     * For `jurisdiction` requirements there is no CTA, so this is a no-op.
-     */
-    handleRequirement(requirement: Requirement): void;
-    /**
-     * Opens the CoinList support ticket page in a new tab.
-     */
-    contactSupport(): void;
-}
-declare function createCoinListClient(config: ClientConfig): CoinListClient;
-
-export { type AuthState as A, type ClientConfig as C, type OauthClientErrorReason as O, type CoinListClient as a, type OauthClientResult as b, createCoinListClient as c };

package/dist/coinlist-client-Cah5c_aF.d.cts

@@ -1,158 +0,0 @@
-import { A as AuthorizationCode, c as CodeVerifier, o as Config, O as OAuthAccessToken, i as PaginationParams, P as PaginatedResponse, j as Participation, m as ParticipationsPaginationParams, k as ParticipationId, d as CreateParticipationParams } from './participation-DMMEDxON.cjs';
-import { O as Offer, b as OfferId, a as OfferDetail, d as OfferOptionId, R as Requirement, h as RequirementStatusInfo } from './requirement-XWT0T_zO.cjs';
-
-type AuthState = 'unknown' | 'logged-in' | 'logged-out';
-/** Discriminated error reasons from {@link CoinListClient.completeOAuth}. */
-type OauthClientErrorReason = 'user_canceled' | 'missing_state' | 'invalid_state' | 'missing_code' | 'missing_code_verifier';
-type OauthClientResult = {
-    type: 'ok';
-    code: AuthorizationCode;
-    codeVerifier: CodeVerifier;
-} | {
-    type: 'error';
-    reason: OauthClientErrorReason;
-};
-
-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
-     * {@link CoinListServer#accessToken} from `@/server/coinlist.server`.
-     */
-    getAccessToken: () => Promise<OAuthAccessToken | null>;
-    /**
-     * Recommended to leave undefined. Used to change the CoinList environment;
-     * default is production.
-     */
-    coinlistBaseUrl?: string;
-}
-interface CoinListClient {
-    /**
-     * Calls the provided {@link ClientConfig.getAccessToken} lambda to determine
-     * 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.
-     */
-    init(): Promise<AuthState>;
-    /**
-     * Returns the current auth state: `'logged-in'`, `'logged-out'`, or `'unknown'`.
-     * Returns **unknown** until {@link CoinListClient.init} has completed. It is
-     * recommended to use the `const { isReady, coinlist } = useCoinList()` hook to know when
-     * the SDK has initialized, or to manually await {@link CoinListClient.init}
-     * before relying on this value.
-     */
-    getAuthState(): AuthState;
-    /**
-     * Starts the OAuth flow with PKCE. Generates a random `state` and `code_verifier`,
-     * stores them in sessionStorage (for validation in {@link CoinListClient.completeOAuth}
-     * on redirect), then redirects the user to the CoinList authorization page. After
-     * the user authorizes, they are sent back to your application's redirect URI; call
-     * {@link CoinListClient.completeOAuth} on that page to finish the flow.
-     */
-    startOAuth(): Promise<void>;
-    /**
-     * Completes the OAuth flow on the FE with PKCE and state validation. Parses the
-     * redirect URL (state, code) and validates them against sessionStorage
-     * (state, code_verifier). The state check protects against CSRF (cross-site
-     * request forgery). Call this on the frontend page the user is redirected
-     * to after authorizing.
-     *
-     * On `ok`: Call your backend to exchange the short-lived `authorizationCode`
-     * (and the returned `codeVerifier`) for a long-lived session. If your backend
-     * is in TypeScript, you can use {@link CoinListServer#completeOAuth} from
-     * `@/server/coinlist.server` (CoinListServer) to perform that exchange.
-     *
-     * On `error`: `reason` is an {@link OauthClientErrorReason} (e.g. `'missing_state'`, `'invalid_state'`) so you can switch on it and surface a message to the user.
-     */
-    completeOAuth(): OauthClientResult;
-    /**
-     * Clears the in-memory access token. Note: you need to manually
-     * also logout on the backend via CoinListServer#logout to clear the session cookie.
-     */
-    logout(): void;
-    /**
-     * Fetches all offers by iterating through every paginated response.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchAllOffers(): Promise<Offer[]>;
-    /**
-     * Fetches a single page of offers.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOffersPage(params: PaginationParams): Promise<PaginatedResponse<Offer>>;
-    /**
-     * Fetches details for a given offer by its id.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOfferDetails(id: OfferId): Promise<OfferDetail>;
-    /**
-     * Fetches all participations by iterating through every paginated response.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchAllParticipations(offerId?: OfferId): Promise<Participation[]>;
-    /**
-     * Fetches a single page of participations, optionally filtered by offer.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchParticipationsPage(params: ParticipationsPaginationParams): Promise<PaginatedResponse<Participation>>;
-    /**
-     * Fetches a participation by id.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchParticipation(id: ParticipationId): Promise<Participation>;
-    /**
-     * Creates a participation.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    createParticipation(params: CreateParticipationParams): Promise<Participation>;
-    /**
-     * Fetches the requirements for all options of a given offer, grouped by option ID.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOfferRequirements(offerId: OfferId): Promise<Record<OfferOptionId, Requirement[]>>;
-    /**
-     * Fetches the user's requirement statuses for a given offer.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchRequirementStatuses(offerId: OfferId): Promise<RequirementStatusInfo[]>;
-    /**
-     * Opens the CoinList page for completing a given requirement in a new tab.
-     * For `jurisdiction` requirements there is no CTA, so this is a no-op.
-     */
-    handleRequirement(requirement: Requirement): void;
-    /**
-     * Opens the CoinList support ticket page in a new tab.
-     */
-    contactSupport(): void;
-}
-declare function createCoinListClient(config: ClientConfig): CoinListClient;
-
-export { type AuthState as A, type ClientConfig as C, type OauthClientErrorReason as O, type CoinListClient as a, type OauthClientResult as b, createCoinListClient as c };