@coinlist-co/react 0.1.2 → 0.3.0

package/dist/useCoinListRequirements-BECx1cIw.d.ts

@@ -0,0 +1,31 @@
+import { d as OfferOptionId, R as Requirement, h as RequirementStatusInfo, b as OfferId } from './requirement-fJsQ3f9_.js';
+
+type LoadRequirementsReason = 'not-authenticated' | 'generic-error';
+type LoadRequirementsState = {
+    type: 'LOADING';
+} | {
+    type: 'ERROR';
+    reason: LoadRequirementsReason;
+} | {
+    type: 'CONTENT';
+    requirementsByOptionId: Record<OfferOptionId, Requirement[]>;
+    statuses: RequirementStatusInfo[];
+};
+interface UseCoinListRequirementsResult {
+    requirementsState: LoadRequirementsState;
+    /** Triggers a re-fetch of requirements and statuses. */
+    refetch: () => void;
+}
+/**
+ * Loads requirements (grouped by option ID) and requirement statuses for a
+ * given offer, then exposes them via a state machine.
+ *
+ * Returns `LOADING` while CoinList is initializing or while data is being fetched.
+ * Returns `CONTENT` with requirementsByOptionId and statuses on success.
+ * Returns `ERROR` with:
+ * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
+ * - `generic-error` for any other failure
+ */
+declare function useCoinListRequirements(offerId: OfferId): UseCoinListRequirementsResult;
+
+export { type LoadRequirementsReason as L, type UseCoinListRequirementsResult as U, type LoadRequirementsState as a, useCoinListRequirements as u };

package/dist/useCoinListRequirements-CX2gV9gJ.d.cts

@@ -0,0 +1,31 @@
+import { d as OfferOptionId, R as Requirement, h as RequirementStatusInfo, b as OfferId } from './requirement-CxbdY8l4.cjs';
+
+type LoadRequirementsReason = 'not-authenticated' | 'generic-error';
+type LoadRequirementsState = {
+    type: 'LOADING';
+} | {
+    type: 'ERROR';
+    reason: LoadRequirementsReason;
+} | {
+    type: 'CONTENT';
+    requirementsByOptionId: Record<OfferOptionId, Requirement[]>;
+    statuses: RequirementStatusInfo[];
+};
+interface UseCoinListRequirementsResult {
+    requirementsState: LoadRequirementsState;
+    /** Triggers a re-fetch of requirements and statuses. */
+    refetch: () => void;
+}
+/**
+ * Loads requirements (grouped by option ID) and requirement statuses for a
+ * given offer, then exposes them via a state machine.
+ *
+ * Returns `LOADING` while CoinList is initializing or while data is being fetched.
+ * Returns `CONTENT` with requirementsByOptionId and statuses on success.
+ * Returns `ERROR` with:
+ * - `not-authenticated` when fetching fails with {@link NotAuthenticatedError}
+ * - `generic-error` for any other failure
+ */
+declare function useCoinListRequirements(offerId: OfferId): UseCoinListRequirementsResult;
+
+export { type LoadRequirementsReason as L, type UseCoinListRequirementsResult as U, type LoadRequirementsState as a, useCoinListRequirements as u };

package/dist/{useCompleteCoinListOAuth-6Z4DGuiH.d.cts → useCompleteCoinListOAuth-BRhAqD4_.d.cts}

