@coinlist-co/react 0.0.2 → 0.1.1

package/dist/client/core/index.js

@@ -4,8 +4,23 @@ import {
   UserId
 } from "../../chunk-YJQMJFA7.js";
 import {
-  createCoinListClient
-} from "../../chunk-S56KGI3U.js";
+  Cursor,
+  FaqItem,
+  Link,
+  Milestone,
+  Offer,
+  OfferDetail,
+  OfferId,
+  OfferOption,
+  OfferOptionId,
+  OfferOptionSlug,
+  OfferSlug,
+  PaginatedResponse,
+  PaginationParams,
+  TermItem,
+  createCoinListClient,
+  fetchAllPages
+} from "../../chunk-6CG7JT7Q.js";
 import {
   OAuthRefreshToken,
   OAuthSession
@@ -17,19 +32,34 @@ import {
   CodeChallenge,
   CodeVerifier,
   RedirectUri
-} from "../../chunk-W6ZBUBLA.js";
+} from "../../chunk-GRVV7NLV.js";
 export {
   AuthorizationCode,
   ClientId,
   ClientSecret,
   CodeChallenge,
   CodeVerifier,
+  Cursor,
+  FaqItem,
+  Link,
+  Milestone,
   OAuthRefreshToken,
   OAuthSession,
+  Offer,
+  OfferDetail,
+  OfferId,
+  OfferOption,
+  OfferOptionId,
+  OfferOptionSlug,
+  OfferSlug,
+  PaginatedResponse,
+  PaginationParams,
   RedirectUri,
+  TermItem,
   User,
   UserEmail,
   UserId,
-  createCoinListClient
+  createCoinListClient,
+  fetchAllPages
 };
 //# sourceMappingURL=index.js.map

package/dist/client/hooks/index.cjs

@@ -20,7 +20,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/client/hooks/index.ts
 var hooks_exports = {};
 __export(hooks_exports, {
-  useCoinList: () => useCoinList
+  useCoinList: () => useCoinList,
+  useCoinListOfferDetails: () => useCoinListOfferDetails,
+  useCoinListOffers: () => useCoinListOffers,
+  useCompleteCoinListOAuth: () => useCompleteCoinListOAuth
 });
 module.exports = __toCommonJS(hooks_exports);
 
@@ -29,6 +32,16 @@ var import_react2 = require("react");
 
 // src/client/CoinListProvider.tsx
 var import_react = require("react");
+
+// src/shared/types/errors.ts
+var NotAuthenticatedError = class extends Error {
+  constructor(message = "The user is not authenticated. Go through the OAuth flow first!") {
+    super(message);
+    this.name = "NotAuthenticatedError";
+  }
+};
+
+// src/client/CoinListProvider.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var CoinListContext = (0, import_react.createContext)(null);
 
@@ -49,8 +62,129 @@ var CoinListClientInitializationError = class extends Error {
     this.name = "CoinListClientInitializationError";
   }
 };
+
+// src/client/hooks/useCoinListOfferDetails.ts
+var import_react3 = require("react");
+var LOADING_STATE = { type: "LOADING" };
+function useCoinListOfferDetails(offerId) {
+  const { coinlist, isReady } = useCoinList();
+  const [offerDetailsState, setOfferDetailsState] = (0, import_react3.useState)(LOADING_STATE);
+  (0, import_react3.useEffect)(() => {
+    let isCancelled = false;
+    if (!isReady) {
+      setOfferDetailsState(LOADING_STATE);
+      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]);
+  return { offerDetailsState };
+}
+
+// src/client/hooks/useCoinListOffers.ts
+var import_react4 = require("react");
+var LOADING_STATE2 = { type: "LOADING" };
+function useCoinListOffers() {
+  const { coinlist, isReady } = useCoinList();
+  const [offersState, setOffersState] = (0, import_react4.useState)(LOADING_STATE2);
+  (0, import_react4.useEffect)(() => {
+    let isCancelled = false;
+    if (!isReady) {
+      setOffersState(LOADING_STATE2);
+      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]);
+  return { offersState };
+}
+
+// src/client/hooks/useCompleteCoinListOAuth.ts
+var import_react5 = 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);
+  postOAuthCompleteRef.current = options.postOAuthComplete;
+  onFailureRef.current = options.onFailure;
+  onSuccessRef.current = options.onSuccess;
+  const hasStartedExchangeRef = (0, import_react5.useRef)(false);
+  (0, import_react5.useEffect)(() => {
+    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]);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  useCoinList
+  useCoinList,
+  useCoinListOfferDetails,
+  useCoinListOffers,
+  useCompleteCoinListOAuth
 });
 //# 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"],"sourcesContent":["export { useCoinList } from '@/client/hooks/useCoinList';\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,IAAAA,gBAA2B;;;ACK3B,mBAMO;AAqDH;AAzCG,IAAM,sBAAkB,4BAA2C,IAAI;;;ADVvE,SAAS,cAAiC;AAC/C,QAAM,cAAU,0BAAW,eAAe;AAC1C,MAAI,YAAY,MAAM;AACpB,UAAM,IAAI,kCAAkC;AAAA,EAC9C;AAEA,SAAO;AAAA,IACL,SAAS,QAAQ;AAAA,IACjB,UAAU,QAAQ;AAAA,EACpB;AACF;AAEO,IAAM,oCAAN,cAAgD,MAAM;AAAA,EAC3D,YACE,UAAU,2GACV;AACA,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;","names":["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/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"]}

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

