@coinlist-co/react 0.4.0 → 0.5.1

package/dist/chunk-UGJUTRXC.js

@@ -1,304 +0,0 @@
-import {
-  createCoinListClient
-} from "./chunk-RIFATQB5.js";
-import {
-  NotAuthenticatedError
-} from "./chunk-NC45IO63.js";
-
-// src/client/hooks/useCoinList.ts
-import { useContext } from "react";
-
-// src/client/CoinListProvider.tsx
-import {
-  createContext,
-  useEffect,
-  useMemo,
-  useState
-} from "react";
-import { jsx } from "react/jsx-runtime";
-var CoinListContext = createContext(null);
-function CoinListProvider({ config, children }) {
-  const [isReady, setIsReady] = useState(false);
-  const coinlist = useMemo(() => createCoinListClient(config), [config]);
-  useEffect(() => {
-    let isCancelled = false;
-    if (coinlist.getAuthState() === "unknown") {
-      coinlist.init().then(() => {
-        if (!isCancelled) {
-          setIsReady(true);
-        }
-      }).catch(() => {
-        if (!isCancelled) {
-          setIsReady(true);
-        }
-      });
-    } else {
-      setIsReady(true);
-    }
-    return () => {
-      isCancelled = true;
-    };
-  }, [coinlist]);
-  const value = useMemo(() => ({ coinlist, isReady }), [coinlist, isReady]);
-  return /* @__PURE__ */ jsx(CoinListContext.Provider, { value, children });
-}
-
-// src/client/hooks/useCoinList.ts
-function useCoinList() {
-  const context = useContext(CoinListContext);
-  if (context === null) {
-    throw new CoinListClientInitializationError();
-  }
-  return {
-    isReady: context.isReady,
-    coinlist: context.coinlist
-  };
-}
-var CoinListClientInitializationError = class extends Error {
-  constructor(message = "useCoinList() must be used within CoinListProvider. Wrap your app with <CoinListProvider config={...}>.") {
-    super(message);
-    this.name = "CoinListClientInitializationError";
-  }
-};
-
-// src/client/hooks/useCoinListOfferDetails.ts
-import { useEffect as useEffect2, useState as useState2 } from "react";
-var LOADING_STATE = { type: "LOADING" };
-function useCoinListOfferDetails(offerId, options = {}) {
-  const { coinlist, isReady } = useCoinList();
-  const { serverData } = options;
-  const [offerDetailsState, setOfferDetailsState] = useState2(
-    serverData !== void 0 ? { type: "CONTENT", offerDetail: serverData } : LOADING_STATE
-  );
-  useEffect2(() => {
-    let isCancelled = false;
-    if (!isReady) {
-      if (serverData === void 0) {
-        setOfferDetailsState(LOADING_STATE);
-      }
-      return () => {
-        isCancelled = true;
-      };
-    }
-    if (serverData !== void 0) {
-      return () => {
-        isCancelled = true;
-      };
-    }
-    setOfferDetailsState(LOADING_STATE);
-    coinlist.fetchOfferDetails(offerId).then((offerDetail) => {
-      if (!isCancelled) {
-        setOfferDetailsState({ type: "CONTENT", offerDetail });
-      }
-    }).catch((error) => {
-      if (!isCancelled) {
-        const reason = error instanceof NotAuthenticatedError ? "not-authenticated" : "generic-error";
-        setOfferDetailsState({ type: "ERROR", reason });
-      }
-    });
-    return () => {
-      isCancelled = true;
-    };
-  }, [coinlist, isReady, offerId, serverData]);
-  return { offerDetailsState };
-}
-
-// src/client/hooks/useCoinListOffers.ts
-import { useEffect as useEffect3, useState as useState3 } from "react";
-var LOADING_STATE2 = { type: "LOADING" };
-function useCoinListOffers(options = {}) {
-  const { coinlist, isReady } = useCoinList();
-  const { serverOffers } = options;
-  const [offersState, setOffersState] = useState3(
-    serverOffers !== void 0 ? { type: "CONTENT", offers: serverOffers } : LOADING_STATE2
-  );
-  useEffect3(() => {
-    let isCancelled = false;
-    if (!isReady) {
-      if (serverOffers === void 0) {
-        setOffersState(LOADING_STATE2);
-      }
-      return () => {
-        isCancelled = true;
-      };
-    }
-    if (serverOffers !== void 0) {
-      return () => {
-        isCancelled = true;
-      };
-    }
-    setOffersState(LOADING_STATE2);
-    coinlist.fetchAllOffers().then((offers) => {
-      if (!isCancelled) {
-        setOffersState({ type: "CONTENT", offers });
-      }
-    }).catch((error) => {
-      if (!isCancelled) {
-        const reason = error instanceof NotAuthenticatedError ? "not-authenticated" : "generic-error";
-        setOffersState({ type: "ERROR", reason });
-      }
-    });
-    return () => {
-      isCancelled = true;
-    };
-  }, [coinlist, isReady, serverOffers]);
-  return { offersState };
-}
-
-// src/client/hooks/useCoinListRequirements.ts
-import { useCallback, useEffect as useEffect4, useState as useState4 } from "react";
-var LOADING_STATE3 = { type: "LOADING" };
-function useCoinListRequirements(offerId, options = {}) {
-  const { coinlist, isReady } = useCoinList();
-  const { serverData } = options;
-  const [requirementsState, setRequirementsState] = useState4(
-    serverData !== void 0 ? { type: "CONTENT", ...serverData } : LOADING_STATE3
-  );
-  const [fetchKey, setFetchKey] = useState4(0);
-  const refetch = useCallback(() => setFetchKey((k) => k + 1), []);
-  useEffect4(() => {
-    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
-import { useEffect as useEffect5, useRef } from "react";
-function useCompleteCoinListOAuth(options) {
-  const { coinlist } = useCoinList();
-  const postOAuthCompleteRef = useRef(options.postOAuthComplete);
-  const onFailureRef = useRef(options.onFailure);
-  const onSuccessRef = useRef(options.onSuccess);
-  postOAuthCompleteRef.current = options.postOAuthComplete;
-  onFailureRef.current = options.onFailure;
-  onSuccessRef.current = options.onSuccess;
-  const hasStartedExchangeRef = useRef(false);
-  useEffect5(() => {
-    if (typeof window === "undefined") return;
-    const params = new URLSearchParams(window.location.search);
-    if (!params.has("code") && !params.has("error")) return;
-    if (hasStartedExchangeRef.current) return;
-    const oauthResult = coinlist.completeOAuth();
-    if (oauthResult.type === "error") {
-      void Promise.resolve(onFailureRef.current(oauthResult.reason)).catch(
-        () => {
-        }
-      );
-      return;
-    }
-    hasStartedExchangeRef.current = true;
-    let cancelled = false;
-    void (async () => {
-      try {
-        const ok = await postOAuthCompleteRef.current({
-          code: oauthResult.code,
-          codeVerifier: oauthResult.codeVerifier
-        });
-        if (cancelled) return;
-        if (!ok) {
-          hasStartedExchangeRef.current = false;
-          await onFailureRef.current("complete_request_failed");
-          return;
-        }
-        await coinlist.init();
-        if (cancelled) return;
-        await onSuccessRef.current();
-      } catch {
-        if (cancelled) return;
-        hasStartedExchangeRef.current = false;
-        await onFailureRef.current("complete_request_failed");
-      }
-    })();
-    return () => {
-      cancelled = true;
-      hasStartedExchangeRef.current = false;
-    };
-  }, [coinlist]);
-}
-
-// src/client/hooks/useParticipations.ts
-import { useEffect as useEffect6, useState as useState5 } from "react";
-var LOADING_STATE4 = { type: "LOADING" };
-function useParticipations(offerId, options = {}) {
-  const { coinlist, isReady } = useCoinList();
-  const { serverData } = options;
-  const [participationsState, setParticipationsState] = useState5(
-    serverData !== void 0 ? { type: "CONTENT", participations: serverData } : LOADING_STATE4
-  );
-  useEffect6(() => {
-    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 };
-}
-
-export {
-  CoinListProvider,
-  useCoinList,
-  useCoinListOfferDetails,
-  useCoinListOffers,
-  useCoinListRequirements,
-  useCompleteCoinListOAuth,
-  useParticipations
-};
-//# sourceMappingURL=chunk-UGJUTRXC.js.map

package/dist/chunk-UGJUTRXC.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/client/hooks/useCoinList.ts","../src/client/CoinListProvider.tsx","../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":["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","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":["useEffect","useState","useState","useEffect","useEffect","useState","LOADING_STATE","useState","useEffect","useEffect","useState","LOADING_STATE","useState","useEffect","useEffect","useEffect","useEffect","useState","LOADING_STATE","useState","useEffect"]}

package/dist/chunk-YJQMJFA7.js

@@ -1,16 +0,0 @@
-// src/shared/types/user.ts
-var UserId = (value) => value;
-var UserEmail = (value) => value;
-var User = {
-  fromDto: (dto) => ({
-    id: UserId(dto.id),
-    email: UserEmail(dto.email)
-  })
-};
-
-export {
-  UserId,
-  UserEmail,
-  User
-};
-//# sourceMappingURL=chunk-YJQMJFA7.js.map

package/dist/chunk-YJQMJFA7.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/types/user.ts"],"sourcesContent":["import type { UserDto } from '@/shared/types/dto/user';\nimport type { Newtype } from '@/shared/types/newtype';\n\nexport type UserId = Newtype<string, 'UserId'>;\nexport const UserId = (value: string) => value as UserId;\nexport type UserEmail = Newtype<string, 'UserEmail'>;\nexport const UserEmail = (value: string) => value as UserEmail;\n\nexport type User = {\n  id: UserId;\n  email: UserEmail;\n};\n\nexport const User = {\n  fromDto: (dto: UserDto): User => ({\n    id: UserId(dto.id),\n    email: UserEmail(dto.email),\n  }),\n};\n"],"mappings":";AAIO,IAAM,SAAS,CAAC,UAAkB;AAElC,IAAM,YAAY,CAAC,UAAkB;AAOrC,IAAM,OAAO;AAAA,EAClB,SAAS,CAAC,SAAwB;AAAA,IAChC,IAAI,OAAO,IAAI,EAAE;AAAA,IACjB,OAAO,UAAU,IAAI,KAAK;AAAA,EAC5B;AACF;","names":[]}