@@ -1,4 +1,4 @@
-import { a as CoinListClient, O as OauthClientErrorReason } from './coinlist-client-DXKFDGhP.cjs';
+import { a as CoinListClient, O as OauthClientErrorReason } from './coinlist-client-DBKa6j3f.cjs';
 import { A as AuthorizationCode, c as CodeVerifier } from './oauth-session-DgItaMKN.cjs';
 
 interface UseCoinListResult {

package/dist/{useCompleteCoinListOAuth-C3G1Vsf8.d.ts → useCompleteCoinListOAuth-DEZpHjd6.d.ts}

@@ -1,4 +1,4 @@
-import { a as CoinListClient, O as OauthClientErrorReason } from './coinlist-client-BiA8a2yU.js';
+import { a as CoinListClient, O as OauthClientErrorReason } from './coinlist-client-B_dJkbwB.js';
 import { A as AuthorizationCode, c as CodeVerifier } from './oauth-session-DnKDI5ou.js';
 
 interface UseCoinListResult {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinlist-co/react",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "CoinList Partner SDK",
   "type": "module",
   "main": "./dist/client/index.cjs",
@@ -96,10 +96,10 @@
     "storybook:build": "storybook build",
     "typecheck": "tsc --noEmit",
     "biome:check": "biome check .",
-    "lint:fix": "biome check . --write --unsafe",
     "deslop": "deslop --check",
-    "deslop:fix": "deslop && npm run lint:fix",
-    "check": "npm run typecheck && npm run biome:check && npm run deslop && npm run build && npm run storybook:build && npm run test && npm run test:e2e && npm run test:e2e:browser"
+    "lint": "npm run biome:check && npm run deslop",
+    "lint:fix": "deslop && biome check . --write --unsafe",
+    "check": "npm run typecheck && npm run lint && npm run build && npm run storybook:build && npm run test && npm run test:e2e && npm run test:e2e:browser"
   },
   "repository": {
     "type": "git",

package/dist/chunk-6CG7JT7Q.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/shared/api/pagination.ts","../src/shared/utils.ts","../src/shared/types/offer.ts","../src/shared/types/asset.ts","../src/shared/types/offer-detail.ts","../src/client/core/api/middleware/attach-session-middleware.ts","../src/client/core/api/middleware/session-renewal.ts","../src/client/core/api/middleware/device-id.ts","../src/client/core/api/middleware/user-agent.ts","../src/shared/api/middleware/idempotency-key.ts","../src/client/core/api/api-client.ts","../src/shared/types/errors.ts","../src/client/core/coinlist-client.ts"],"sourcesContent":["import type { QueryParamValue } from '@/shared/api/http';\nimport type { Newtype } from '@/shared/types/newtype';\n\nexport type Cursor = Newtype<string, 'Cursor'>;\nexport const Cursor = (value: string) => value as Cursor;\n\n/**\n * Cursor-based pagination input used when requesting paginated API resources.\n * Set `after` or `before` to navigate relative to a known cursor, and `limit`\n * to control the maximum number of returned items.\n */\nexport interface PaginationParams {\n  before?: Cursor;\n  after?: Cursor;\n  limit?: number;\n}\n\nexport interface PaginatedResponseDto<T> {\n  data: T[];\n  starting_after?: string;\n  starting_before?: string;\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  startingAfter: Cursor | null;\n  startingBefore: Cursor | null;\n}\n\nexport async function fetchAllPages<A>(\n  fetchPage: (params: PaginationParams) => Promise<PaginatedResponse<A>>\n): Promise<A[]> {\n  const items: A[] = [];\n  let cursor: Cursor | null = null;\n\n  do {\n    const page = await fetchPage({\n      after: cursor ?? undefined,\n    });\n    items.push(...page.data);\n    cursor = page.startingAfter;\n  } while (cursor);\n\n  return items;\n}\n\nexport const PaginatedResponse = {\n  fromDto: <A, B>(\n    dto: PaginatedResponseDto<A>,\n    itemMapper: (item: A) => B\n  ): PaginatedResponse<B> => ({\n    data: dto.data.map(itemMapper),\n    startingAfter: dto.starting_after ? Cursor(dto.starting_after) : null,\n    startingBefore: dto.starting_before ? Cursor(dto.starting_before) : null,\n  }),\n};\n\nexport const PaginationParams = {\n  toQueryParams: (\n    params: PaginationParams\n  ): Record<string, QueryParamValue> => {\n    const queryParams: Record<string, QueryParamValue> = {};\n    if (params.after) {\n      queryParams.starting_after = params.after;\n    }\n    if (params.before) {\n      queryParams.starting_before = params.before;\n    }\n    if (params.limit) {\n      queryParams.limit = params.limit;\n    }\n    return queryParams;\n  },\n};\n","/**\n * Computes SHA-256 digest of the input (UTF-8 string or raw bytes).\n * Uses the Web Crypto API.\n */\nexport async function sha256(data: string | Uint8Array): Promise<ArrayBuffer> {\n  const bytes =\n    typeof data === 'string' ? new TextEncoder().encode(data) : data;\n  const buffer = bytes.buffer.slice(\n    bytes.byteOffset,\n    bytes.byteOffset + bytes.byteLength\n  ) as ArrayBuffer;\n  return crypto.subtle.digest('SHA-256', buffer);\n}\n\n/**\n * Converts an ArrayBuffer to Base64-URL encoding (RFC 4648).\n * @param padding - If false, omits trailing '=' padding (e.g. for PKCE).\n */\nexport function arrayBufferToBase64Url(\n  buffer: ArrayBuffer,\n  padding: boolean = true\n): string {\n  const bytes = new Uint8Array(buffer);\n  let binary = '';\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  let base64 = btoa(binary);\n  base64 = base64.replace(/\\+/g, '-').replace(/\\//g, '_');\n  if (!padding) {\n    base64 = base64.replace(/=+$/, '');\n  }\n  return base64;\n}\n\n/**\n * Securely generates random bytes and returns them as Base64-URL (no padding).\n * Suitable for PKCE code_verifier and OAuth state.\n * @param byteLength - Number of random bytes (e.g. 32 for PKCE).\n */\nexport function generateSecureRandomBase64Url(byteLength: number): string {\n  const bytes = new Uint8Array(byteLength);\n  crypto.getRandomValues(bytes);\n  const buffer = bytes.buffer;\n  return arrayBufferToBase64Url(buffer, false);\n}\n\n/**\n * Generate a UUID v4 using the standard Web Crypto API (crypto.randomUUID).\n * Falls back to RFC 4122–compliant generation via crypto.getRandomValues in old browsers.\n */\nexport function getUUIDv4(): string {\n  if (\n    typeof crypto !== 'undefined' &&\n    typeof crypto.randomUUID === 'function'\n  ) {\n    return crypto.randomUUID();\n  }\n\n  if (\n    typeof crypto !== 'undefined' &&\n    typeof crypto.getRandomValues === 'function'\n  ) {\n    const bytes = new Uint8Array(16);\n    crypto.getRandomValues(bytes);\n    bytes[6] = (bytes[6] & 0x0f) | 0x40;\n    bytes[8] = (bytes[8] & 0x3f) | 0x80;\n    const hex = Array.from(bytes, (b) => b.toString(16).padStart(2, '0'));\n    return `${hex.slice(0, 4).join('')}-${hex.slice(4, 6).join('')}-${hex.slice(6, 8).join('')}-${hex.slice(8, 10).join('')}-${hex.slice(10, 16).join('')}`;\n  }\n\n  return `${Date.now()}-${Math.random().toString(36).slice(2, 12)}`;\n}\n\nexport function notBlankStringOrNull(value?: string | null): string | null {\n  if (value?.trim()) {\n    return value;\n  } else {\n    return null;\n  }\n}\n","import type { OfferDto } from '@/shared/types/dto/offer';\nimport type { Newtype } from '@/shared/types/newtype';\nimport { notBlankStringOrNull } from '@/shared/utils';\n\nexport type OfferId = Newtype<string, 'OfferId'>;\nexport const OfferId = (value: string) => value as OfferId;\n\nexport type OfferSlug = Newtype<string, 'OfferSlug'>;\nexport const OfferSlug = (value: string) => value as OfferSlug;\n\nexport type Offer = {\n  id: OfferId;\n  slug: OfferSlug;\n  tagline: string | null;\n  bannerUrl: string | null;\n  logoUrl: string | null;\n  startsAt: Date;\n  endsAt: Date;\n};\n\nexport const Offer = {\n  fromDto: (dto: OfferDto): Offer => ({\n    id: OfferId(dto.id),\n    slug: OfferSlug(dto.slug),\n    tagline: notBlankStringOrNull(dto.tagline),\n    bannerUrl: notBlankStringOrNull(dto.banner_url),\n    logoUrl: notBlankStringOrNull(dto.logo_url),\n    startsAt: new Date(dto.starts_at),\n    endsAt: new Date(dto.ends_at),\n  }),\n};\n","import type { AssetDto } from '@/shared/types/dto/asset';\nimport type { Newtype } from '@/shared/types/newtype';\n\nexport type AssetId = Newtype<string, 'AssetId'>;\nexport const AssetId = (value: string) => value as AssetId;\n\nexport type AssetCode = Newtype<string, 'AssetCode'>;\nexport const AssetCode = (value: string) => value as AssetCode;\n\nexport type Asset = {\n  id: AssetId;\n  code: AssetCode;\n  name: string;\n  fractionalDigits: number;\n};\n\nexport const Asset = {\n  fromDto: (dto: AssetDto): Asset => ({\n    id: AssetId(dto.id),\n    code: AssetCode(dto.code),\n    name: dto.name,\n    fractionalDigits: dto.fractional_digits,\n  }),\n};\n","import { Asset } from '@/shared/types/asset';\nimport type {\n  OfferDetailDto,\n  OfferDetailFaqDto,\n  OfferDetailLinkDto,\n  OfferDetailMilestoneDto,\n  OfferDetailOptionDto,\n  OfferDetailTermDto,\n} from '@/shared/types/dto/offer-detail';\nimport type { Newtype } from '@/shared/types/newtype';\nimport { OfferId, OfferSlug } from '@/shared/types/offer';\nimport { notBlankStringOrNull } from '@/shared/utils';\n\nexport type OfferDetail = {\n  id: OfferId;\n  slug: OfferSlug;\n  name: string;\n\n  asset: Asset;\n  fundingAssets: Asset[];\n\n  about: string | null;\n  tagline: string | null;\n  bannerUrl: string | null;\n  logoUrl: string | null;\n  category: string | null;\n\n  startsAt: Date;\n  endsAt: Date;\n\n  faqs: FaqItem[];\n  links: Link[];\n  milestones: Milestone[];\n  options: OfferOption[];\n  terms: TermItem[];\n};\n\nexport type OfferOptionId = Newtype<string, 'OfferOptionId'>;\nexport const OfferOptionId = (value: string) => value as OfferOptionId;\n\nexport type OfferOptionSlug = Newtype<string, 'OfferOptionSlug'>;\nexport const OfferOptionSlug = (value: string) => value as OfferOptionSlug;\n\nexport type OfferOption = {\n  id: OfferOptionId;\n  slug: OfferOptionSlug;\n  bidIncrement: number | null;\n  floorPriceUsd: number | null;\n  minimumPurchaseUsd: number | null;\n  priceUsd: number | null;\n  saleAgreementUrl: string | null;\n  totalTokenSupply: number | null;\n};\n\nexport type FaqItem = {\n  question: string | null;\n  answer: string | null;\n};\n\nexport type TermItem = {\n  key: string | null;\n  value: string | null;\n};\n\nexport type Milestone = {\n  name: string | null;\n  schedule: string | null;\n  status: 'completed' | 'active' | 'upcoming';\n};\n\nexport type Link = {\n  label: string | null;\n  url: string | null;\n};\n\nexport const OfferDetail = {\n  fromDto: (dto: OfferDetailDto): OfferDetail => {\n    if (!Array.isArray(dto.funding_assets)) {\n      throw new Error(`funding_assets must be an array`);\n    }\n\n    if (!Array.isArray(dto.options)) {\n      throw new Error(`options must be an array`);\n    }\n\n    if (!Array.isArray(dto.terms)) {\n      throw new Error(`terms must be an array`);\n    }\n\n    if (!Array.isArray(dto.links)) {\n      throw new Error(`links must be an array`);\n    }\n\n    if (!Array.isArray(dto.faqs)) {\n      throw new Error(`faqs must be an array`);\n    }\n\n    if (!Array.isArray(dto.milestones)) {\n      throw new Error(`milestones must be an array`);\n    }\n\n    return {\n      id: OfferId(dto.id),\n      slug: OfferSlug(dto.slug),\n      name: dto.name,\n\n      asset: Asset.fromDto(dto.asset),\n      fundingAssets: dto.funding_assets.map(Asset.fromDto),\n\n      about: notBlankStringOrNull(dto.about),\n      tagline: notBlankStringOrNull(dto.tagline),\n      bannerUrl: notBlankStringOrNull(dto.banner_url),\n      logoUrl: notBlankStringOrNull(dto.logo_url),\n      category: notBlankStringOrNull(dto.category),\n\n      startsAt: new Date(dto.starts_at),\n      endsAt: new Date(dto.ends_at),\n\n      faqs: dto.faqs.map(FaqItem.fromDto),\n      links: dto.links.map(Link.fromDto),\n      milestones: dto.milestones.map(Milestone.fromDto),\n      options: dto.options.map(OfferOption.fromDto),\n      terms: dto.terms.map(TermItem.fromDto),\n    };\n  },\n};\n\nexport const OfferOption = {\n  fromDto: (dto: OfferDetailOptionDto): OfferOption => ({\n    id: OfferOptionId(dto.id),\n    slug: OfferOptionSlug(dto.slug),\n    bidIncrement: dto.bid_increment,\n    floorPriceUsd: dto.floor_price_usd,\n    minimumPurchaseUsd: dto.minimum_purchase_usd,\n    priceUsd: dto.price_usd,\n    saleAgreementUrl: notBlankStringOrNull(dto.sale_agreement_url),\n    totalTokenSupply: dto.total_token_supply,\n  }),\n};\n\nexport const FaqItem = {\n  fromDto: (dto: OfferDetailFaqDto): FaqItem => ({\n    question: notBlankStringOrNull(dto.question),\n    answer: notBlankStringOrNull(dto.answer),\n  }),\n};\n\nexport const Link = {\n  fromDto: (dto: OfferDetailLinkDto): Link => ({\n    label: notBlankStringOrNull(dto.label),\n    url: notBlankStringOrNull(dto.url),\n  }),\n};\n\nexport const TermItem = {\n  fromDto: (dto: OfferDetailTermDto): TermItem => ({\n    key: notBlankStringOrNull(dto.key),\n    value: notBlankStringOrNull(dto.value),\n  }),\n};\n\nexport const Milestone = {\n  fromDto: (dto: OfferDetailMilestoneDto): Milestone => ({\n    name: notBlankStringOrNull(dto.name),\n    schedule: notBlankStringOrNull(dto.schedule),\n    status: dto.status,\n  }),\n};\n","import type { HttpRequest } from '@/shared/api/http';\nimport { Attributes } from '@/shared/api/http-attributes';\nimport type { BeforeRequestMiddleware } from '@/shared/api/http-client';\nimport type { OAuthAccessToken } from '@/shared/types/oauth-session';\n\nexport function attachSessionMiddleware(\n  fetchAccessToken: (refresh: boolean) => Promise<OAuthAccessToken | null>\n): BeforeRequestMiddleware {\n  return async (request: HttpRequest): Promise<HttpRequest> => {\n    if (!Attributes.isProtected(request.attributes)) {\n      return request;\n    }\n\n    const accessToken = await fetchAccessToken(false);\n    if (accessToken === null) {\n      return request;\n    }\n\n    return {\n      ...request,\n      headers: {\n        ...(request.headers ?? {}),\n        Authorization: `Bearer ${accessToken.value}`,\n      },\n    };\n  };\n}\n","import { Request } from '@/shared/api/http';\nimport { Attributes } from '@/shared/api/http-attributes';\nimport type { AfterRequestMiddleware } from '@/shared/api/http-client';\nimport type { OAuthAccessToken } from '@/shared/types/oauth-session';\n\nexport function renewSessionMiddleware(\n  fetchAccessToken: (refresh: boolean) => Promise<OAuthAccessToken | null>\n): AfterRequestMiddleware {\n  return async ({ request, response, retry }) => {\n    if (response.status !== 401) {\n      return response;\n    }\n    if (!Attributes.isProtected(request.attributes)) {\n      return response;\n    }\n    if (Attributes.wasRenewAttempted(request.attributes)) {\n      return response;\n    }\n\n    const newToken = await fetchAccessToken(true);\n    if (newToken) {\n      const nextRequest = Request.concatAttributes(\n        request,\n        Attributes.renewAttempted(true)\n      );\n      return retry(nextRequest);\n    } else {\n      return response;\n    }\n  };\n}\n","'use client';\n\nimport { getUUIDv4 } from '@/shared/utils';\n\nconst DEVICE_ID_KEY = 'coinlist.device_id';\n\n/**\n * Get or create a device ID stored in localStorage.\n * Uses a crypto UUID that persists across sessions.\n */\nexport function getDeviceId(): string {\n  let deviceId = localStorage.getItem(DEVICE_ID_KEY);\n\n  if (!deviceId) {\n    deviceId = getUUIDv4();\n    localStorage.setItem(DEVICE_ID_KEY, deviceId);\n  }\n\n  return deviceId;\n}\n\n/**\n * Clear the stored device ID (useful for testing or logout).\n */\nexport function clearDeviceId(): void {\n  localStorage.removeItem(DEVICE_ID_KEY);\n}\n","'use client';\n\nimport { getDeviceId } from '@/client/core/api/middleware/device-id';\nimport { HEADER_USER_AGENT } from '@/shared/api/frontline';\nimport type { HttpRequest } from '@/shared/api/http';\nimport { Attributes } from '@/shared/api/http-attributes';\nimport type { BeforeRequestMiddleware } from '@/shared/api/http-client';\n\nexport const userAgentMiddleware: BeforeRequestMiddleware = async (\n  request: HttpRequest\n): Promise<HttpRequest> => {\n  if (!Attributes.needUserAgent(request.attributes)) {\n    return request;\n  }\n\n  const userAgent = generateUserAgent();\n  return {\n    ...request,\n    headers: {\n      ...(request.headers ?? {}),\n      [HEADER_USER_AGENT]: userAgent,\n    },\n  };\n};\n\n// Generate User-Agent in the required format for Frontline API\n// Format: <app-info> (<device-info>; DevicePlatform <device-platform>; DeviceAppID <device-app-id>; DeviceID <device-id>)\nfunction generateUserAgent(): string {\n  const appInfo = `CoinList/1.0`;\n  const deviceInfo = 'Web Browser';\n  const devicePlatform = 'DevicePlatform web'; // Must be 'web' for validation\n\n  const deviceAppId = 'DeviceAppID co.coinlist.sdk'; // SDK app ID\n\n  const deviceId = getDeviceId();\n  const finalDeviceId = `DeviceID ${deviceId}`;\n\n  return `${appInfo} (${deviceInfo}; ${devicePlatform}; ${deviceAppId}; ${finalDeviceId})`;\n}\n","import { HEADER_IDEMPOTENCY_KEY } from '@/shared/api/frontline';\nimport type { HttpRequest } from '@/shared/api/http';\nimport { Attributes } from '@/shared/api/http-attributes';\nimport type { BeforeRequestMiddleware } from '@/shared/api/http-client';\nimport { getUUIDv4 } from '@/shared/utils';\n\nexport const idempotencyKeyMiddleware: BeforeRequestMiddleware = async (\n  request: HttpRequest\n): Promise<HttpRequest> => {\n  if (!Attributes.isIdempotent(request.attributes)) {\n    return request;\n  }\n\n  const existingHeaders = request.headers ?? {};\n  if (existingHeaders[HEADER_IDEMPOTENCY_KEY]) {\n    return request;\n  }\n\n  return {\n    ...request,\n    headers: {\n      ...existingHeaders,\n      [HEADER_IDEMPOTENCY_KEY]: getUUIDv4(),\n    },\n  };\n};\n","'use client';\n\nimport { attachSessionMiddleware } from '@/client/core/api/middleware/attach-session-middleware';\nimport { renewSessionMiddleware } from '@/client/core/api/middleware/session-renewal';\nimport { userAgentMiddleware } from '@/client/core/api/middleware/user-agent';\nimport {\n  type HttpClientConfig,\n  HttpError,\n  type HttpRequest,\n} from '@/shared/api/http';\nimport { HttpClient } from '@/shared/api/http-client';\nimport { idempotencyKeyMiddleware } from '@/shared/api/middleware/idempotency-key';\nimport { requestRetryMiddleware } from '@/shared/api/middleware/request-retry';\nimport type { OAuthAccessToken } from '@/shared/types/oauth-session';\n\nexport class ApiClient {\n  private readonly httpClient: HttpClient;\n\n  constructor(\n    readonly config: HttpClientConfig,\n    readonly fetchAccessToken: (\n      refresh: boolean\n    ) => Promise<OAuthAccessToken | null>\n  ) {\n    this.httpClient = new HttpClient(this.config, {\n      beforeRequest: [\n        attachSessionMiddleware(this.fetchAccessToken),\n        userAgentMiddleware,\n        idempotencyKeyMiddleware,\n      ],\n      afterRequest: [\n        renewSessionMiddleware(this.fetchAccessToken),\n        requestRetryMiddleware,\n      ],\n    });\n  }\n\n  async send<TResponse>(request: HttpRequest): Promise<TResponse> {\n    const response = await this.httpClient.send<TResponse>(request);\n    if (response.status >= 200 && response.status < 300) {\n      return response.body as TResponse;\n    } else {\n      throw new HttpError(response);\n    }\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","'use client';\n\nimport { ApiClient } from '@/client/core/api/api-client';\nimport type {\n  AuthState,\n  OauthClientResult,\n} from '@/client/core/types/client-types';\nimport {\n  API_VERSION,\n  COINLIST_OAUTH_PAGE_URL,\n  PUBLIC_API_BASE_URL,\n} from '@/shared/api/frontline';\nimport { Attributes } from '@/shared/api/http-attributes';\nimport {\n  fetchAllPages,\n  PaginatedResponse,\n  type PaginatedResponseDto,\n  PaginationParams,\n} from '@/shared/api/pagination';\nimport type { Config } from '@/shared/types/config';\nimport type { OfferDto } from '@/shared/types/dto/offer';\nimport type { OfferDetailDto } from '@/shared/types/dto/offer-detail';\nimport { NotAuthenticatedError } from '@/shared/types/errors';\nimport { AuthorizationCode, CodeVerifier } from '@/shared/types/oauth';\nimport type { OAuthAccessToken } from '@/shared/types/oauth-session';\nimport { Offer, type OfferId } from '@/shared/types/offer';\nimport { OfferDetail } from '@/shared/types/offer-detail';\nimport {\n  arrayBufferToBase64Url,\n  generateSecureRandomBase64Url,\n  sha256,\n} from '@/shared/utils';\n\n/** Session storage keys for OAuth PKCE (used by startOauth and completeOauth). */\nexport const OAUTH_STATE_KEY = 'coinlist.oauth_state';\nexport const OAUTH_CODE_VERIFIER_KEY = 'coinlist.oauth_code_verifier';\n\nexport interface ClientConfig extends Config {\n  /**\n   * The SDK user must provide this function. It is responsible for fetching a\n   * valid {@link OAuthAccessToken}, or **null** for logged-out users. If your\n   * backend is in TypeScript, it is recommended to use\n   * {@link CoinListServer#accessToken} from `@/server/coinlist.server`.\n   */\n  getAccessToken: () => Promise<OAuthAccessToken | null>;\n  /**\n   * Recommended to leave undefined. Used to change the CoinList environment;\n   * default is production.\n   */\n  authorizationPageUrl?: string;\n}\n\nexport interface CoinListClient {\n  /**\n   * Calls the provided {@link ClientConfig.getAccessToken} lambda to determine\n   * the user's {@link AuthState}. This is called automatically by {@link CoinListProvider};\n   * you typically do not need to call it yourself unless you are using the client\n   * outside of the provider.\n   */\n  init(): Promise<AuthState>;\n  /**\n   * Returns the current auth state: `'logged-in'`, `'logged-out'`, or `'unknown'`.\n   * Returns **unknown** until {@link CoinListClient.init} has completed. It is\n   * recommended to use the `const { isReady, coinlist } = useCoinList()` hook to know when\n   * the SDK has initialized, or to manually await {@link CoinListClient.init}\n   * before relying on this value.\n   */\n  getAuthState(): AuthState;\n  /**\n   * Starts the OAuth flow with PKCE. Generates a random `state` and `code_verifier`,\n   * stores them in sessionStorage (for validation in {@link CoinListClient.completeOAuth}\n   * on redirect), then redirects the user to the CoinList authorization page. After\n   * the user authorizes, they are sent back to your application's redirect URI; call\n   * {@link CoinListClient.completeOAuth} on that page to finish the flow.\n   */\n  startOAuth(): Promise<void>;\n  /**\n   * Completes the OAuth flow on the FE with PKCE and state validation. Parses the\n   * redirect URL (state, code) and validates them against sessionStorage\n   * (state, code_verifier). The state check protects against CSRF (cross-site\n   * request forgery). Call this on the frontend page the user is redirected\n   * to after authorizing.\n   *\n   * On `ok`: Call your backend to exchange the short-lived `authorizationCode`\n   * (and the returned `codeVerifier`) for a long-lived session. If your backend\n   * is in TypeScript, you can use {@link CoinListServer#completeOAuth} from\n   * `@/server/coinlist.server` (CoinListServer) to perform that exchange.\n   *\n   * On `error`: `reason` is an {@link OauthClientErrorReason} (e.g. `'missing_state'`, `'invalid_state'`) so you can switch on it and surface a message to the user.\n   */\n  completeOAuth(): OauthClientResult;\n  /**\n   * Clears the in-memory access token. Note: you need to manually\n   * also logout on the backend via CoinListServer#logout to clear the session cookie.\n   */\n  logout(): void;\n\n  /**\n   * Fetches all offers by iterating through every paginated response.\n   *\n   * This method must be called only when the user's {@link AuthState} is\n   * `'logged-in'`. If the user is not authenticated, it throws\n   * {@link NotAuthenticatedError}.\n   */\n  fetchAllOffers(): Promise<Offer[]>;\n  /**\n   * Fetches a single page of offers.\n   *\n   * This method must be called only when the user's {@link AuthState} is\n   * `'logged-in'`. If the user is not authenticated, it throws\n   * {@link NotAuthenticatedError}.\n   */\n  fetchOffersPage(params: PaginationParams): Promise<PaginatedResponse<Offer>>;\n  /**\n   * Fetches details for a given offer by its id.\n   *\n   * This method must be called only when the user's {@link AuthState} is\n   * `'logged-in'`. If the user is not authenticated, it throws\n   * {@link NotAuthenticatedError}.\n   */\n  fetchOfferDetails(id: OfferId): Promise<OfferDetail>;\n}\n\nclass CoinListClientImpl implements CoinListClient {\n  /** Cached access token: undefined = loading, null = no token, AccessToken = logged in */\n  private _accessToken: OAuthAccessToken | null | undefined = undefined;\n  private readonly api: ApiClient;\n\n  constructor(readonly _config: ClientConfig) {\n    this.api = new ApiClient(\n      {\n        baseUrl: _config.baseUrl || PUBLIC_API_BASE_URL,\n        xApiVersion: API_VERSION,\n      },\n      this.fetchAccessToken.bind(this)\n    );\n  }\n\n  async init(): Promise<AuthState> {\n    await this.fetchAccessToken(true);\n    return this.getAuthState();\n  }\n\n  async fetchAccessToken(refresh: boolean): Promise<OAuthAccessToken | null> {\n    if (!refresh && this._accessToken !== undefined) return this._accessToken;\n\n    try {\n      const accessToken = await this._config.getAccessToken();\n      this._accessToken = accessToken;\n      return accessToken;\n    } catch (_) {\n      this._accessToken = null;\n      return null;\n    }\n  }\n\n  getAuthState(): AuthState {\n    if (this._accessToken === undefined) {\n      return 'unknown';\n    }\n    return this._accessToken !== null ? 'logged-in' : 'logged-out';\n  }\n\n  async startOAuth(): Promise<void> {\n    const state = generateSecureRandomBase64Url(32);\n    const codeVerifier = generateSecureRandomBase64Url(32);\n\n    const codeChallengeRaw = await sha256(codeVerifier);\n    const codeChallenge = arrayBufferToBase64Url(codeChallengeRaw, false);\n\n    sessionStorage.setItem(OAUTH_STATE_KEY, state);\n    sessionStorage.setItem(OAUTH_CODE_VERIFIER_KEY, codeVerifier);\n\n    const params = new URLSearchParams({\n      client_id: this._config.clientId,\n      response_type: 'code',\n      redirect_uri: this._config.redirectUri,\n      code_challenge: codeChallenge,\n      code_challenge_method: 'S256',\n      state,\n    });\n    const oauthPageUrl =\n      this._config.authorizationPageUrl ?? COINLIST_OAUTH_PAGE_URL;\n    const url = `${oauthPageUrl}?${params.toString()}`;\n    window.location.href = url;\n  }\n\n  completeOAuth(): OauthClientResult {\n    const params = new URLSearchParams(window.location.search);\n\n    const coinlistError = params.get('error');\n    if (coinlistError) {\n      return { type: 'error', reason: 'user_canceled' };\n    }\n\n    const stateParam = params.get('state');\n    if (!stateParam) {\n      return { type: 'error', reason: 'missing_state' };\n    }\n    const storedState = sessionStorage.getItem(OAUTH_STATE_KEY);\n    if (storedState === null || storedState !== stateParam) {\n      return { type: 'error', reason: 'invalid_state' };\n    }\n\n    const codeParam = params.get('code');\n    if (!codeParam) {\n      return { type: 'error', reason: 'missing_code' };\n    }\n\n    const codeVerifierValue = sessionStorage.getItem(OAUTH_CODE_VERIFIER_KEY);\n    if (!codeVerifierValue) {\n      return { type: 'error', reason: 'missing_code_verifier' };\n    }\n\n    return {\n      type: 'ok',\n      code: AuthorizationCode(codeParam),\n      codeVerifier: CodeVerifier(codeVerifierValue),\n    };\n  }\n\n  logout(): void {\n    this._accessToken = null;\n  }\n\n  async fetchAllOffers(): Promise<Offer[]> {\n    this.ensureAuthenticated();\n    return await fetchAllPages(this.fetchOffersPage.bind(this));\n  }\n\n  async fetchOffersPage(\n    params: PaginationParams\n  ): Promise<PaginatedResponse<Offer>> {\n    this.ensureAuthenticated();\n    const pageDto = await this.api.send<PaginatedResponseDto<OfferDto>>({\n      method: 'GET',\n      url: '/v1/offers',\n      queryParams: PaginationParams.toQueryParams(params),\n      attributes: Attributes.protected(),\n    });\n    return PaginatedResponse.fromDto(pageDto, Offer.fromDto);\n  }\n\n  async fetchOfferDetails(id: OfferId): Promise<OfferDetail> {\n    this.ensureAuthenticated();\n    const offerDetailDto = await this.api.send<OfferDetailDto>({\n      method: 'GET',\n      url: `/v1/offers/${id}`,\n      attributes: Attributes.protected(),\n    });\n    return OfferDetail.fromDto(offerDetailDto);\n  }\n\n  private ensureAuthenticated() {\n    if (this.getAuthState() !== 'logged-in') {\n      throw new NotAuthenticatedError();\n    }\n  }\n}\n\nexport function createCoinListClient(config: ClientConfig): CoinListClient {\n  return new CoinListClientImpl(config);\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-DLEKT4T4.js.map

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

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

@@ -1,272 +0,0 @@
-import { A as AuthorizationCode, c as CodeVerifier, f as Config, O as OAuthAccessToken } from './oauth-session-DnKDI5ou.js';
-import { N as Newtype } from './newtype-yKTvFdg_.js';
-import { a as OfferId, b as OfferSlug, O as Offer } from './offer-DnFEFJw9.js';
-
-type AuthState = 'unknown' | 'logged-in' | 'logged-out';
-/** Discriminated error reasons from {@link CoinListClient.completeOAuth}. */
-type OauthClientErrorReason = 'user_canceled' | 'missing_state' | 'invalid_state' | 'missing_code' | 'missing_code_verifier';
-type OauthClientResult = {
-    type: 'ok';
-    code: AuthorizationCode;
-    codeVerifier: CodeVerifier;
-} | {
-    type: 'error';
-    reason: OauthClientErrorReason;
-};
-
-type QueryParamValue = string | number | boolean | null | undefined;
-
-type Cursor = Newtype<string, 'Cursor'>;
-declare const Cursor: (value: string) => Cursor;
-interface PaginatedResponseDto<T> {
-    data: T[];
-    starting_after?: string;
-    starting_before?: string;
-}
-declare function fetchAllPages<A>(fetchPage: (params: PaginationParams) => Promise<PaginatedResponse<A>>): Promise<A[]>;
-interface PaginatedResponse<T> {
-    data: T[];
-    startingAfter: Cursor | null;
-    startingBefore: Cursor | null;
-}
-declare const PaginatedResponse: {
-    fromDto: <A, B>(dto: PaginatedResponseDto<A>, itemMapper: (item: A) => B) => PaginatedResponse<B>;
-};
-/**
- * Cursor-based pagination input used when requesting paginated API resources.
- * Set `after` or `before` to navigate relative to a known cursor, and `limit`
- * to control the maximum number of returned items.
- */
-interface PaginationParams {
-    before?: Cursor;
-    after?: Cursor;
-    limit?: number;
-}
-declare const PaginationParams: {
-    toQueryParams: (params: PaginationParams) => Record<string, QueryParamValue>;
-};
-
-type AssetDto = {
-    code: string;
-    fractional_digits: number;
-    id: string;
-    name: string;
-};
-
-type AssetId = Newtype<string, 'AssetId'>;
-declare const AssetId: (value: string) => AssetId;
-type AssetCode = Newtype<string, 'AssetCode'>;
-declare const AssetCode: (value: string) => AssetCode;
-type Asset = {
-    id: AssetId;
-    code: AssetCode;
-    name: string;
-    fractionalDigits: number;
-};
-declare const Asset: {
-    fromDto: (dto: AssetDto) => Asset;
-};
-
-type OfferDetailDto = {
-    asset: AssetDto;
-    faqs: OfferDetailFaqDto[];
-    funding_assets: AssetDto[];
-    id: string;
-    links: OfferDetailLinkDto[];
-    milestones: OfferDetailMilestoneDto[];
-    name: string;
-    object: 'offer_details';
-    options: OfferDetailOptionDto[];
-    slug: string;
-    terms: OfferDetailTermDto[];
-    about: string | null | undefined;
-    banner_url: string | null | undefined;
-    category: string | null | undefined;
-    ends_at: string;
-    logo_url: string | null | undefined;
-    starts_at: string;
-    tagline: string | null | undefined;
-};
-type OfferDetailFaqDto = {
-    answer: string | null;
-    question: string | null;
-};
-type OfferDetailLinkDto = {
-    label: string | null;
-    url: string | null;
-};
-type OfferDetailMilestoneDto = {
-    name: string | null;
-    schedule: string | null;
-    status: 'completed' | 'active' | 'upcoming';
-};
-type OfferDetailOptionDto = {
-    bid_increment: number | null;
-    floor_price_usd: number | null;
-    id: string;
-    minimum_purchase_usd: number | null;
-    price_usd: number | null;
-    sale_agreement_url: string | null;
-    slug: string;
-    total_token_supply: number | null;
-};
-type OfferDetailTermDto = {
-    key: string | null;
-    value: string | null;
-};
-
-type OfferOptionId = Newtype<string, 'OfferOptionId'>;
-declare const OfferOptionId: (value: string) => OfferOptionId;
-type OfferOptionSlug = Newtype<string, 'OfferOptionSlug'>;
-declare const OfferOptionSlug: (value: string) => OfferOptionSlug;
-type OfferDetail = {
-    id: OfferId;
-    slug: OfferSlug;
-    name: string;
-    asset: Asset;
-    fundingAssets: Asset[];
-    about: string | null;
-    tagline: string | null;
-    bannerUrl: string | null;
-    logoUrl: string | null;
-    category: string | null;
-    startsAt: Date;
-    endsAt: Date;
-    faqs: FaqItem[];
-    links: Link[];
-    milestones: Milestone[];
-    options: OfferOption[];
-    terms: TermItem[];
-};
-declare const OfferDetail: {
-    fromDto: (dto: OfferDetailDto) => OfferDetail;
-};
-type OfferOption = {
-    id: OfferOptionId;
-    slug: OfferOptionSlug;
-    bidIncrement: number | null;
-    floorPriceUsd: number | null;
-    minimumPurchaseUsd: number | null;
-    priceUsd: number | null;
-    saleAgreementUrl: string | null;
-    totalTokenSupply: number | null;
-};
-declare const OfferOption: {
-    fromDto: (dto: OfferDetailOptionDto) => OfferOption;
-};
-type FaqItem = {
-    question: string | null;
-    answer: string | null;
-};
-declare const FaqItem: {
-    fromDto: (dto: OfferDetailFaqDto) => FaqItem;
-};
-type Link = {
-    label: string | null;
-    url: string | null;
-};
-declare const Link: {
-    fromDto: (dto: OfferDetailLinkDto) => Link;
-};
-type TermItem = {
-    key: string | null;
-    value: string | null;
-};
-declare const TermItem: {
-    fromDto: (dto: OfferDetailTermDto) => TermItem;
-};
-type Milestone = {
-    name: string | null;
-    schedule: string | null;
-    status: 'completed' | 'active' | 'upcoming';
-};
-declare const Milestone: {
-    fromDto: (dto: OfferDetailMilestoneDto) => Milestone;
-};
-
-interface ClientConfig extends Config {
-    /**
-     * The SDK user must provide this function. It is responsible for fetching a
-     * valid {@link OAuthAccessToken}, or **null** for logged-out users. If your
-     * backend is in TypeScript, it is recommended to use
-     * {@link CoinListServer#accessToken} from `@/server/coinlist.server`.
-     */
-    getAccessToken: () => Promise<OAuthAccessToken | null>;
-    /**
-     * Recommended to leave undefined. Used to change the CoinList environment;
-     * default is production.
-     */
-    authorizationPageUrl?: string;
-}
-interface CoinListClient {
-    /**
-     * Calls the provided {@link ClientConfig.getAccessToken} lambda to determine
-     * the user's {@link AuthState}. This is called automatically by {@link CoinListProvider};
-     * you typically do not need to call it yourself unless you are using the client
-     * outside of the provider.
-     */
-    init(): Promise<AuthState>;
-    /**
-     * Returns the current auth state: `'logged-in'`, `'logged-out'`, or `'unknown'`.
-     * Returns **unknown** until {@link CoinListClient.init} has completed. It is
-     * recommended to use the `const { isReady, coinlist } = useCoinList()` hook to know when
-     * the SDK has initialized, or to manually await {@link CoinListClient.init}
-     * before relying on this value.
-     */
-    getAuthState(): AuthState;
-    /**
-     * Starts the OAuth flow with PKCE. Generates a random `state` and `code_verifier`,
-     * stores them in sessionStorage (for validation in {@link CoinListClient.completeOAuth}
-     * on redirect), then redirects the user to the CoinList authorization page. After
-     * the user authorizes, they are sent back to your application's redirect URI; call
-     * {@link CoinListClient.completeOAuth} on that page to finish the flow.
-     */
-    startOAuth(): Promise<void>;
-    /**
-     * Completes the OAuth flow on the FE with PKCE and state validation. Parses the
-     * redirect URL (state, code) and validates them against sessionStorage
-     * (state, code_verifier). The state check protects against CSRF (cross-site
-     * request forgery). Call this on the frontend page the user is redirected
-     * to after authorizing.
-     *
-     * On `ok`: Call your backend to exchange the short-lived `authorizationCode`
-     * (and the returned `codeVerifier`) for a long-lived session. If your backend
-     * is in TypeScript, you can use {@link CoinListServer#completeOAuth} from
-     * `@/server/coinlist.server` (CoinListServer) to perform that exchange.
-     *
-     * On `error`: `reason` is an {@link OauthClientErrorReason} (e.g. `'missing_state'`, `'invalid_state'`) so you can switch on it and surface a message to the user.
-     */
-    completeOAuth(): OauthClientResult;
-    /**
-     * Clears the in-memory access token. Note: you need to manually
-     * also logout on the backend via CoinListServer#logout to clear the session cookie.
-     */
-    logout(): void;
-    /**
-     * Fetches all offers by iterating through every paginated response.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchAllOffers(): Promise<Offer[]>;
-    /**
-     * Fetches a single page of offers.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOffersPage(params: PaginationParams): Promise<PaginatedResponse<Offer>>;
-    /**
-     * Fetches details for a given offer by its id.
-     *
-     * This method must be called only when the user's {@link AuthState} is
-     * `'logged-in'`. If the user is not authenticated, it throws
-     * {@link NotAuthenticatedError}.
-     */
-    fetchOfferDetails(id: OfferId): Promise<OfferDetail>;
-}
-declare function createCoinListClient(config: ClientConfig): CoinListClient;
-
-export { type AuthState as A, type ClientConfig as C, FaqItem as F, Link as L, Milestone as M, type OauthClientErrorReason as O, PaginatedResponse as P, TermItem as T, type CoinListClient as a, Cursor as b, type OauthClientResult as c, OfferDetail as d, OfferOption as e, OfferOptionId as f, OfferOptionSlug as g, type PaginatedResponseDto as h, PaginationParams as i, createCoinListClient as j, fetchAllPages as k };