@@ -1,14 +1,55 @@
-import { a as CoinListClient } from '../../coinlist-client-BH_Cn_7u.cjs';
-import '../../oauth-session-g0OPJNKn.cjs';
+export { C as CompleteCoinListOAuthFailureReason, U as UseCompleteCoinListOAuthOptions, u as useCoinList, a as useCompleteCoinListOAuth } from '../../useCompleteCoinListOAuth-6Z4DGuiH.cjs';
+import { a as OfferId, O as Offer } from '../../offer-D6p_Ijme.cjs';
+import { d as OfferDetail } from '../../coinlist-client-DXKFDGhP.cjs';
+import '../../oauth-session-DgItaMKN.cjs';
+import '../../newtype-yKTvFdg_.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;
+type LoadOfferDetailsReason = 'not-authenticated' | 'generic-error';
+type LoadOfferDetailsState = {
+    type: 'LOADING';
+} | {
+    type: 'ERROR';
+    reason: LoadOfferDetailsReason;
+} | {
+    type: 'CONTENT';
+    offerDetail: OfferDetail;
+};
+interface UseCoinListOfferDetailsResult {
+    offerDetailsState: LoadOfferDetailsState;
 }
-declare function useCoinList(): UseCoinListResult;
+/**
+ * Loads CoinList offer details for a given offer id and exposes a UI-friendly state.
+ *
+ * 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;
 
-export { useCoinList };
+type LoadOffersReason = 'not-authenticated' | 'generic-error';
+type LoadOffersState = {
+    type: 'LOADING';
+} | {
+    type: 'ERROR';
+    reason: LoadOffersReason;
+} | {
+    type: 'CONTENT';
+    offers: Offer[];
+};
+interface UseCoinListOffersResult {
+    offersState: LoadOffersState;
+}
+/**
+ * Loads all CoinList offers for the current user and exposes a UI-friendly state.
+ *
+ * Returns `LOADING` while CoinList is initializing or while offers are being fetched.
+ * Returns `CONTENT` with all offers when `fetchAllOffers()` succeeds.
+ * Returns `ERROR` with:
+ * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
+ * - `generic-error` for any other failure
+ */
+declare function useCoinListOffers(): UseCoinListOffersResult;
+
+export { useCoinListOfferDetails, useCoinListOffers };

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

@@ -1,14 +1,55 @@
-import { a as CoinListClient } from '../../coinlist-client-fkB3J-2a.js';
-import '../../oauth-session-g0OPJNKn.js';
+export { C as CompleteCoinListOAuthFailureReason, U as UseCompleteCoinListOAuthOptions, u as useCoinList, a as useCompleteCoinListOAuth } from '../../useCompleteCoinListOAuth-C3G1Vsf8.js';
+import { a as OfferId, O as Offer } from '../../offer-DnFEFJw9.js';
+import { d as OfferDetail } from '../../coinlist-client-BiA8a2yU.js';
+import '../../oauth-session-DnKDI5ou.js';
+import '../../newtype-yKTvFdg_.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;
+type LoadOfferDetailsReason = 'not-authenticated' | 'generic-error';
+type LoadOfferDetailsState = {
+    type: 'LOADING';
+} | {
+    type: 'ERROR';
+    reason: LoadOfferDetailsReason;
+} | {
+    type: 'CONTENT';
+    offerDetail: OfferDetail;
+};
+interface UseCoinListOfferDetailsResult {
+    offerDetailsState: LoadOfferDetailsState;
 }
-declare function useCoinList(): UseCoinListResult;
+/**
+ * Loads CoinList offer details for a given offer id and exposes a UI-friendly state.
+ *
+ * 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;
 
-export { useCoinList };
+type LoadOffersReason = 'not-authenticated' | 'generic-error';
+type LoadOffersState = {
+    type: 'LOADING';
+} | {
+    type: 'ERROR';
+    reason: LoadOffersReason;
+} | {
+    type: 'CONTENT';
+    offers: Offer[];
+};
+interface UseCoinListOffersResult {
+    offersState: LoadOffersState;
+}
+/**
+ * Loads all CoinList offers for the current user and exposes a UI-friendly state.
+ *
+ * Returns `LOADING` while CoinList is initializing or while offers are being fetched.
+ * Returns `CONTENT` with all offers when `fetchAllOffers()` succeeds.
+ * Returns `ERROR` with:
+ * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
+ * - `generic-error` for any other failure
+ */
+declare function useCoinListOffers(): UseCoinListOffersResult;
+
+export { useCoinListOfferDetails, useCoinListOffers };

package/dist/client/hooks/index.js

@@ -1,9 +1,17 @@
 import {
-  useCoinList
-} from "../../chunk-CGIPLHD3.js";
-import "../../chunk-S56KGI3U.js";
-import "../../chunk-W6ZBUBLA.js";
+  useCoinListOfferDetails,
+  useCoinListOffers
+} from "../../chunk-WFA6X7E2.js";
+import {
+  useCoinList,
+  useCompleteCoinListOAuth
+} from "../../chunk-DLEKT4T4.js";
+import "../../chunk-6CG7JT7Q.js";
+import "../../chunk-GRVV7NLV.js";
 export {
-  useCoinList
+  useCoinList,
+  useCoinListOfferDetails,
+  useCoinListOffers,
+  useCompleteCoinListOAuth
 };
 //# sourceMappingURL=index.js.map