@coinlist-co/react 0.2.0 → 0.4.0

package/dist/client/hooks/index.cjs

@@ -23,7 +23,9 @@ __export(hooks_exports, {
   useCoinList: () => useCoinList,
   useCoinListOfferDetails: () => useCoinListOfferDetails,
   useCoinListOffers: () => useCoinListOffers,
-  useCompleteCoinListOAuth: () => useCompleteCoinListOAuth
+  useCoinListRequirements: () => useCoinListRequirements,
+  useCompleteCoinListOAuth: () => useCompleteCoinListOAuth,
+  useParticipations: () => useParticipations
 });
 module.exports = __toCommonJS(hooks_exports);
 
@@ -66,13 +68,23 @@ var CoinListClientInitializationError = class extends Error {
 // src/client/hooks/useCoinListOfferDetails.ts
 var import_react3 = require("react");
 var LOADING_STATE = { type: "LOADING" };
-function useCoinListOfferDetails(offerId) {
+function useCoinListOfferDetails(offerId, options = {}) {
   const { coinlist, isReady } = useCoinList();
-  const [offerDetailsState, setOfferDetailsState] = (0, import_react3.useState)(LOADING_STATE);
+  const { serverData } = options;
+  const [offerDetailsState, setOfferDetailsState] = (0, import_react3.useState)(
+    serverData !== void 0 ? { type: "CONTENT", offerDetail: serverData } : LOADING_STATE
+  );
   (0, import_react3.useEffect)(() => {
     let isCancelled = false;
     if (!isReady) {
-      setOfferDetailsState(LOADING_STATE);
+      if (serverData === void 0) {
+        setOfferDetailsState(LOADING_STATE);
+      }
+      return () => {
+        isCancelled = true;
+      };
+    }
+    if (serverData !== void 0) {
       return () => {
         isCancelled = true;
       };
@@ -91,20 +103,30 @@ function useCoinListOfferDetails(offerId) {
     return () => {
       isCancelled = true;
     };
-  }, [coinlist, isReady, offerId]);
+  }, [coinlist, isReady, offerId, serverData]);
   return { offerDetailsState };
 }
 
 // src/client/hooks/useCoinListOffers.ts
 var import_react4 = require("react");
 var LOADING_STATE2 = { type: "LOADING" };
-function useCoinListOffers() {
+function useCoinListOffers(options = {}) {
   const { coinlist, isReady } = useCoinList();
-  const [offersState, setOffersState] = (0, import_react4.useState)(LOADING_STATE2);
+  const { serverOffers } = options;
+  const [offersState, setOffersState] = (0, import_react4.useState)(
+    serverOffers !== void 0 ? { type: "CONTENT", offers: serverOffers } : LOADING_STATE2
+  );
   (0, import_react4.useEffect)(() => {
     let isCancelled = false;
     if (!isReady) {
-      setOffersState(LOADING_STATE2);
+      if (serverOffers === void 0) {
+        setOffersState(LOADING_STATE2);
+      }
+      return () => {
+        isCancelled = true;
+      };
+    }
+    if (serverOffers !== void 0) {
       return () => {
         isCancelled = true;
       };
@@ -123,22 +145,73 @@ function useCoinListOffers() {
     return () => {
       isCancelled = true;
     };
-  }, [coinlist, isReady]);
+  }, [coinlist, isReady, serverOffers]);
   return { offersState };
 }
 
-// src/client/hooks/useCompleteCoinListOAuth.ts
+// src/client/hooks/useCoinListRequirements.ts
 var import_react5 = require("react");
+var LOADING_STATE3 = { type: "LOADING" };
+function useCoinListRequirements(offerId, options = {}) {
+  const { coinlist, isReady } = useCoinList();
+  const { serverData } = options;
+  const [requirementsState, setRequirementsState] = (0, import_react5.useState)(
+    serverData !== void 0 ? { type: "CONTENT", ...serverData } : LOADING_STATE3
+  );
+  const [fetchKey, setFetchKey] = (0, import_react5.useState)(0);
+  const refetch = (0, import_react5.useCallback)(() => setFetchKey((k) => k + 1), []);
+  (0, import_react5.useEffect)(() => {
+    let isCancelled = false;
+    if (!isReady) {
+      if (serverData === void 0) {
+        setRequirementsState(LOADING_STATE3);
+      }
+      return () => {
+        isCancelled = true;
+      };
+    }
+    if (serverData !== void 0 && fetchKey === 0) {
+      return () => {
+        isCancelled = true;
+      };
+    }
+    setRequirementsState(LOADING_STATE3);
+    Promise.all([
+      coinlist.fetchOfferRequirements(offerId),
+      coinlist.fetchRequirementStatuses(offerId)
+    ]).then(([requirementsByOptionId, statuses]) => {
+      if (!isCancelled) {
+        setRequirementsState({
+          type: "CONTENT",
+          requirementsByOptionId,
+          statuses
+        });
+      }
+    }).catch((error) => {
+      if (!isCancelled) {
+        const reason = error instanceof NotAuthenticatedError ? "not-authenticated" : "generic-error";
+        setRequirementsState({ type: "ERROR", reason });
+      }
+    });
+    return () => {
+      isCancelled = true;
+    };
+  }, [coinlist, isReady, offerId, fetchKey]);
+  return { requirementsState, refetch };
+}
+
+// src/client/hooks/useCompleteCoinListOAuth.ts
+var import_react6 = require("react");
 function useCompleteCoinListOAuth(options) {
   const { coinlist } = useCoinList();
-  const postOAuthCompleteRef = (0, import_react5.useRef)(options.postOAuthComplete);
-  const onFailureRef = (0, import_react5.useRef)(options.onFailure);
-  const onSuccessRef = (0, import_react5.useRef)(options.onSuccess);
+  const postOAuthCompleteRef = (0, import_react6.useRef)(options.postOAuthComplete);
+  const onFailureRef = (0, import_react6.useRef)(options.onFailure);
+  const onSuccessRef = (0, import_react6.useRef)(options.onSuccess);
   postOAuthCompleteRef.current = options.postOAuthComplete;
   onFailureRef.current = options.onFailure;
   onSuccessRef.current = options.onSuccess;
-  const hasStartedExchangeRef = (0, import_react5.useRef)(false);
-  (0, import_react5.useEffect)(() => {
+  const hasStartedExchangeRef = (0, import_react6.useRef)(false);
+  (0, import_react6.useEffect)(() => {
     if (typeof window === "undefined") return;
     const params = new URLSearchParams(window.location.search);
     if (!params.has("code") && !params.has("error")) return;
@@ -180,11 +253,55 @@ function useCompleteCoinListOAuth(options) {
     };
   }, [coinlist]);
 }
+
+// src/client/hooks/useParticipations.ts
+var import_react7 = require("react");
+var LOADING_STATE4 = { type: "LOADING" };
+function useParticipations(offerId, options = {}) {
+  const { coinlist, isReady } = useCoinList();
+  const { serverData } = options;
+  const [participationsState, setParticipationsState] = (0, import_react7.useState)(
+    serverData !== void 0 ? { type: "CONTENT", participations: serverData } : LOADING_STATE4
+  );
+  (0, import_react7.useEffect)(() => {
+    let isCancelled = false;
+    if (!isReady) {
+      if (serverData === void 0) {
+        setParticipationsState(LOADING_STATE4);
+      }
+      return () => {
+        isCancelled = true;
+      };
+    }
+    if (serverData !== void 0) {
+      return () => {
+        isCancelled = true;
+      };
+    }
+    setParticipationsState(LOADING_STATE4);
+    coinlist.fetchAllParticipations(offerId).then((participations) => {
+      if (!isCancelled) {
+        setParticipationsState({ type: "CONTENT", participations });
+      }
+    }).catch((error) => {
+      if (!isCancelled) {
+        const reason = error instanceof NotAuthenticatedError ? "not-authenticated" : "generic-error";
+        setParticipationsState({ type: "ERROR", reason });
+      }
+    });
+    return () => {
+      isCancelled = true;
+    };
+  }, [coinlist, isReady, offerId, serverData]);
+  return { participationsState };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   useCoinList,
   useCoinListOfferDetails,
   useCoinListOffers,
-  useCompleteCoinListOAuth
+  useCoinListRequirements,
+  useCompleteCoinListOAuth,
+  useParticipations
 });
 //# sourceMappingURL=index.cjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/client/hooks/index.ts","../../../src/client/hooks/useCoinList.ts","../../../src/client/CoinListProvider.tsx","../../../src/shared/types/errors.ts","../../../src/client/hooks/useCoinListOfferDetails.ts","../../../src/client/hooks/useCoinListOffers.ts","../../../src/client/hooks/useCompleteCoinListOAuth.ts"],"sourcesContent":["export { useCoinList } from '@/client/hooks/useCoinList';\nexport { useCoinListOfferDetails } from '@/client/hooks/useCoinListOfferDetails';\nexport { useCoinListOffers } from '@/client/hooks/useCoinListOffers';\nexport {\n  type CompleteCoinListOAuthFailureReason,\n  type UseCompleteCoinListOAuthOptions,\n  useCompleteCoinListOAuth,\n} from '@/client/hooks/useCompleteCoinListOAuth';\n","import { useContext } from 'react';\nimport { CoinListContext } from '@/client/CoinListProvider';\nimport type { CoinListClient } from '@/client/core/coinlist-client';\n\nexport interface UseCoinListResult {\n  /**\n   * Indicates whether the CoinList client has been initialized and ready to use.\n   * While isReady is false, then the current user state will be `unknown`.\n   */\n  isReady: boolean;\n  coinlist: CoinListClient;\n}\n\nexport function useCoinList(): UseCoinListResult {\n  const context = useContext(CoinListContext);\n  if (context === null) {\n    throw new CoinListClientInitializationError();\n  }\n\n  return {\n    isReady: context.isReady,\n    coinlist: context.coinlist,\n  };\n}\n\nexport class CoinListClientInitializationError extends Error {\n  constructor(\n    message = 'useCoinList() must be used within CoinListProvider. Wrap your app with <CoinListProvider config={...}>.'\n  ) {\n    super(message);\n    this.name = 'CoinListClientInitializationError';\n  }\n}\n","/**\n * Global CoinList initialization for React apps.\n * Wrap your app once at the root; use useCoinList() anywhere below.\n */\n\nimport {\n  createContext,\n  type ReactNode,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport {\n  type ClientConfig,\n  type CoinListClient,\n  createCoinListClient,\n} from '@/client/core/coinlist-client';\n\nexport type CoinListContextValue = {\n  coinlist: CoinListClient;\n  isReady: boolean;\n};\n\nexport const CoinListContext = createContext<CoinListContextValue | null>(null);\n\nexport type CoinListProviderProps = {\n  config: ClientConfig;\n  children: ReactNode;\n};\n\n/**\n * Provide CoinList (api + config) to the tree. Initialize once at app root with your config.\n */\nexport function CoinListProvider({ config, children }: CoinListProviderProps) {\n  const [isReady, setIsReady] = useState(false);\n  const coinlist = useMemo(() => createCoinListClient(config), [config]);\n\n  useEffect(() => {\n    let isCancelled = false;\n    if (coinlist.getAuthState() === 'unknown') {\n      coinlist\n        .init()\n        .then(() => {\n          if (!isCancelled) {\n            setIsReady(true);\n          }\n        })\n        .catch(() => {\n          if (!isCancelled) {\n            setIsReady(true);\n          }\n        });\n    } else {\n      setIsReady(true);\n    }\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist]);\n\n  const value = useMemo(() => ({ coinlist, isReady }), [coinlist, isReady]);\n\n  return (\n    <CoinListContext.Provider value={value}>\n      {children}\n    </CoinListContext.Provider>\n  );\n}\n","/**\n * Error thrown when a feature or code path is not yet implemented.\n */\nexport class NotImplementedError extends Error {\n  constructor(message = 'Not implemented yet') {\n    super(message);\n    this.name = 'NotImplementedError';\n  }\n}\n\n/**\n * Error thrown when accessing a feature that requires authentication\n * without being authenticated.\n */\nexport class NotAuthenticatedError extends Error {\n  constructor(\n    message = 'The user is not authenticated. Go through the OAuth flow first!'\n  ) {\n    super(message);\n    this.name = 'NotAuthenticatedError';\n  }\n}\n","import { useEffect, useState } from 'react';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport { NotAuthenticatedError } from '@/shared/types/errors';\nimport type { OfferId } from '@/shared/types/offer';\nimport type { OfferDetail } from '@/shared/types/offer-detail';\n\nexport type LoadOfferDetailsReason = 'not-authenticated' | 'generic-error';\n\nexport type LoadOfferDetailsState =\n  | {\n      type: 'LOADING';\n    }\n  | {\n      type: 'ERROR';\n      reason: LoadOfferDetailsReason;\n    }\n  | {\n      type: 'CONTENT';\n      offerDetail: OfferDetail;\n    };\n\nexport interface UseCoinListOfferDetailsResult {\n  offerDetailsState: LoadOfferDetailsState;\n}\n\nconst LOADING_STATE: LoadOfferDetailsState = { type: 'LOADING' };\n\n/**\n * Loads CoinList offer details for a given offer id and exposes a UI-friendly state.\n *\n * Returns `LOADING` while CoinList is initializing or while details are being fetched.\n * Returns `CONTENT` with the offer when `fetchOfferDetails()` succeeds.\n * Returns `ERROR` with:\n * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}\n * - `generic-error` for any other failure\n */\nexport function useCoinListOfferDetails(\n  offerId: OfferId\n): UseCoinListOfferDetailsResult {\n  const { coinlist, isReady } = useCoinList();\n  const [offerDetailsState, setOfferDetailsState] =\n    useState<LoadOfferDetailsState>(LOADING_STATE);\n\n  useEffect(() => {\n    let isCancelled = false;\n\n    if (!isReady) {\n      setOfferDetailsState(LOADING_STATE);\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    setOfferDetailsState(LOADING_STATE);\n    coinlist\n      .fetchOfferDetails(offerId)\n      .then((offerDetail) => {\n        if (!isCancelled) {\n          setOfferDetailsState({ type: 'CONTENT', offerDetail });\n        }\n      })\n      .catch((error: unknown) => {\n        if (!isCancelled) {\n          const reason: LoadOfferDetailsReason =\n            error instanceof NotAuthenticatedError\n              ? 'not-authenticated'\n              : 'generic-error';\n          setOfferDetailsState({ type: 'ERROR', reason });\n        }\n      });\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist, isReady, offerId]);\n\n  return { offerDetailsState };\n}\n","import { useEffect, useState } from 'react';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport { NotAuthenticatedError } from '@/shared/types/errors';\nimport type { Offer } from '@/shared/types/offer';\n\nexport type LoadOffersReason = 'not-authenticated' | 'generic-error';\n\nexport type LoadOffersState =\n  | {\n      type: 'LOADING';\n    }\n  | {\n      type: 'ERROR';\n      reason: LoadOffersReason;\n    }\n  | {\n      type: 'CONTENT';\n      offers: Offer[];\n    };\n\nexport interface UseCoinListOffersResult {\n  offersState: LoadOffersState;\n}\n\nconst LOADING_STATE: LoadOffersState = { type: 'LOADING' };\n\n/**\n * Loads all CoinList offers for the current user and exposes a UI-friendly state.\n *\n * Returns `LOADING` while CoinList is initializing or while offers are being fetched.\n * Returns `CONTENT` with all offers when `fetchAllOffers()` succeeds.\n * Returns `ERROR` with:\n * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}\n * - `generic-error` for any other failure\n */\nexport function useCoinListOffers(): UseCoinListOffersResult {\n  const { coinlist, isReady } = useCoinList();\n  const [offersState, setOffersState] =\n    useState<LoadOffersState>(LOADING_STATE);\n\n  useEffect(() => {\n    let isCancelled = false;\n\n    // Wait until CoinListProvider finishes auth initialization.\n    if (!isReady) {\n      setOffersState(LOADING_STATE);\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    setOffersState(LOADING_STATE);\n    coinlist\n      .fetchAllOffers()\n      .then((offers) => {\n        if (!isCancelled) {\n          setOffersState({ type: 'CONTENT', offers });\n        }\n      })\n      .catch((error: unknown) => {\n        if (!isCancelled) {\n          const reason: LoadOffersReason =\n            error instanceof NotAuthenticatedError\n              ? 'not-authenticated'\n              : 'generic-error';\n          setOffersState({ type: 'ERROR', reason });\n        }\n      });\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist, isReady]);\n\n  return { offersState };\n}\n","import { useEffect, useRef } from 'react';\nimport type { OauthClientErrorReason } from '@/client/core/types/client-types';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport type { AuthorizationCode, CodeVerifier } from '@/shared/types/oauth';\n\n/**\n * Reasons passed to {@link UseCompleteCoinListOAuthOptions.onFailure} when the\n * OAuth callback cannot be completed. Includes PKCE / redirect validation\n * errors from {@link CoinListClient.completeOAuth} and a dedicated value when\n * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails or rejects.\n */\nexport type CompleteCoinListOAuthFailureReason =\n  | OauthClientErrorReason\n  | 'complete_request_failed';\n\nexport interface UseCompleteCoinListOAuthOptions {\n  /**\n   * Exchange the authorization code on your backend (e.g. POST to your API).\n   * Return `true` when the session was established successfully, `false` when\n   * the request completed but signing in failed. Rejections are treated like\n   * `false` and reported as {@link CompleteCoinListOAuthFailureReason}\n   * `\"complete_request_failed\"`.\n   */\n  postOAuthComplete: (payload: {\n    code: AuthorizationCode;\n    codeVerifier: CodeVerifier;\n  }) => Promise<boolean>;\n  /**\n   * Called when the user denied access (`error` query parameter), when\n   * {@link CoinListClient.completeOAuth} fails PKCE/state validation, or when\n   * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails.\n   */\n  onFailure: (\n    reason: CompleteCoinListOAuthFailureReason\n  ) => void | Promise<void>;\n  /** Invoked after {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} succeeds and {@link CoinListClient.init} has refreshed the client session. */\n  onSuccess: () => void | Promise<void>;\n}\n\n/**\n * Runs the CoinList OAuth callback once on mount: validates the redirect URL via\n * {@link CoinListClient.completeOAuth}, exchanges the code via {@link UseCompleteCoinListOAuthOptions.postOAuthComplete},\n * refreshes tokens with {@link CoinListClient.init}, then calls {@link UseCompleteCoinListOAuthOptions.onSuccess}.\n *\n * Framework-agnostic: reads `window.location` like {@link CoinListClient.completeOAuth}. Supply\n * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete}, {@link UseCompleteCoinListOAuthOptions.onFailure},\n * and {@link UseCompleteCoinListOAuthOptions.onSuccess} to perform redirects or routing in your app.\n *\n * Must be used within {@link CoinListProvider}.\n */\nexport function useCompleteCoinListOAuth(\n  options: UseCompleteCoinListOAuthOptions\n): void {\n  const { coinlist } = useCoinList();\n\n  const postOAuthCompleteRef = useRef(options.postOAuthComplete);\n  const onFailureRef = useRef(options.onFailure);\n  const onSuccessRef = useRef(options.onSuccess);\n\n  postOAuthCompleteRef.current = options.postOAuthComplete;\n  onFailureRef.current = options.onFailure;\n  onSuccessRef.current = options.onSuccess;\n\n  const hasStartedExchangeRef = useRef(false);\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n\n    const params = new URLSearchParams(window.location.search);\n    if (!params.has('code') && !params.has('error')) return;\n\n    if (hasStartedExchangeRef.current) return;\n\n    const oauthResult = coinlist.completeOAuth();\n    if (oauthResult.type === 'error') {\n      void Promise.resolve(onFailureRef.current(oauthResult.reason)).catch(\n        () => {}\n      );\n      return;\n    }\n\n    hasStartedExchangeRef.current = true;\n    let cancelled = false;\n\n    void (async () => {\n      try {\n        const ok = await postOAuthCompleteRef.current({\n          code: oauthResult.code,\n          codeVerifier: oauthResult.codeVerifier,\n        });\n\n        if (cancelled) return;\n\n        if (!ok) {\n          hasStartedExchangeRef.current = false;\n          await onFailureRef.current('complete_request_failed');\n          return;\n        }\n\n        await coinlist.init();\n\n        if (cancelled) return;\n\n        await onSuccessRef.current();\n      } catch {\n        if (cancelled) return;\n        hasStartedExchangeRef.current = false;\n        await onFailureRef.current('complete_request_failed');\n      }\n    })();\n\n    return () => {\n      cancelled = true;\n      hasStartedExchangeRef.current = false;\n    };\n  }, [coinlist]);\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","LOADING_STATE","import_react"]}
+{"version":3,"sources":["../../../src/client/hooks/index.ts","../../../src/client/hooks/useCoinList.ts","../../../src/client/CoinListProvider.tsx","../../../src/shared/types/errors.ts","../../../src/client/hooks/useCoinListOfferDetails.ts","../../../src/client/hooks/useCoinListOffers.ts","../../../src/client/hooks/useCoinListRequirements.ts","../../../src/client/hooks/useCompleteCoinListOAuth.ts","../../../src/client/hooks/useParticipations.ts"],"sourcesContent":["export { useCoinList } from '@/client/hooks/useCoinList';\nexport {\n  type LoadOfferDetailsReason,\n  type LoadOfferDetailsState,\n  type UseCoinListOfferDetailsOptions,\n  type UseCoinListOfferDetailsResult,\n  useCoinListOfferDetails,\n} from '@/client/hooks/useCoinListOfferDetails';\nexport {\n  type LoadOffersReason,\n  type LoadOffersState,\n  type UseCoinListOffersOptions,\n  type UseCoinListOffersResult,\n  useCoinListOffers,\n} from '@/client/hooks/useCoinListOffers';\nexport {\n  type LoadRequirementsReason,\n  type LoadRequirementsState,\n  type UseCoinListRequirementsOptions,\n  type UseCoinListRequirementsResult,\n  useCoinListRequirements,\n} from '@/client/hooks/useCoinListRequirements';\nexport {\n  type CompleteCoinListOAuthFailureReason,\n  type UseCompleteCoinListOAuthOptions,\n  useCompleteCoinListOAuth,\n} from '@/client/hooks/useCompleteCoinListOAuth';\nexport {\n  type LoadParticipationsReason,\n  type LoadParticipationsState,\n  type UseParticipationsOptions,\n  type UseParticipationsResult,\n  useParticipations,\n} from '@/client/hooks/useParticipations';\n","import { useContext } from 'react';\nimport { CoinListContext } from '@/client/CoinListProvider';\nimport type { CoinListClient } from '@/client/core/coinlist-client';\n\nexport interface UseCoinListResult {\n  /**\n   * Indicates whether the CoinList client has been initialized and ready to use.\n   * While isReady is false, then the current user state will be `unknown`.\n   */\n  isReady: boolean;\n  coinlist: CoinListClient;\n}\n\nexport function useCoinList(): UseCoinListResult {\n  const context = useContext(CoinListContext);\n  if (context === null) {\n    throw new CoinListClientInitializationError();\n  }\n\n  return {\n    isReady: context.isReady,\n    coinlist: context.coinlist,\n  };\n}\n\nexport class CoinListClientInitializationError extends Error {\n  constructor(\n    message = 'useCoinList() must be used within CoinListProvider. Wrap your app with <CoinListProvider config={...}>.'\n  ) {\n    super(message);\n    this.name = 'CoinListClientInitializationError';\n  }\n}\n","/**\n * Global CoinList initialization for React apps.\n * Wrap your app once at the root; use useCoinList() anywhere below.\n */\n\nimport {\n  createContext,\n  type ReactNode,\n  useEffect,\n  useMemo,\n  useState,\n} from 'react';\nimport {\n  type ClientConfig,\n  type CoinListClient,\n  createCoinListClient,\n} from '@/client/core/coinlist-client';\n\nexport type CoinListContextValue = {\n  coinlist: CoinListClient;\n  isReady: boolean;\n};\n\nexport const CoinListContext = createContext<CoinListContextValue | null>(null);\n\nexport type CoinListProviderProps = {\n  config: ClientConfig;\n  children: ReactNode;\n};\n\n/**\n * Provide CoinList (api + config) to the tree. Initialize once at app root with your config.\n */\nexport function CoinListProvider({ config, children }: CoinListProviderProps) {\n  const [isReady, setIsReady] = useState(false);\n  const coinlist = useMemo(() => createCoinListClient(config), [config]);\n\n  useEffect(() => {\n    let isCancelled = false;\n    if (coinlist.getAuthState() === 'unknown') {\n      coinlist\n        .init()\n        .then(() => {\n          if (!isCancelled) {\n            setIsReady(true);\n          }\n        })\n        .catch(() => {\n          if (!isCancelled) {\n            setIsReady(true);\n          }\n        });\n    } else {\n      setIsReady(true);\n    }\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist]);\n\n  const value = useMemo(() => ({ coinlist, isReady }), [coinlist, isReady]);\n\n  return (\n    <CoinListContext.Provider value={value}>\n      {children}\n    </CoinListContext.Provider>\n  );\n}\n","/**\n * Error thrown when a feature or code path is not yet implemented.\n */\nexport class NotImplementedError extends Error {\n  constructor(message = 'Not implemented yet') {\n    super(message);\n    this.name = 'NotImplementedError';\n  }\n}\n\n/**\n * Error thrown when accessing a feature that requires authentication\n * without being authenticated.\n */\nexport class NotAuthenticatedError extends Error {\n  constructor(\n    message = 'The user is not authenticated. Go through the OAuth flow first!'\n  ) {\n    super(message);\n    this.name = 'NotAuthenticatedError';\n  }\n}\n","import { useEffect, useState } from 'react';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport { NotAuthenticatedError } from '@/shared/types/errors';\nimport type { OfferId } from '@/shared/types/offer';\nimport type { OfferDetail } from '@/shared/types/offer-detail';\n\nexport type LoadOfferDetailsReason = 'not-authenticated' | 'generic-error';\n\nexport type LoadOfferDetailsState =\n  | {\n      type: 'LOADING';\n    }\n  | {\n      type: 'ERROR';\n      reason: LoadOfferDetailsReason;\n    }\n  | {\n      type: 'CONTENT';\n      offerDetail: OfferDetail;\n    };\n\nexport interface UseCoinListOfferDetailsOptions {\n  /**\n   * Offer detail pre-fetched on the server (e.g. via `CoinListServer.fetchOfferDetails()`).\n   * When provided, the hook uses this data as-is and skips the client-side fetch entirely.\n   */\n  serverData?: OfferDetail;\n}\n\nexport interface UseCoinListOfferDetailsResult {\n  offerDetailsState: LoadOfferDetailsState;\n}\n\nconst LOADING_STATE: LoadOfferDetailsState = { type: 'LOADING' };\n\n/**\n * Loads CoinList offer details for a given offer id and exposes a UI-friendly state.\n *\n * Pass `serverData` (pre-fetched server-side) to use that data as-is and skip\n * the client-side fetch entirely.\n *\n * Returns `LOADING` while CoinList is initializing or while details are being fetched.\n * Returns `CONTENT` with the offer when `fetchOfferDetails()` succeeds.\n * Returns `ERROR` with:\n * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}\n * - `generic-error` for any other failure\n */\nexport function useCoinListOfferDetails(\n  offerId: OfferId,\n  options: UseCoinListOfferDetailsOptions = {}\n): UseCoinListOfferDetailsResult {\n  const { coinlist, isReady } = useCoinList();\n  const { serverData } = options;\n  const [offerDetailsState, setOfferDetailsState] =\n    useState<LoadOfferDetailsState>(\n      serverData !== undefined\n        ? { type: 'CONTENT', offerDetail: serverData }\n        : LOADING_STATE\n    );\n\n  useEffect(() => {\n    let isCancelled = false;\n\n    if (!isReady) {\n      if (serverData === undefined) {\n        setOfferDetailsState(LOADING_STATE);\n      }\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    if (serverData !== undefined) {\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    setOfferDetailsState(LOADING_STATE);\n    coinlist\n      .fetchOfferDetails(offerId)\n      .then((offerDetail) => {\n        if (!isCancelled) {\n          setOfferDetailsState({ type: 'CONTENT', offerDetail });\n        }\n      })\n      .catch((error: unknown) => {\n        if (!isCancelled) {\n          const reason: LoadOfferDetailsReason =\n            error instanceof NotAuthenticatedError\n              ? 'not-authenticated'\n              : 'generic-error';\n          setOfferDetailsState({ type: 'ERROR', reason });\n        }\n      });\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist, isReady, offerId, serverData]);\n\n  return { offerDetailsState };\n}\n","import { useEffect, useState } from 'react';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport { NotAuthenticatedError } from '@/shared/types/errors';\nimport type { Offer } from '@/shared/types/offer';\n\nexport type LoadOffersReason = 'not-authenticated' | 'generic-error';\n\nexport type LoadOffersState =\n  | {\n      type: 'LOADING';\n    }\n  | {\n      type: 'ERROR';\n      reason: LoadOffersReason;\n    }\n  | {\n      type: 'CONTENT';\n      offers: Offer[];\n    };\n\nexport interface UseCoinListOffersOptions {\n  /**\n   * Offers pre-fetched on the server (e.g. via `CoinListServer.fetchAllOffers()`).\n   * When provided, the hook uses this data as-is and skips the client-side fetch entirely.\n   */\n  serverOffers?: Offer[];\n}\n\nexport interface UseCoinListOffersResult {\n  offersState: LoadOffersState;\n}\n\nconst LOADING_STATE: LoadOffersState = { type: 'LOADING' };\n\n/**\n * Loads all CoinList offers for the current user and exposes a UI-friendly state.\n *\n * Pass `serverOffers` (pre-fetched server-side) to use that data as-is and skip\n * the client-side fetch entirely.\n *\n * Returns `LOADING` while CoinList is initializing or while offers are being fetched.\n * Returns `CONTENT` with all offers when `fetchAllOffers()` succeeds.\n * Returns `ERROR` with:\n * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}\n * - `generic-error` for any other failure\n */\nexport function useCoinListOffers(\n  options: UseCoinListOffersOptions = {}\n): UseCoinListOffersResult {\n  const { coinlist, isReady } = useCoinList();\n  const { serverOffers } = options;\n  const [offersState, setOffersState] = useState<LoadOffersState>(\n    serverOffers !== undefined\n      ? { type: 'CONTENT', offers: serverOffers }\n      : LOADING_STATE\n  );\n\n  useEffect(() => {\n    let isCancelled = false;\n\n    // Wait until CoinListProvider finishes auth initialization.\n    if (!isReady) {\n      if (serverOffers === undefined) {\n        setOffersState(LOADING_STATE);\n      }\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    if (serverOffers !== undefined) {\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    setOffersState(LOADING_STATE);\n    coinlist\n      .fetchAllOffers()\n      .then((offers) => {\n        if (!isCancelled) {\n          setOffersState({ type: 'CONTENT', offers });\n        }\n      })\n      .catch((error: unknown) => {\n        if (!isCancelled) {\n          const reason: LoadOffersReason =\n            error instanceof NotAuthenticatedError\n              ? 'not-authenticated'\n              : 'generic-error';\n          setOffersState({ type: 'ERROR', reason });\n        }\n      });\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist, isReady, serverOffers]);\n\n  return { offersState };\n}\n","import { useCallback, useEffect, useState } from 'react';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport { NotAuthenticatedError } from '@/shared/types/errors';\nimport type { OfferId } from '@/shared/types/offer';\nimport type { OfferOptionId } from '@/shared/types/offer-detail';\nimport type {\n  Requirement,\n  RequirementStatusInfo,\n} from '@/shared/types/requirement';\n\nexport type LoadRequirementsReason = 'not-authenticated' | 'generic-error';\n\nexport type LoadRequirementsState =\n  | {\n      type: 'LOADING';\n    }\n  | {\n      type: 'ERROR';\n      reason: LoadRequirementsReason;\n    }\n  | {\n      type: 'CONTENT';\n      requirementsByOptionId: Record<OfferOptionId, Requirement[]>;\n      statuses: RequirementStatusInfo[];\n    };\n\nexport interface UseCoinListRequirementsOptions {\n  /**\n   * Requirements data pre-fetched on the server (e.g. via\n   * `CoinListServer.fetchOfferRequirements()` + `fetchRequirementStatuses()`).\n   * When provided, the hook uses this data as-is and skips the initial client-side fetch.\n   * Calling `refetch()` will still trigger a fresh fetch.\n   */\n  serverData?: {\n    requirementsByOptionId: Record<OfferOptionId, Requirement[]>;\n    statuses: RequirementStatusInfo[];\n  };\n}\n\nexport interface UseCoinListRequirementsResult {\n  requirementsState: LoadRequirementsState;\n  /** Triggers a re-fetch of requirements and statuses. */\n  refetch: () => void;\n}\n\nconst LOADING_STATE: LoadRequirementsState = { type: 'LOADING' };\n\n/**\n * Loads requirements (grouped by option ID) and requirement statuses for a\n * given offer, then exposes them via a state machine.\n *\n * Pass `serverData` (pre-fetched server-side) to use that data as-is and skip\n * the initial client-side fetch. Calling `refetch()` will still trigger a fresh fetch.\n *\n * Returns `LOADING` while CoinList is initializing or while data is being fetched.\n * Returns `CONTENT` with requirementsByOptionId and statuses on success.\n * Returns `ERROR` with:\n * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}\n * - `generic-error` for any other failure\n */\nexport function useCoinListRequirements(\n  offerId: OfferId,\n  options: UseCoinListRequirementsOptions = {}\n): UseCoinListRequirementsResult {\n  const { coinlist, isReady } = useCoinList();\n  const { serverData } = options;\n  const [requirementsState, setRequirementsState] =\n    useState<LoadRequirementsState>(\n      serverData !== undefined\n        ? { type: 'CONTENT', ...serverData }\n        : LOADING_STATE\n    );\n  const [fetchKey, setFetchKey] = useState(0);\n  const refetch = useCallback(() => setFetchKey((k) => k + 1), []);\n\n  // biome-ignore lint/correctness/useExhaustiveDependencies: fetchKey is an intentional refetch trigger\n  useEffect(() => {\n    let isCancelled = false;\n\n    if (!isReady) {\n      if (serverData === undefined) {\n        setRequirementsState(LOADING_STATE);\n      }\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    if (serverData !== undefined && fetchKey === 0) {\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    setRequirementsState(LOADING_STATE);\n    Promise.all([\n      coinlist.fetchOfferRequirements(offerId),\n      coinlist.fetchRequirementStatuses(offerId),\n    ])\n      .then(([requirementsByOptionId, statuses]) => {\n        if (!isCancelled) {\n          setRequirementsState({\n            type: 'CONTENT',\n            requirementsByOptionId,\n            statuses,\n          });\n        }\n      })\n      .catch((error: unknown) => {\n        if (!isCancelled) {\n          const reason: LoadRequirementsReason =\n            error instanceof NotAuthenticatedError\n              ? 'not-authenticated'\n              : 'generic-error';\n          setRequirementsState({ type: 'ERROR', reason });\n        }\n      });\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist, isReady, offerId, fetchKey]);\n\n  return { requirementsState, refetch };\n}\n","import { useEffect, useRef } from 'react';\nimport type { OauthClientErrorReason } from '@/client/core/types/client-types';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport type { AuthorizationCode, CodeVerifier } from '@/shared/types/oauth';\n\n/**\n * Reasons passed to {@link UseCompleteCoinListOAuthOptions.onFailure} when the\n * OAuth callback cannot be completed. Includes PKCE / redirect validation\n * errors from {@link CoinListClient.completeOAuth} and a dedicated value when\n * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails or rejects.\n */\nexport type CompleteCoinListOAuthFailureReason =\n  | OauthClientErrorReason\n  | 'complete_request_failed';\n\nexport interface UseCompleteCoinListOAuthOptions {\n  /**\n   * Exchange the authorization code on your backend (e.g. POST to your API).\n   * Return `true` when the session was established successfully, `false` when\n   * the request completed but signing in failed. Rejections are treated like\n   * `false` and reported as {@link CompleteCoinListOAuthFailureReason}\n   * `\"complete_request_failed\"`.\n   */\n  postOAuthComplete: (payload: {\n    code: AuthorizationCode;\n    codeVerifier: CodeVerifier;\n  }) => Promise<boolean>;\n  /**\n   * Called when the user denied access (`error` query parameter), when\n   * {@link CoinListClient.completeOAuth} fails PKCE/state validation, or when\n   * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} fails.\n   */\n  onFailure: (\n    reason: CompleteCoinListOAuthFailureReason\n  ) => void | Promise<void>;\n  /** Invoked after {@link UseCompleteCoinListOAuthOptions.postOAuthComplete} succeeds and {@link CoinListClient.init} has refreshed the client session. */\n  onSuccess: () => void | Promise<void>;\n}\n\n/**\n * Runs the CoinList OAuth callback once on mount: validates the redirect URL via\n * {@link CoinListClient.completeOAuth}, exchanges the code via {@link UseCompleteCoinListOAuthOptions.postOAuthComplete},\n * refreshes tokens with {@link CoinListClient.init}, then calls {@link UseCompleteCoinListOAuthOptions.onSuccess}.\n *\n * Framework-agnostic: reads `window.location` like {@link CoinListClient.completeOAuth}. Supply\n * {@link UseCompleteCoinListOAuthOptions.postOAuthComplete}, {@link UseCompleteCoinListOAuthOptions.onFailure},\n * and {@link UseCompleteCoinListOAuthOptions.onSuccess} to perform redirects or routing in your app.\n *\n * Must be used within {@link CoinListProvider}.\n */\nexport function useCompleteCoinListOAuth(\n  options: UseCompleteCoinListOAuthOptions\n): void {\n  const { coinlist } = useCoinList();\n\n  const postOAuthCompleteRef = useRef(options.postOAuthComplete);\n  const onFailureRef = useRef(options.onFailure);\n  const onSuccessRef = useRef(options.onSuccess);\n\n  postOAuthCompleteRef.current = options.postOAuthComplete;\n  onFailureRef.current = options.onFailure;\n  onSuccessRef.current = options.onSuccess;\n\n  const hasStartedExchangeRef = useRef(false);\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n\n    const params = new URLSearchParams(window.location.search);\n    if (!params.has('code') && !params.has('error')) return;\n\n    if (hasStartedExchangeRef.current) return;\n\n    const oauthResult = coinlist.completeOAuth();\n    if (oauthResult.type === 'error') {\n      void Promise.resolve(onFailureRef.current(oauthResult.reason)).catch(\n        () => {}\n      );\n      return;\n    }\n\n    hasStartedExchangeRef.current = true;\n    let cancelled = false;\n\n    void (async () => {\n      try {\n        const ok = await postOAuthCompleteRef.current({\n          code: oauthResult.code,\n          codeVerifier: oauthResult.codeVerifier,\n        });\n\n        if (cancelled) return;\n\n        if (!ok) {\n          hasStartedExchangeRef.current = false;\n          await onFailureRef.current('complete_request_failed');\n          return;\n        }\n\n        await coinlist.init();\n\n        if (cancelled) return;\n\n        await onSuccessRef.current();\n      } catch {\n        if (cancelled) return;\n        hasStartedExchangeRef.current = false;\n        await onFailureRef.current('complete_request_failed');\n      }\n    })();\n\n    return () => {\n      cancelled = true;\n      hasStartedExchangeRef.current = false;\n    };\n  }, [coinlist]);\n}\n","import { useEffect, useState } from 'react';\nimport { useCoinList } from '@/client/hooks/useCoinList';\nimport { NotAuthenticatedError } from '@/shared/types/errors';\nimport type { OfferId } from '@/shared/types/offer';\nimport type { Participation } from '@/shared/types/participation';\n\nexport type LoadParticipationsReason = 'not-authenticated' | 'generic-error';\n\nexport type LoadParticipationsState =\n  | {\n      type: 'LOADING';\n    }\n  | {\n      type: 'ERROR';\n      reason: LoadParticipationsReason;\n    }\n  | {\n      type: 'CONTENT';\n      participations: Participation[];\n    };\n\nexport interface UseParticipationsOptions {\n  /**\n   * Participations pre-fetched on the server (e.g. via `CoinListServer.fetchAllParticipations()`).\n   * When provided, the hook uses this data as-is and skips the client-side fetch entirely.\n   */\n  serverData?: Participation[];\n}\n\nexport interface UseParticipationsResult {\n  participationsState: LoadParticipationsState;\n}\n\nconst LOADING_STATE: LoadParticipationsState = { type: 'LOADING' };\n\n/**\n * Loads all CoinList participations for the current user and exposes a UI-friendly state.\n * Optionally filters by offer when `offerId` is provided.\n *\n * Pass `serverData` (pre-fetched server-side) to use that data as-is and skip\n * the client-side fetch entirely.\n *\n * Returns `LOADING` while CoinList is initializing or while participations are being fetched.\n * Returns `CONTENT` with all participations when `fetchAllParticipations()` succeeds.\n * Returns `ERROR` with:\n * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}\n * - `generic-error` for any other failure\n */\nexport function useParticipations(\n  offerId?: OfferId,\n  options: UseParticipationsOptions = {}\n): UseParticipationsResult {\n  const { coinlist, isReady } = useCoinList();\n  const { serverData } = options;\n  const [participationsState, setParticipationsState] =\n    useState<LoadParticipationsState>(\n      serverData !== undefined\n        ? { type: 'CONTENT', participations: serverData }\n        : LOADING_STATE\n    );\n\n  useEffect(() => {\n    let isCancelled = false;\n\n    // Wait until CoinListProvider finishes auth initialization.\n    if (!isReady) {\n      if (serverData === undefined) {\n        setParticipationsState(LOADING_STATE);\n      }\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    if (serverData !== undefined) {\n      return () => {\n        isCancelled = true;\n      };\n    }\n\n    setParticipationsState(LOADING_STATE);\n    coinlist\n      .fetchAllParticipations(offerId)\n      .then((participations) => {\n        if (!isCancelled) {\n          setParticipationsState({ type: 'CONTENT', participations });\n        }\n      })\n      .catch((error: unknown) => {\n        if (!isCancelled) {\n          const reason: LoadParticipationsReason =\n            error instanceof NotAuthenticatedError\n              ? 'not-authenticated'\n              : 'generic-error';\n          setParticipationsState({ type: 'ERROR', reason });\n        }\n      });\n\n    return () => {\n      isCancelled = true;\n    };\n  }, [coinlist, isReady, offerId, serverData]);\n\n  return { participationsState };\n}\n"],"mappings":"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","names":["import_react","import_react","import_react","LOADING_STATE","import_react","LOADING_STATE","import_react","import_react","LOADING_STATE"]}

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

@@ -1,9 +1,17 @@
-export { C as CompleteCoinListOAuthFailureReason, U as UseCompleteCoinListOAuthOptions, u as useCoinList, a as useCompleteCoinListOAuth } from '../../useCompleteCoinListOAuth-C359mp_k.cjs';
-import { a as OfferId } from '../../offer-D6p_Ijme.cjs';
-import { e as OfferDetail } from '../../coinlist-client-Ds86ycAg.cjs';
-export { u as useCoinListOffers } from '../../useCoinListOffers-DvJxu6qj.cjs';
-import '../../oauth-session-DgItaMKN.cjs';
-import '../../newtype-yKTvFdg_.cjs';
+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 = {
@@ -15,18 +23,104 @@ type LoadOfferDetailsState = {
     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): UseCoinListOfferDetailsResult;
+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 { useCoinListOfferDetails };
+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,9 +1,17 @@
-export { C as CompleteCoinListOAuthFailureReason, U as UseCompleteCoinListOAuthOptions, u as useCoinList, a as useCompleteCoinListOAuth } from '../../useCompleteCoinListOAuth-wZX3o8r2.js';
-import { a as OfferId } from '../../offer-DnFEFJw9.js';
-import { e as OfferDetail } from '../../coinlist-client-20v7fJSW.js';
-export { u as useCoinListOffers } from '../../useCoinListOffers-DIdOb5hB.js';
-import '../../oauth-session-DnKDI5ou.js';
-import '../../newtype-yKTvFdg_.js';
+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 = {
@@ -15,18 +23,104 @@ type LoadOfferDetailsState = {
     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): UseCoinListOfferDetailsResult;
+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 { useCoinListOfferDetails };
+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,17 +1,19 @@
-import {
-  useCoinListOfferDetails,
-  useCoinListOffers
-} from "../../chunk-G3B4RLXP.js";
 import {
   useCoinList,
-  useCompleteCoinListOAuth
-} from "../../chunk-32GOUV3L.js";
-import "../../chunk-Z5RFQOMS.js";
-import "../../chunk-GRVV7NLV.js";
+  useCoinListOfferDetails,
+  useCoinListOffers,
+  useCoinListRequirements,
+  useCompleteCoinListOAuth,
+  useParticipations
+} from "../../chunk-UGJUTRXC.js";
+import "../../chunk-RIFATQB5.js";
+import "../../chunk-NC45IO63.js";
 export {
   useCoinList,
   useCoinListOfferDetails,
   useCoinListOffers,
-  useCompleteCoinListOAuth
+  useCoinListRequirements,
+  useCompleteCoinListOAuth,
+  useParticipations
 };
 //# sourceMappingURL=index.js.map