@carddex/sdk 0.3.0 → 0.5.0

package/README.md

@@ -36,19 +36,54 @@ An API key is optional. Omit it to call the API anonymously. The SDK sends the k
 
 You can also sign in with an email link at [carddex.dev/account](https://carddex.dev/account) to see your keys, create up to 2 active keys, and rotate or revoke them.
 
-### Card names in German, French, Italian, Spanish and Portuguese
+### Card names and scans in German, French, Italian, Spanish and Portuguese
 
-The catalogue is the English one, and `name` is always the English name. Pass `lang` (`de`, `fr`, `it`, `es` or `pt`) and every card and set also carries `localized_name`: its name in that language edition, or `null` where none is known. With `lang`, `name` and `q` also match names in that language. `include: ['translations']` lists every localized name a card has.
+The catalogue is the English one, and `name` is always the English name. Pass `lang` (`de`, `fr`, `it`, `es` or `pt`) and every card and set also carries `localized_name`: its name in that language edition, or `null` where none is known. Cards also carry `localized_image`: the scan in that edition (`thumb_url`, `small_url`, `large_url`), or `null` where there is none, in which case show the English image. `image_url` and `images` stay the English scan whatever `lang` is. With `lang`, `name` and `q` also match names in that language. `include: ['translations']` lists every localized name a card has. Cards also carry `base_finish` (`holo`, `reverse` or `normal`) where the card's own print has a known finish that the rarity does not say (for example the HGSS Black Star Promos, catalogued as Common): it is present only when known, otherwise omitted.
 
 ```ts
 const { data } = await client.cards.list({ name: 'Glurak', lang: 'de' });
 // data[0].name === 'Charizard', data[0].localized_name === 'Glurak'
+const image = data[0].localized_image?.small_url ?? data[0].image_url;
 
 const sets = await client.sets.list({ lang: 'fr' });
 const card = await client.cards.get('base1-4', { include: ['translations'] });
 ```
 
-Polish card names are not available from any source, so `lang: 'pl'` is rejected (the API answers 400). Japanese cards are not in the catalogue yet.
+Polish card names are not available from any source, so `lang: 'pl'` is rejected (the API answers 400).
+
+### Japanese catalogue
+
+Pass `catalog: 'ja'` (default `'en'`) to read the Japanese catalogue: its own sets, numbering and printed names. It works on `cards.list`, `cards.random`, `cards.rarities`, `sets.list`, `sets.cards`, `prices.bulk` and the `prices.top` / `trends` / `bargains` rankings. Reads keyed by an id (`cards.get`, `sets.get`, prices, history) work out the catalogue from the `ja-` prefix, so they need no `catalog`.
+
+Cards and sets of the Japanese catalogue carry `catalog: "ja"` (English ones carry no `catalog`). A Japanese card's `name` is its printed Japanese name and `name_en` its English name, or null where unknown; a set's `set_code` is the code printed on its cards (`sv2a`). Prices come back as `source: "cardmarket"` (EUR). `lang` translates the English catalogue only: on Japanese cards `localized_name` and `localized_image` are null. Further catalogues (Traditional and Simplified Chinese, Korean, Thai) are not available yet; the API answers 400 for them.
+
+```ts
+const { data } = await client.cards.list({ catalog: 'ja', q: 'charizard', pageSize: 3 });
+const card = await client.cards.get('ja-SV2a-006');
+const [price] = await client.cards.prices('ja-SV2a-006');
+console.log(card.name, card.name_en, price?.trend_price, price?.currency);
+// リザードンex Charizard ex 2.82 EUR
+
+const sets = await client.sets.list({ catalog: 'ja' }); // set_code === 'sv2a' for ja-SV2a
+const top = await client.prices.top({ catalog: 'ja', limit: 5 }); // row.card_name, row.card_name_en
+```
+
+### Polish catalogue
+
+Pass `catalog: 'pl'` (default `'en'`) to read the Polish catalogue: the historical Polish releases of Diamond & Pearl and Mysterious Treasures, and the World Collection 2010 Pikachu promo (`pl-dp1`, `pl-dp2`, `pl-promo`). Reads keyed by an id (`cards.get`, `sets.get`, prices, history) work out the catalogue from the `pl-` prefix, so they need no `catalog`.
+
+Cards and sets of the Polish catalogue carry `catalog: "pl"`. `name` is the printed Polish name and `name_en` its English name. Cards also carry `english_id`: the English twin card's id (`pl-dp1-1` gives `dp1-1`), or null for cards with no English counterpart (`pl-promo-1`). `set_code` is null for Polish sets.
+
+```ts
+const { data } = await client.cards.list({ catalog: 'pl', q: 'Dusknoir' });
+const card = await client.cards.get('pl-dp1-2');
+console.log(card.name, card.name_en, card.english_id);
+// Dusknoir Dusknoir dp1-2
+
+const sets = await client.sets.list({ catalog: 'pl' });
+// [{ id: 'pl-dp2', name: 'Tajemne Skarby' }, { id: 'pl-dp1', name: 'Diament i Perła' }, { id: 'pl-promo', name: 'Promo' }]
+```
+
 
 ### Get a free API key
 
@@ -141,7 +176,7 @@ This SDK talks to the native `/v1` API, which uses CardDex ids (`sv02-062`) but
 
 | Resource | Methods |
 | --- | --- |
-| `client.cards` | `list`, `listAll`, `get`, `random`, `prices`, `priceHistory` |
+| `client.cards` | `list`, `listAll`, `get`, `random`, `rarities`, `prices`, `priceHistory` |
 | `client.sets` | `list`, `get`, `cards`, `cardsAll`, `neighbors`, `sealed` |
 | `client.sealed` | `list`, `listAll`, `get`, `prices` |
 | `client.prices` | `bulk`, `top`, `trends`, `bargains`, `history` |

package/dist/index.cjs

@@ -241,9 +241,14 @@ var CardsResource = class {
   listAll(params) {
     return paginate((page) => this.list({ ...params, page }));
   }
-  /** `GET /v1/cards/random` */
-  async random() {
-    const res = await this.http.get("/v1/cards/random");
+  /** `GET /v1/cards/random` — `catalog: 'ja'` or `catalog: 'pl'` draws a card from that catalogue. */
+  async random(params) {
+    const res = await this.http.get("/v1/cards/random", params);
+    return res.data;
+  }
+  /** `GET /v1/cards/rarities` — every distinct rarity of one catalogue. */
+  async rarities(params) {
+    const res = await this.http.get("/v1/cards/rarities", params);
     return res.data;
   }
   /** `GET /v1/cards/{id}` */
@@ -356,7 +361,7 @@ var SetsResource = class {
     this.http = http;
   }
   http;
-  /** `GET /v1/sets` — every set. `lang` adds `localized_name`. */
+  /** `GET /v1/sets` — every set of one catalogue (`catalog`, default `en`). `lang` adds `localized_name`. */
   async list(params) {
     const res = await this.http.get("/v1/sets", params);
     return res.data;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/resources/auth.ts","../src/pagination.ts","../src/resources/cards.ts","../src/resources/prices.ts","../src/resources/sealed.ts","../src/resources/sets.ts","../src/client.ts"],"sourcesContent":["export type { CardDexOptions } from './client.js';\nexport { CardDex } from './client.js';\nexport type { RateLimitInfo } from './errors.js';\nexport { CardDexError } from './errors.js';\nexport type { RetryOptions } from './http.js';\nexport { paginate } from './pagination.js';\nexport * from './params.js';\nexport * from './types.js';\n","/** Rate-limit info parsed from response headers, when present. */\nexport interface RateLimitInfo {\n  /** `X-RateLimit-Limit`: requests allowed per minute. */\n  limit: number | null;\n  /** `X-RateLimit-Daily-Limit`: requests allowed per UTC day, or `null` when the tier is uncapped. */\n  dailyLimit: number | null;\n  /** `X-RateLimit-Daily-Remaining`: approximate, can lag by about a minute. `null` when the API couldn't compute it. */\n  dailyRemaining: number | null;\n}\n\nfunction parseRateLimitHeaders(headers: Headers): RateLimitInfo {\n  const num = (name: string): number | null => {\n    const raw = headers.get(name);\n    if (raw == null) return null;\n    const n = Number(raw);\n    return Number.isFinite(n) ? n : null;\n  };\n  return {\n    limit: num('X-RateLimit-Limit'),\n    dailyLimit: num('X-RateLimit-Daily-Limit'),\n    dailyRemaining: num('X-RateLimit-Daily-Remaining'),\n  };\n}\n\n/**\n * Thrown for any non-2xx response, and for network/parse failures the fetch\n * layer can't attribute to the API itself.\n */\nexport class CardDexError extends Error {\n  /** HTTP status code. `0` for a request that never got a response (network failure, abort). */\n  readonly status: number;\n  /**\n   * The API's own `error.code`. For a response the API actually produced,\n   * this is the same number as `status` (see the note on `ApiErrorBody` in\n   * `types.ts`) — kept as its own field because a transport-level failure\n   * (no response at all) sets it to a string like `NETWORK_ERROR` instead.\n   */\n  readonly code: number | string;\n  /** Seconds to wait before retrying, parsed from `Retry-After` on a 429. `null` otherwise. */\n  readonly retryAfter: number | null;\n  /** Rate-limit headers on the response, when there was one. */\n  readonly rateLimit: RateLimitInfo | null;\n\n  constructor(\n    message: string,\n    options: {\n      status: number;\n      code: number | string;\n      retryAfter?: number | null;\n      rateLimit?: RateLimitInfo | null;\n      cause?: unknown;\n    },\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'CardDexError';\n    this.status = options.status;\n    this.code = options.code;\n    this.retryAfter = options.retryAfter ?? null;\n    this.rateLimit = options.rateLimit ?? null;\n    Object.setPrototypeOf(this, CardDexError.prototype);\n  }\n\n  /** Whether this is a 429 (either the per-minute or the daily cap). */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  static async fromResponse(response: Response): Promise<CardDexError> {\n    const rateLimit = parseRateLimitHeaders(response.headers);\n    const retryAfterHeader = response.headers.get('Retry-After');\n    const retryAfter = retryAfterHeader != null ? Number(retryAfterHeader) : null;\n\n    let message = `CardDex API error (${response.status})`;\n    let code: number | string = response.status;\n    try {\n      const body = (await response.clone().json()) as {\n        error?: { code?: unknown; message?: unknown };\n      };\n      if (body?.error) {\n        if (typeof body.error.message === 'string') message = body.error.message;\n        if (typeof body.error.code === 'number' || typeof body.error.code === 'string') {\n          code = body.error.code;\n        }\n      }\n    } catch {\n      // Non-JSON or empty error body — fall back to the status-derived message above.\n    }\n\n    return new CardDexError(message, {\n      status: response.status,\n      code,\n      retryAfter: Number.isFinite(retryAfter) ? retryAfter : null,\n      rateLimit,\n    });\n  }\n\n  static network(cause: unknown): CardDexError {\n    const message = cause instanceof Error ? cause.message : 'Network request failed';\n    return new CardDexError(message, { status: 0, code: 'NETWORK_ERROR', cause });\n  }\n}\n","import { CardDexError } from './errors.js';\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | undefined\n  | null\n  | readonly (string | number)[];\nexport type QueryParams = Record<string, QueryValue>;\n\nexport interface RetryOptions {\n  /** Max retry attempts on 429. Default 2. */\n  maxRetries?: number;\n  /**\n   * A computed `Retry-After` above this many seconds is never honoured — the\n   * request fails immediately instead of sleeping (this is what keeps a\n   * daily-quota 429, whose `Retry-After` can be most of a day, from blocking\n   * for hours). Default 60, matching the per-minute limiter's own\n   * `Retry-After: 60`.\n   */\n  maxWaitSeconds?: number;\n}\n\nexport interface HttpClientOptions {\n  baseUrl: string;\n  apiKey?: string;\n  fetch: typeof fetch;\n  /** `false` (default) disables retries; `true` enables them with the defaults below. */\n  retry?: boolean | RetryOptions;\n}\n\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_MAX_WAIT_SECONDS = 60;\n\nfunction buildQueryString(params?: QueryParams): string {\n  if (!params) return '';\n  const search = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) continue;\n      search.set(key, value.join(','));\n    } else {\n      search.set(key, String(value));\n    }\n  }\n  const qs = search.toString();\n  return qs ? `?${qs}` : '';\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Minimal fetch wrapper: builds URLs, attaches auth, parses JSON, and turns\n * non-2xx responses into `CardDexError`. No dependency beyond global `fetch`.\n */\nexport class HttpClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly fetchImpl: typeof fetch;\n  private readonly retryConfig: Required<RetryOptions> | null;\n\n  constructor(options: HttpClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, '');\n    this.apiKey = options.apiKey;\n    this.fetchImpl = options.fetch;\n    if (options.retry === true) {\n      this.retryConfig = {\n        maxRetries: DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else if (options.retry && typeof options.retry === 'object') {\n      this.retryConfig = {\n        maxRetries: options.retry.maxRetries ?? DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: options.retry.maxWaitSeconds ?? DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else {\n      this.retryConfig = null;\n    }\n  }\n\n  async get<T>(path: string, query?: QueryParams, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('GET', path, { query, signal });\n  }\n\n  async post<T>(path: string, body?: unknown, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('POST', path, { body, signal });\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    opts: { query?: QueryParams; body?: unknown; signal?: AbortSignal },\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}${buildQueryString(opts.query)}`;\n    const headers: Record<string, string> = { Accept: 'application/json' };\n    if (this.apiKey) headers['X-API-Key'] = this.apiKey;\n    if (opts.body !== undefined) headers['Content-Type'] = 'application/json';\n\n    let attempt = 0;\n    for (;;) {\n      let response: Response;\n      try {\n        response = await this.fetchImpl(url, {\n          method,\n          headers,\n          body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,\n          signal: opts.signal,\n        });\n      } catch (cause) {\n        throw CardDexError.network(cause);\n      }\n\n      if (response.status === 429 && this.retryConfig && attempt < this.retryConfig.maxRetries) {\n        const retryAfterHeader = response.headers.get('Retry-After');\n        const retryAfterSeconds = retryAfterHeader != null ? Number(retryAfterHeader) : Number.NaN;\n        if (\n          Number.isFinite(retryAfterSeconds) &&\n          retryAfterSeconds <= this.retryConfig.maxWaitSeconds\n        ) {\n          attempt++;\n          await sleep(retryAfterSeconds * 1000);\n          continue;\n        }\n        // Retry-After is missing or longer than we're willing to wait\n        // (typically the daily cap, which resets at UTC midnight) — surface\n        // the error instead of blocking.\n      }\n\n      if (!response.ok) {\n        throw await CardDexError.fromResponse(response);\n      }\n\n      if (response.status === 204) return undefined as T;\n      return (await response.json()) as T;\n    }\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type { RegisterResponse, SingleResponse, UsageResponse } from '../types.js';\n\nexport class AuthResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `POST /v1/auth/register` — claim a free API key. The key is returned\n   * exactly once, so store it immediately. A lost key can be replaced by signing\n   * in at https://carddex.dev/account (create, rotate or revoke keys there).\n   */\n  async register(email: string, name?: string): Promise<RegisterResponse> {\n    const res = await this.http.post<SingleResponse<RegisterResponse>>('/v1/auth/register', {\n      email,\n      name,\n    });\n    return res.data;\n  }\n\n  /** `GET /v1/auth/usage` — usage stats for the API key this client was constructed with. Requires an `apiKey`. */\n  async usage(): Promise<UsageResponse> {\n    const res = await this.http.get<SingleResponse<UsageResponse>>('/v1/auth/usage');\n    return res.data;\n  }\n}\n","import type { PaginatedResponse } from './types.js';\n\n/**\n * Turns a page-fetching function into an async iterator over every item,\n * fetching the next page lazily as the caller consumes items.\n *\n * @example\n * ```ts\n * for await (const card of paginate((page) => client.cards.list({ set: 'sv06', page }))) {\n *   console.log(card.name);\n * }\n * ```\n */\nexport async function* paginate<T>(\n  fetchPage: (page: number) => Promise<PaginatedResponse<T>>,\n  startPage = 1,\n): AsyncGenerator<T, void, void> {\n  let page = startPage;\n  for (;;) {\n    const response = await fetchPage(page);\n    if (response.data.length === 0) return;\n    yield* response.data;\n    if (page >= response.meta.totalPages) return;\n    page++;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type {\n  CardGetParams,\n  CardListParams,\n  CardPriceHistoryParams,\n  CardPricesParams,\n} from '../params.js';\nimport type {\n  Card,\n  CardPrice,\n  CardWithRelations,\n  PaginatedResponse,\n  SingleResponse,\n} from '../types.js';\n\nexport class CardsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/cards` — list, search, filter and sort cards. */\n  list(params?: CardListParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>('/v1/cards', params);\n  }\n\n  /**\n   * Iterates every card matching `params` across all pages, fetching pages\n   * lazily as you consume them.\n   *\n   * @example\n   * ```ts\n   * for await (const card of client.cards.listAll({ set: 'sv06' })) { ... }\n   * ```\n   */\n  listAll(params?: Omit<CardListParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/cards/random` */\n  async random(): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>('/v1/cards/random');\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}` */\n  async get(id: string, params?: CardGetParams): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>(\n      `/v1/cards/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices` — the latest price row(s) for a card. */\n  async prices(id: string, params?: CardPricesParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices/history` — one row per day per price guide, oldest first. */\n  async priceHistory(id: string, params?: CardPriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type {\n  BargainsParams,\n  BulkPricesParams,\n  PriceHistoryParams,\n  RankingParams,\n  TrendsParams,\n} from '../params.js';\nimport type { BargainCardPrice, CardPrice, SingleResponse } from '../types.js';\n\nexport class PricesResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `GET /v1/prices` — latest price rows for up to 100 card ids (and/or up\n   * to 100 print/variant ids) in one request. Keyed by the id you asked for;\n   * an id with no price data maps to `[]`.\n   */\n  async bulk(params: BulkPricesParams): Promise<Record<string, CardPrice[]>> {\n    const res = await this.http.get<SingleResponse<Record<string, CardPrice[]>>>(\n      '/v1/prices',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/top` — highest-valued cards. */\n  async top(params?: RankingParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/top', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/trends` — biggest movers against the card's own rolling average. */\n  async trends(params?: TrendsParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/trends', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/bargains` — cards trading below a reference price, best discount first. */\n  async bargains(params?: BargainsParams): Promise<BargainCardPrice[]> {\n    const res = await this.http.get<SingleResponse<BargainCardPrice[]>>(\n      '/v1/prices/bargains',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/{cardId}/history` — one row per day per guide, oldest first. */\n  async history(cardId: string, params?: PriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/prices/${encodeURIComponent(cardId)}/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedListParams, SealedPriceHistoryParams } from '../params.js';\nimport type { PaginatedResponse, SealedPrice, SealedProduct, SingleResponse } from '../types.js';\n\nexport class SealedResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sealed` — list sealed products with their latest price. */\n  list(params?: SealedListParams): Promise<PaginatedResponse<SealedProduct>> {\n    return this.http.get<PaginatedResponse<SealedProduct>>('/v1/sealed', params);\n  }\n\n  /** Iterates every sealed product matching `params` across all pages. */\n  listAll(params?: Omit<SealedListParams, 'page'>): AsyncGenerator<SealedProduct, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/sealed/{id}` */\n  async get(id: string, params?: { source?: SealedListParams['source'] }): Promise<SealedProduct> {\n    const res = await this.http.get<SingleResponse<SealedProduct>>(\n      `/v1/sealed/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sealed/{id}/prices` — one row per synced day, oldest first. */\n  async prices(id: string, params?: SealedPriceHistoryParams): Promise<SealedPrice[]> {\n    const res = await this.http.get<SingleResponse<SealedPrice[]>>(\n      `/v1/sealed/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedPriceSource, SetCardsParams, SetGetParams } from '../params.js';\nimport type {\n  Card,\n  CardDexSet,\n  CardNeighbors,\n  PaginatedResponse,\n  SealedProduct,\n  SingleResponse,\n} from '../types.js';\n\nexport class SetsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sets` — every set. `lang` adds `localized_name`. */\n  async list(params?: SetGetParams): Promise<CardDexSet[]> {\n    const res = await this.http.get<SingleResponse<CardDexSet[]>>('/v1/sets', params);\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}` — `lang` adds `localized_name`. */\n  async get(id: string, params?: SetGetParams): Promise<CardDexSet> {\n    const res = await this.http.get<SingleResponse<CardDexSet>>(\n      `/v1/sets/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/cards` */\n  cards(id: string, params?: SetCardsParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>(\n      `/v1/sets/${encodeURIComponent(id)}/cards`,\n      params,\n    );\n  }\n\n  /** Iterates every card in a set across all pages. */\n  cardsAll(id: string, params?: Omit<SetCardsParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.cards(id, { ...params, page }));\n  }\n\n  /** `GET /v1/sets/{id}/cards/{cardId}/neighbors` — the 2 previous / 2 next card ids. */\n  async neighbors(setId: string, cardId: string): Promise<CardNeighbors> {\n    const res = await this.http.get<SingleResponse<CardNeighbors>>(\n      `/v1/sets/${encodeURIComponent(setId)}/cards/${encodeURIComponent(cardId)}/neighbors`,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/sealed` — sealed products attached to a set, each with its latest price. */\n  async sealed(id: string, params?: { source?: SealedPriceSource }): Promise<SealedProduct[]> {\n    const res = await this.http.get<SingleResponse<SealedProduct[]>>(\n      `/v1/sets/${encodeURIComponent(id)}/sealed`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { RetryOptions } from './http.js';\nimport { HttpClient } from './http.js';\nimport { AuthResource } from './resources/auth.js';\nimport { CardsResource } from './resources/cards.js';\nimport { PricesResource } from './resources/prices.js';\nimport { SealedResource } from './resources/sealed.js';\nimport { SetsResource } from './resources/sets.js';\nimport type { HealthResponse, UsageResponse } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.carddex.dev';\n\nexport interface CardDexOptions {\n  /**\n   * A `pk_live_...` key from `POST /v1/auth/register`. Omit it to call the\n   * API anonymously — CardDex allows this at a lower rate (30 req/min,\n   * 5,000 req/day per IP), specifically so a browser can call it without a\n   * key. **Never ship a real API key in public frontend code**: it would be\n   * readable by anyone who opens dev tools and shared by every visitor to\n   * your site. Proxy through your own backend instead if you need the\n   * higher, keyed limits from a browser context.\n   */\n  apiKey?: string;\n  /** Defaults to `https://api.carddex.dev`. Override for a local/staging API or a CORS proxy. */\n  baseUrl?: string;\n  /** Defaults to the global `fetch`. Override to inject a custom implementation (proxies, logging, tests). */\n  fetch?: typeof fetch;\n  /**\n   * Automatic retry on `429`, honouring `Retry-After`. **Off by default.**\n   * Pass `true` for the defaults (up to 2 retries, never waiting more than\n   * 60s), or an object to tune them. A `Retry-After` longer than\n   * `maxWaitSeconds` — typically the daily-quota reset, which can be most of\n   * a day away — is never honoured; the request fails immediately instead.\n   */\n  retry?: boolean | RetryOptions;\n}\n\nfunction isBrowserLike(): boolean {\n  return (\n    typeof window !== 'undefined' &&\n    typeof (window as { document?: unknown }).document !== 'undefined'\n  );\n}\n\n/**\n * CardDex API client.\n *\n * ```ts\n * import { CardDex } from '@carddex/sdk';\n *\n * const client = new CardDex({ apiKey: process.env.CARDDEX_API_KEY });\n * const { data } = await client.cards.list({ name: 'Charizard' });\n * ```\n */\nexport class CardDex {\n  readonly cards: CardsResource;\n  readonly sets: SetsResource;\n  readonly sealed: SealedResource;\n  readonly prices: PricesResource;\n  readonly auth: AuthResource;\n\n  private readonly http: HttpClient;\n\n  constructor(options: CardDexOptions = {}) {\n    if (options.apiKey && isBrowserLike()) {\n      // biome-ignore lint/suspicious/noConsole: deliberate one-time safety warning, not app logging\n      console.warn(\n        '[@carddex/sdk] An apiKey was passed in what looks like a browser environment. ' +\n          'API keys shipped in frontend code are visible to every visitor. Omit apiKey for ' +\n          \"CardDex's anonymous browser mode, or proxy authenticated requests through your own backend.\",\n      );\n    }\n\n    const fetchImpl = options.fetch ?? globalThis.fetch;\n    if (!fetchImpl) {\n      throw new Error(\n        '@carddex/sdk requires a global fetch implementation. On Node < 18, pass one via `fetch` in the options.',\n      );\n    }\n\n    this.http = new HttpClient({\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: options.apiKey,\n      fetch: fetchImpl.bind(globalThis),\n      retry: options.retry,\n    });\n\n    this.cards = new CardsResource(this.http);\n    this.sets = new SetsResource(this.http);\n    this.sealed = new SealedResource(this.http);\n    this.prices = new PricesResource(this.http);\n    this.auth = new AuthResource(this.http);\n  }\n\n  /** `GET /v1/auth/usage` — shorthand for `client.auth.usage()`. Requires an `apiKey`. */\n  usage(): Promise<UsageResponse> {\n    return this.auth.usage();\n  }\n\n  /** `GET /v1/health` — API health, price freshness, and cron status. */\n  async health(): Promise<HealthResponse> {\n    return this.http.get<HealthResponse>('/v1/health');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/errors.ts","../src/http.ts","../src/resources/auth.ts","../src/pagination.ts","../src/resources/cards.ts","../src/resources/prices.ts","../src/resources/sealed.ts","../src/resources/sets.ts","../src/client.ts"],"sourcesContent":["export type { CardDexOptions } from './client.js';\nexport { CardDex } from './client.js';\nexport type { RateLimitInfo } from './errors.js';\nexport { CardDexError } from './errors.js';\nexport type { RetryOptions } from './http.js';\nexport { paginate } from './pagination.js';\nexport * from './params.js';\nexport * from './types.js';\n","/** Rate-limit info parsed from response headers, when present. */\nexport interface RateLimitInfo {\n  /** `X-RateLimit-Limit`: requests allowed per minute. */\n  limit: number | null;\n  /** `X-RateLimit-Daily-Limit`: requests allowed per UTC day, or `null` when the tier is uncapped. */\n  dailyLimit: number | null;\n  /** `X-RateLimit-Daily-Remaining`: approximate, can lag by about a minute. `null` when the API couldn't compute it. */\n  dailyRemaining: number | null;\n}\n\nfunction parseRateLimitHeaders(headers: Headers): RateLimitInfo {\n  const num = (name: string): number | null => {\n    const raw = headers.get(name);\n    if (raw == null) return null;\n    const n = Number(raw);\n    return Number.isFinite(n) ? n : null;\n  };\n  return {\n    limit: num('X-RateLimit-Limit'),\n    dailyLimit: num('X-RateLimit-Daily-Limit'),\n    dailyRemaining: num('X-RateLimit-Daily-Remaining'),\n  };\n}\n\n/**\n * Thrown for any non-2xx response, and for network/parse failures the fetch\n * layer can't attribute to the API itself.\n */\nexport class CardDexError extends Error {\n  /** HTTP status code. `0` for a request that never got a response (network failure, abort). */\n  readonly status: number;\n  /**\n   * The API's own `error.code`. For a response the API actually produced,\n   * this is the same number as `status` (see the note on `ApiErrorBody` in\n   * `types.ts`) — kept as its own field because a transport-level failure\n   * (no response at all) sets it to a string like `NETWORK_ERROR` instead.\n   */\n  readonly code: number | string;\n  /** Seconds to wait before retrying, parsed from `Retry-After` on a 429. `null` otherwise. */\n  readonly retryAfter: number | null;\n  /** Rate-limit headers on the response, when there was one. */\n  readonly rateLimit: RateLimitInfo | null;\n\n  constructor(\n    message: string,\n    options: {\n      status: number;\n      code: number | string;\n      retryAfter?: number | null;\n      rateLimit?: RateLimitInfo | null;\n      cause?: unknown;\n    },\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'CardDexError';\n    this.status = options.status;\n    this.code = options.code;\n    this.retryAfter = options.retryAfter ?? null;\n    this.rateLimit = options.rateLimit ?? null;\n    Object.setPrototypeOf(this, CardDexError.prototype);\n  }\n\n  /** Whether this is a 429 (either the per-minute or the daily cap). */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  static async fromResponse(response: Response): Promise<CardDexError> {\n    const rateLimit = parseRateLimitHeaders(response.headers);\n    const retryAfterHeader = response.headers.get('Retry-After');\n    const retryAfter = retryAfterHeader != null ? Number(retryAfterHeader) : null;\n\n    let message = `CardDex API error (${response.status})`;\n    let code: number | string = response.status;\n    try {\n      const body = (await response.clone().json()) as {\n        error?: { code?: unknown; message?: unknown };\n      };\n      if (body?.error) {\n        if (typeof body.error.message === 'string') message = body.error.message;\n        if (typeof body.error.code === 'number' || typeof body.error.code === 'string') {\n          code = body.error.code;\n        }\n      }\n    } catch {\n      // Non-JSON or empty error body — fall back to the status-derived message above.\n    }\n\n    return new CardDexError(message, {\n      status: response.status,\n      code,\n      retryAfter: Number.isFinite(retryAfter) ? retryAfter : null,\n      rateLimit,\n    });\n  }\n\n  static network(cause: unknown): CardDexError {\n    const message = cause instanceof Error ? cause.message : 'Network request failed';\n    return new CardDexError(message, { status: 0, code: 'NETWORK_ERROR', cause });\n  }\n}\n","import { CardDexError } from './errors.js';\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | undefined\n  | null\n  | readonly (string | number)[];\nexport type QueryParams = Record<string, QueryValue>;\n\nexport interface RetryOptions {\n  /** Max retry attempts on 429. Default 2. */\n  maxRetries?: number;\n  /**\n   * A computed `Retry-After` above this many seconds is never honoured — the\n   * request fails immediately instead of sleeping (this is what keeps a\n   * daily-quota 429, whose `Retry-After` can be most of a day, from blocking\n   * for hours). Default 60, matching the per-minute limiter's own\n   * `Retry-After: 60`.\n   */\n  maxWaitSeconds?: number;\n}\n\nexport interface HttpClientOptions {\n  baseUrl: string;\n  apiKey?: string;\n  fetch: typeof fetch;\n  /** `false` (default) disables retries; `true` enables them with the defaults below. */\n  retry?: boolean | RetryOptions;\n}\n\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_MAX_WAIT_SECONDS = 60;\n\nfunction buildQueryString(params?: QueryParams): string {\n  if (!params) return '';\n  const search = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) continue;\n      search.set(key, value.join(','));\n    } else {\n      search.set(key, String(value));\n    }\n  }\n  const qs = search.toString();\n  return qs ? `?${qs}` : '';\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Minimal fetch wrapper: builds URLs, attaches auth, parses JSON, and turns\n * non-2xx responses into `CardDexError`. No dependency beyond global `fetch`.\n */\nexport class HttpClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly fetchImpl: typeof fetch;\n  private readonly retryConfig: Required<RetryOptions> | null;\n\n  constructor(options: HttpClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, '');\n    this.apiKey = options.apiKey;\n    this.fetchImpl = options.fetch;\n    if (options.retry === true) {\n      this.retryConfig = {\n        maxRetries: DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else if (options.retry && typeof options.retry === 'object') {\n      this.retryConfig = {\n        maxRetries: options.retry.maxRetries ?? DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: options.retry.maxWaitSeconds ?? DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else {\n      this.retryConfig = null;\n    }\n  }\n\n  async get<T>(path: string, query?: QueryParams, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('GET', path, { query, signal });\n  }\n\n  async post<T>(path: string, body?: unknown, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('POST', path, { body, signal });\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    opts: { query?: QueryParams; body?: unknown; signal?: AbortSignal },\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}${buildQueryString(opts.query)}`;\n    const headers: Record<string, string> = { Accept: 'application/json' };\n    if (this.apiKey) headers['X-API-Key'] = this.apiKey;\n    if (opts.body !== undefined) headers['Content-Type'] = 'application/json';\n\n    let attempt = 0;\n    for (;;) {\n      let response: Response;\n      try {\n        response = await this.fetchImpl(url, {\n          method,\n          headers,\n          body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,\n          signal: opts.signal,\n        });\n      } catch (cause) {\n        throw CardDexError.network(cause);\n      }\n\n      if (response.status === 429 && this.retryConfig && attempt < this.retryConfig.maxRetries) {\n        const retryAfterHeader = response.headers.get('Retry-After');\n        const retryAfterSeconds = retryAfterHeader != null ? Number(retryAfterHeader) : Number.NaN;\n        if (\n          Number.isFinite(retryAfterSeconds) &&\n          retryAfterSeconds <= this.retryConfig.maxWaitSeconds\n        ) {\n          attempt++;\n          await sleep(retryAfterSeconds * 1000);\n          continue;\n        }\n        // Retry-After is missing or longer than we're willing to wait\n        // (typically the daily cap, which resets at UTC midnight) — surface\n        // the error instead of blocking.\n      }\n\n      if (!response.ok) {\n        throw await CardDexError.fromResponse(response);\n      }\n\n      if (response.status === 204) return undefined as T;\n      return (await response.json()) as T;\n    }\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type { RegisterResponse, SingleResponse, UsageResponse } from '../types.js';\n\nexport class AuthResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `POST /v1/auth/register` — claim a free API key. The key is returned\n   * exactly once, so store it immediately. A lost key can be replaced by signing\n   * in at https://carddex.dev/account (create, rotate or revoke keys there).\n   */\n  async register(email: string, name?: string): Promise<RegisterResponse> {\n    const res = await this.http.post<SingleResponse<RegisterResponse>>('/v1/auth/register', {\n      email,\n      name,\n    });\n    return res.data;\n  }\n\n  /** `GET /v1/auth/usage` — usage stats for the API key this client was constructed with. Requires an `apiKey`. */\n  async usage(): Promise<UsageResponse> {\n    const res = await this.http.get<SingleResponse<UsageResponse>>('/v1/auth/usage');\n    return res.data;\n  }\n}\n","import type { PaginatedResponse } from './types.js';\n\n/**\n * Turns a page-fetching function into an async iterator over every item,\n * fetching the next page lazily as the caller consumes items.\n *\n * @example\n * ```ts\n * for await (const card of paginate((page) => client.cards.list({ set: 'sv06', page }))) {\n *   console.log(card.name);\n * }\n * ```\n */\nexport async function* paginate<T>(\n  fetchPage: (page: number) => Promise<PaginatedResponse<T>>,\n  startPage = 1,\n): AsyncGenerator<T, void, void> {\n  let page = startPage;\n  for (;;) {\n    const response = await fetchPage(page);\n    if (response.data.length === 0) return;\n    yield* response.data;\n    if (page >= response.meta.totalPages) return;\n    page++;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type {\n  CardGetParams,\n  CardListParams,\n  CardPriceHistoryParams,\n  CardPricesParams,\n  CatalogParams,\n} from '../params.js';\nimport type {\n  Card,\n  CardPrice,\n  CardWithRelations,\n  PaginatedResponse,\n  SingleResponse,\n} from '../types.js';\n\nexport class CardsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/cards` — list, search, filter and sort cards. */\n  list(params?: CardListParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>('/v1/cards', params);\n  }\n\n  /**\n   * Iterates every card matching `params` across all pages, fetching pages\n   * lazily as you consume them.\n   *\n   * @example\n   * ```ts\n   * for await (const card of client.cards.listAll({ set: 'sv06' })) { ... }\n   * ```\n   */\n  listAll(params?: Omit<CardListParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/cards/random` — `catalog: 'ja'` or `catalog: 'pl'` draws a card from that catalogue. */\n  async random(params?: CatalogParams): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>('/v1/cards/random', params);\n    return res.data;\n  }\n\n  /** `GET /v1/cards/rarities` — every distinct rarity of one catalogue. */\n  async rarities(params?: CatalogParams): Promise<string[]> {\n    const res = await this.http.get<SingleResponse<string[]>>('/v1/cards/rarities', params);\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}` */\n  async get(id: string, params?: CardGetParams): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>(\n      `/v1/cards/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices` — the latest price row(s) for a card. */\n  async prices(id: string, params?: CardPricesParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices/history` — one row per day per price guide, oldest first. */\n  async priceHistory(id: string, params?: CardPriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type {\n  BargainsParams,\n  BulkPricesParams,\n  PriceHistoryParams,\n  RankingParams,\n  TrendsParams,\n} from '../params.js';\nimport type { BargainCardPrice, CardPrice, SingleResponse } from '../types.js';\n\nexport class PricesResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `GET /v1/prices` — latest price rows for up to 100 card ids (and/or up\n   * to 100 print/variant ids) in one request. Keyed by the id you asked for;\n   * an id with no price data maps to `[]`.\n   */\n  async bulk(params: BulkPricesParams): Promise<Record<string, CardPrice[]>> {\n    const res = await this.http.get<SingleResponse<Record<string, CardPrice[]>>>(\n      '/v1/prices',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/top` — highest-valued cards. */\n  async top(params?: RankingParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/top', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/trends` — biggest movers against the card's own rolling average. */\n  async trends(params?: TrendsParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/trends', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/bargains` — cards trading below a reference price, best discount first. */\n  async bargains(params?: BargainsParams): Promise<BargainCardPrice[]> {\n    const res = await this.http.get<SingleResponse<BargainCardPrice[]>>(\n      '/v1/prices/bargains',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/{cardId}/history` — one row per day per guide, oldest first. */\n  async history(cardId: string, params?: PriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/prices/${encodeURIComponent(cardId)}/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedListParams, SealedPriceHistoryParams } from '../params.js';\nimport type { PaginatedResponse, SealedPrice, SealedProduct, SingleResponse } from '../types.js';\n\nexport class SealedResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sealed` — list sealed products with their latest price. */\n  list(params?: SealedListParams): Promise<PaginatedResponse<SealedProduct>> {\n    return this.http.get<PaginatedResponse<SealedProduct>>('/v1/sealed', params);\n  }\n\n  /** Iterates every sealed product matching `params` across all pages. */\n  listAll(params?: Omit<SealedListParams, 'page'>): AsyncGenerator<SealedProduct, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/sealed/{id}` */\n  async get(id: string, params?: { source?: SealedListParams['source'] }): Promise<SealedProduct> {\n    const res = await this.http.get<SingleResponse<SealedProduct>>(\n      `/v1/sealed/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sealed/{id}/prices` — one row per synced day, oldest first. */\n  async prices(id: string, params?: SealedPriceHistoryParams): Promise<SealedPrice[]> {\n    const res = await this.http.get<SingleResponse<SealedPrice[]>>(\n      `/v1/sealed/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedPriceSource, SetCardsParams, SetGetParams } from '../params.js';\nimport type {\n  Card,\n  CardDexSet,\n  CardNeighbors,\n  PaginatedResponse,\n  SealedProduct,\n  SingleResponse,\n} from '../types.js';\n\nexport class SetsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sets` — every set of one catalogue (`catalog`, default `en`). `lang` adds `localized_name`. */\n  async list(params?: SetGetParams): Promise<CardDexSet[]> {\n    const res = await this.http.get<SingleResponse<CardDexSet[]>>('/v1/sets', params);\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}` — `lang` adds `localized_name`. */\n  async get(id: string, params?: SetGetParams): Promise<CardDexSet> {\n    const res = await this.http.get<SingleResponse<CardDexSet>>(\n      `/v1/sets/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/cards` */\n  cards(id: string, params?: SetCardsParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>(\n      `/v1/sets/${encodeURIComponent(id)}/cards`,\n      params,\n    );\n  }\n\n  /** Iterates every card in a set across all pages. */\n  cardsAll(id: string, params?: Omit<SetCardsParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.cards(id, { ...params, page }));\n  }\n\n  /** `GET /v1/sets/{id}/cards/{cardId}/neighbors` — the 2 previous / 2 next card ids. */\n  async neighbors(setId: string, cardId: string): Promise<CardNeighbors> {\n    const res = await this.http.get<SingleResponse<CardNeighbors>>(\n      `/v1/sets/${encodeURIComponent(setId)}/cards/${encodeURIComponent(cardId)}/neighbors`,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/sealed` — sealed products attached to a set, each with its latest price. */\n  async sealed(id: string, params?: { source?: SealedPriceSource }): Promise<SealedProduct[]> {\n    const res = await this.http.get<SingleResponse<SealedProduct[]>>(\n      `/v1/sets/${encodeURIComponent(id)}/sealed`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { RetryOptions } from './http.js';\nimport { HttpClient } from './http.js';\nimport { AuthResource } from './resources/auth.js';\nimport { CardsResource } from './resources/cards.js';\nimport { PricesResource } from './resources/prices.js';\nimport { SealedResource } from './resources/sealed.js';\nimport { SetsResource } from './resources/sets.js';\nimport type { HealthResponse, UsageResponse } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.carddex.dev';\n\nexport interface CardDexOptions {\n  /**\n   * A `pk_live_...` key from `POST /v1/auth/register`. Omit it to call the\n   * API anonymously — CardDex allows this at a lower rate (30 req/min,\n   * 5,000 req/day per IP), specifically so a browser can call it without a\n   * key. **Never ship a real API key in public frontend code**: it would be\n   * readable by anyone who opens dev tools and shared by every visitor to\n   * your site. Proxy through your own backend instead if you need the\n   * higher, keyed limits from a browser context.\n   */\n  apiKey?: string;\n  /** Defaults to `https://api.carddex.dev`. Override for a local/staging API or a CORS proxy. */\n  baseUrl?: string;\n  /** Defaults to the global `fetch`. Override to inject a custom implementation (proxies, logging, tests). */\n  fetch?: typeof fetch;\n  /**\n   * Automatic retry on `429`, honouring `Retry-After`. **Off by default.**\n   * Pass `true` for the defaults (up to 2 retries, never waiting more than\n   * 60s), or an object to tune them. A `Retry-After` longer than\n   * `maxWaitSeconds` — typically the daily-quota reset, which can be most of\n   * a day away — is never honoured; the request fails immediately instead.\n   */\n  retry?: boolean | RetryOptions;\n}\n\nfunction isBrowserLike(): boolean {\n  return (\n    typeof window !== 'undefined' &&\n    typeof (window as { document?: unknown }).document !== 'undefined'\n  );\n}\n\n/**\n * CardDex API client.\n *\n * ```ts\n * import { CardDex } from '@carddex/sdk';\n *\n * const client = new CardDex({ apiKey: process.env.CARDDEX_API_KEY });\n * const { data } = await client.cards.list({ name: 'Charizard' });\n * ```\n */\nexport class CardDex {\n  readonly cards: CardsResource;\n  readonly sets: SetsResource;\n  readonly sealed: SealedResource;\n  readonly prices: PricesResource;\n  readonly auth: AuthResource;\n\n  private readonly http: HttpClient;\n\n  constructor(options: CardDexOptions = {}) {\n    if (options.apiKey && isBrowserLike()) {\n      // biome-ignore lint/suspicious/noConsole: deliberate one-time safety warning, not app logging\n      console.warn(\n        '[@carddex/sdk] An apiKey was passed in what looks like a browser environment. ' +\n          'API keys shipped in frontend code are visible to every visitor. Omit apiKey for ' +\n          \"CardDex's anonymous browser mode, or proxy authenticated requests through your own backend.\",\n      );\n    }\n\n    const fetchImpl = options.fetch ?? globalThis.fetch;\n    if (!fetchImpl) {\n      throw new Error(\n        '@carddex/sdk requires a global fetch implementation. On Node < 18, pass one via `fetch` in the options.',\n      );\n    }\n\n    this.http = new HttpClient({\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: options.apiKey,\n      fetch: fetchImpl.bind(globalThis),\n      retry: options.retry,\n    });\n\n    this.cards = new CardsResource(this.http);\n    this.sets = new SetsResource(this.http);\n    this.sealed = new SealedResource(this.http);\n    this.prices = new PricesResource(this.http);\n    this.auth = new AuthResource(this.http);\n  }\n\n  /** `GET /v1/auth/usage` — shorthand for `client.auth.usage()`. Requires an `apiKey`. */\n  usage(): Promise<UsageResponse> {\n    return this.auth.usage();\n  }\n\n  /** `GET /v1/health` — API health, price freshness, and cron status. */\n  async health(): Promise<HealthResponse> {\n    return this.http.get<HealthResponse>('/v1/health');\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -53,7 +53,9 @@ declare class HttpClient {
  */
 interface CardDexSet {
     id: string;
-    /** The English name. */
+    /** `'ja'` or `'pl'` on non-English sets; absent on English sets. */
+    catalog?: 'ja' | 'pl' | (string & {});
+    /** The English name; for a Japanese set (`catalog: 'ja'`) or Polish set (`catalog: 'pl'`) the name printed on the set. */
     name: string;
     /** The name in the `lang` edition, or null where none is known. Only when `lang` is not `en`. */
     localized_name?: string | null;
@@ -63,6 +65,7 @@ interface CardDexSet {
     total_cards: number | null;
     logo_url: string | null;
     symbol_url: string | null;
+    /** The code printed on the set's cards (e.g. `sv2a` on a Japanese set); null for Polish sets or where there is none. */
     set_code: string | null;
     created_at: string;
     updated_at: string;
@@ -102,11 +105,27 @@ interface CardImage {
     small_url: string | null;
     large_url: string | null;
 }
-/** One price guide's currency and figures. `source` is `'cardmarket' | 'tcgplayer'` in practice. */
+/**
+ * A card's scan in the `lang` edition (de, fr, it, es, pt): `localized_image`.
+ * Each URL falls back to the next larger size, as the English ones do.
+ */
+interface LocalizedCardImage {
+    /** The `lang` of the request. */
+    language: string;
+    thumb_url: string | null;
+    small_url: string | null;
+    large_url: string | null;
+}
+/**
+ * One price guide's currency and figures. `source` is `'cardmarket' | 'tcgplayer'`
+ * in practice; Japanese cards are priced by `'cardmarket'` (EUR).
+ */
 interface CardPrice {
     id: number;
     card_id: string;
     card_name?: string | null;
+    /** Rankings with a non-English catalogue (`catalog=ja`, `catalog=pl`): the card's English name (`card_name` is the printed name). */
+    card_name_en?: string | null;
     number?: string | null;
     set_id?: string | null;
     rarity?: string | null;
@@ -149,17 +168,37 @@ interface CardVariant {
 }
 interface Card {
     id: string;
+    /** `'ja'` or `'pl'` on non-English cards; absent on English cards. */
+    catalog?: 'ja' | 'pl' | (string & {});
     set_id: string;
-    /** The English name, always. */
+    /** The English name; for a Japanese card (`catalog: 'ja'`) or Polish card (`catalog: 'pl'`) the printed name. */
     name: string;
+    /** A Japanese or Polish card's English name, or null where unknown. Absent on English cards. */
+    name_en?: string | null;
+    /** Polish cards only (absent on English and Japanese ones): the English twin card's id (e.g. `dp1-1` for `pl-dp1-1`), or null for cards without an English twin (`pl-promo-1`). */
+    english_id?: string | null;
     /** The name in the `lang` edition (de, fr, it, es, pt), or null where none is known. Only when `lang` is not `en`. */
     localized_name?: string | null;
+    /**
+     * The scan in the `lang` edition, or null when there is none (show the
+     * English image then). Only when `lang` is not `en`. The English image
+     * fields (`image_url`, `images`) never change with `lang`.
+     */
+    localized_image?: LocalizedCardImage | null;
     number: string;
     supertype: string;
     subtypes: string[] | null;
     hp: number | null;
     types: string[] | null;
     rarity: string | null;
+    /**
+     * The finish of the card's own print, where the rarity does not say it:
+     * `holo` for a card only ever printed holo (e.g. the HGSS Black Star Promos,
+     * catalogued as Common). Present only when known; absent, never null, on
+     * every other card. A variant (`/v1/cards/{id}/variants`) still names its own
+     * print's finish; this describes the card when no variant is named.
+     */
+    base_finish?: 'holo' | 'reverse' | 'normal';
     artist: string | null;
     regulation_mark: string | null;
     flavor_text: string | null;
@@ -336,12 +375,22 @@ type CardInclude = 'attacks' | 'abilities' | 'weaknesses' | 'resistances' | 'ima
 /** Every localized name of the card (`translations: CardTranslation[]`). Never a default. */
  | 'translations';
 /**
- * Language edition for names. `name` is always the English name; with any
- * value but `en`, cards and sets also carry `localized_name` (null where none
- * is known), and `name` / `q` match names in that language too. `pl` is not
- * accepted: no source has Polish card names.
+ * Language edition for names and scans. `name` is always the English name;
+ * with any value but `en`, cards and sets also carry `localized_name` (null
+ * where none is known), cards also carry `localized_image` (the scan in that
+ * edition, or null: show the English image), and `name` / `q` match names in
+ * that language too. `pl` is not accepted: no source has Polish card names.
  */
 type CardLanguage = 'en' | 'de' | 'fr' | 'it' | 'es' | 'pt';
+/**
+ * Card catalogue. `en` (English, the default), `ja` (Japanese: its own sets,
+ * numbering and printed names; ids are prefixed `ja-`), or `pl` (Polish:
+ * Diamond & Pearl, Mysterious Treasures, and promo Pikachu; ids are prefixed `pl-`).
+ * The API reserves further codes (`zh-tw`, `zh-cn`, `ko`, `th`) that answer
+ * 400 "not available yet"; they will be added here as they go live, and any
+ * string is accepted.
+ */
+type CardCatalog = 'en' | 'ja' | 'pl';
 type CardListParams = {
     name?: string;
     q?: string;
@@ -352,8 +401,10 @@ type CardListParams = {
     hp_gte?: number;
     hp_lte?: number;
     artist?: string;
-    /** Adds `localized_name` and searches names in that language too. Defaults to `en`. */
+    /** Adds `localized_name` and `localized_image`, and searches names in that language too. Defaults to `en`. */
     lang?: CardLanguage;
+    /** Card catalogue; defaults to `en`. Lists, searches and rankings read one catalogue only. */
+    catalog?: CardCatalog;
     page?: number;
     /** Max 250. */
     pageSize?: number;
@@ -365,16 +416,22 @@ type CardListParams = {
     source?: CardPriceSource | CardPriceSource[];
 };
 type CardGetParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     include?: CardInclude | CardInclude[];
     source?: CardPriceSource | CardPriceSource[];
-    /** Adds `localized_name`. Defaults to `en`. */
+    /** Adds `localized_name` and `localized_image`. Defaults to `en`. */
     lang?: CardLanguage;
 };
 type SetGetParams = {
+    /** Card catalogue; defaults to `en`. `sets.list` returns one catalogue's sets. */
+    catalog?: CardCatalog;
     /** Adds `localized_name` to the set(s). Defaults to `en`. */
     lang?: CardLanguage;
 };
 type CardPricesParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     /** Price this print instead of the base card. */
     variant_id?: string;
     source?: CardPriceSource | CardPriceSource[];
@@ -384,9 +441,11 @@ type CardPriceHistoryParams = CardPricesParams & {
     days?: number;
 };
 type SetCardsParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     page?: number;
     pageSize?: number;
-    /** Adds `localized_name` to every card. Defaults to `en`. */
+    /** Adds `localized_name` and `localized_image` to every card. Defaults to `en`. */
     lang?: CardLanguage;
 };
 type SealedListParams = {
@@ -408,9 +467,13 @@ type BulkPricesParams = {
     ids?: string[];
     /** Print (variant) ids, up to 100. At least one of `ids`/`variants` is required. */
     variants?: string[];
+    /** Catalogue to read; defaults to `en` when `ids` is absent. Each id is otherwise priced in its own catalogue. */
+    catalog?: CardCatalog;
     source?: CardPriceSource | CardPriceSource[];
 };
 type RankingParams = {
+    /** Card catalogue; defaults to `en`. Rankings rank one catalogue only. */
+    catalog?: CardCatalog;
     limit?: number;
     offset?: number;
     /** Narrow to one CardDex set id. */
@@ -425,11 +488,18 @@ type BargainsParams = RankingParams & {
     minPrice?: number;
 };
 type PriceHistoryParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     days?: number;
     /** Print (variant) id; defaults to the base card. */
     variant?: string;
     source?: CardPriceSource | CardPriceSource[];
 };
+/** `GET /v1/cards/random` and `GET /v1/cards/rarities`. */
+type CatalogParams = {
+    /** Card catalogue; defaults to `en`. */
+    catalog?: CardCatalog;
+};
 
 declare class CardsResource {
     private readonly http;
@@ -446,8 +516,10 @@ declare class CardsResource {
      * ```
      */
     listAll(params?: Omit<CardListParams, 'page'>): AsyncGenerator<Card, void, void>;
-    /** `GET /v1/cards/random` */
-    random(): Promise<CardWithRelations>;
+    /** `GET /v1/cards/random` — `catalog: 'ja'` or `catalog: 'pl'` draws a card from that catalogue. */
+    random(params?: CatalogParams): Promise<CardWithRelations>;
+    /** `GET /v1/cards/rarities` — every distinct rarity of one catalogue. */
+    rarities(params?: CatalogParams): Promise<string[]>;
     /** `GET /v1/cards/{id}` */
     get(id: string, params?: CardGetParams): Promise<CardWithRelations>;
     /** `GET /v1/cards/{id}/prices` — the latest price row(s) for a card. */
@@ -493,7 +565,7 @@ declare class SealedResource {
 declare class SetsResource {
     private readonly http;
     constructor(http: HttpClient);
-    /** `GET /v1/sets` — every set. `lang` adds `localized_name`. */
+    /** `GET /v1/sets` — every set of one catalogue (`catalog`, default `en`). `lang` adds `localized_name`. */
     list(params?: SetGetParams): Promise<CardDexSet[]>;
     /** `GET /v1/sets/{id}` — `lang` adds `localized_name`. */
     get(id: string, params?: SetGetParams): Promise<CardDexSet>;
@@ -610,4 +682,4 @@ declare class CardDexError extends Error {
  */
 declare function paginate<T>(fetchPage: (page: number) => Promise<PaginatedResponse<T>>, startPage?: number): AsyncGenerator<T, void, void>;
 
-export { type ApiErrorBody, type BargainCardPrice, type BargainsParams, type BulkPricesParams, type Card, type CardAbility, type CardAttack, CardDex, CardDexError, type CardDexOptions, type CardDexSet, type CardGetParams, type CardImage, type CardInclude, type CardLanguage, type CardListParams, type CardNeighbors, type CardPrice, type CardPriceHistoryParams, type CardPriceSource, type CardPriceSourceOne, type CardPricesParams, type CardResistance, type CardSortField, type CardTranslation, type CardVariant, type CardWeakness, type CardWithRelations, type HealthResponse, type PaginatedResponse, type PaginationMeta, type PriceHistoryParams, type RankingParams, type RateLimitInfo, type RegisterResponse, type RetryOptions, type SealedLatestPrice, type SealedListParams, type SealedPrice, type SealedPriceHistoryParams, type SealedPriceSource, type SealedProduct, type SealedProductType, type SetCardsParams, type SetGetParams, type SingleResponse, type TrendsParams, type UsageRecentRequest, type UsageResponse, paginate };
+export { type ApiErrorBody, type BargainCardPrice, type BargainsParams, type BulkPricesParams, type Card, type CardAbility, type CardAttack, type CardCatalog, CardDex, CardDexError, type CardDexOptions, type CardDexSet, type CardGetParams, type CardImage, type CardInclude, type CardLanguage, type CardListParams, type CardNeighbors, type CardPrice, type CardPriceHistoryParams, type CardPriceSource, type CardPriceSourceOne, type CardPricesParams, type CardResistance, type CardSortField, type CardTranslation, type CardVariant, type CardWeakness, type CardWithRelations, type CatalogParams, type HealthResponse, type LocalizedCardImage, type PaginatedResponse, type PaginationMeta, type PriceHistoryParams, type RankingParams, type RateLimitInfo, type RegisterResponse, type RetryOptions, type SealedLatestPrice, type SealedListParams, type SealedPrice, type SealedPriceHistoryParams, type SealedPriceSource, type SealedProduct, type SealedProductType, type SetCardsParams, type SetGetParams, type SingleResponse, type TrendsParams, type UsageRecentRequest, type UsageResponse, paginate };

package/dist/index.d.ts

@@ -53,7 +53,9 @@ declare class HttpClient {
  */
 interface CardDexSet {
     id: string;
-    /** The English name. */
+    /** `'ja'` or `'pl'` on non-English sets; absent on English sets. */
+    catalog?: 'ja' | 'pl' | (string & {});
+    /** The English name; for a Japanese set (`catalog: 'ja'`) or Polish set (`catalog: 'pl'`) the name printed on the set. */
     name: string;
     /** The name in the `lang` edition, or null where none is known. Only when `lang` is not `en`. */
     localized_name?: string | null;
@@ -63,6 +65,7 @@ interface CardDexSet {
     total_cards: number | null;
     logo_url: string | null;
     symbol_url: string | null;
+    /** The code printed on the set's cards (e.g. `sv2a` on a Japanese set); null for Polish sets or where there is none. */
     set_code: string | null;
     created_at: string;
     updated_at: string;
@@ -102,11 +105,27 @@ interface CardImage {
     small_url: string | null;
     large_url: string | null;
 }
-/** One price guide's currency and figures. `source` is `'cardmarket' | 'tcgplayer'` in practice. */
+/**
+ * A card's scan in the `lang` edition (de, fr, it, es, pt): `localized_image`.
+ * Each URL falls back to the next larger size, as the English ones do.
+ */
+interface LocalizedCardImage {
+    /** The `lang` of the request. */
+    language: string;
+    thumb_url: string | null;
+    small_url: string | null;
+    large_url: string | null;
+}
+/**
+ * One price guide's currency and figures. `source` is `'cardmarket' | 'tcgplayer'`
+ * in practice; Japanese cards are priced by `'cardmarket'` (EUR).
+ */
 interface CardPrice {
     id: number;
     card_id: string;
     card_name?: string | null;
+    /** Rankings with a non-English catalogue (`catalog=ja`, `catalog=pl`): the card's English name (`card_name` is the printed name). */
+    card_name_en?: string | null;
     number?: string | null;
     set_id?: string | null;
     rarity?: string | null;
@@ -149,17 +168,37 @@ interface CardVariant {
 }
 interface Card {
     id: string;
+    /** `'ja'` or `'pl'` on non-English cards; absent on English cards. */
+    catalog?: 'ja' | 'pl' | (string & {});
     set_id: string;
-    /** The English name, always. */
+    /** The English name; for a Japanese card (`catalog: 'ja'`) or Polish card (`catalog: 'pl'`) the printed name. */
     name: string;
+    /** A Japanese or Polish card's English name, or null where unknown. Absent on English cards. */
+    name_en?: string | null;
+    /** Polish cards only (absent on English and Japanese ones): the English twin card's id (e.g. `dp1-1` for `pl-dp1-1`), or null for cards without an English twin (`pl-promo-1`). */
+    english_id?: string | null;
     /** The name in the `lang` edition (de, fr, it, es, pt), or null where none is known. Only when `lang` is not `en`. */
     localized_name?: string | null;
+    /**
+     * The scan in the `lang` edition, or null when there is none (show the
+     * English image then). Only when `lang` is not `en`. The English image
+     * fields (`image_url`, `images`) never change with `lang`.
+     */
+    localized_image?: LocalizedCardImage | null;
     number: string;
     supertype: string;
     subtypes: string[] | null;
     hp: number | null;
     types: string[] | null;
     rarity: string | null;
+    /**
+     * The finish of the card's own print, where the rarity does not say it:
+     * `holo` for a card only ever printed holo (e.g. the HGSS Black Star Promos,
+     * catalogued as Common). Present only when known; absent, never null, on
+     * every other card. A variant (`/v1/cards/{id}/variants`) still names its own
+     * print's finish; this describes the card when no variant is named.
+     */
+    base_finish?: 'holo' | 'reverse' | 'normal';
     artist: string | null;
     regulation_mark: string | null;
     flavor_text: string | null;
@@ -336,12 +375,22 @@ type CardInclude = 'attacks' | 'abilities' | 'weaknesses' | 'resistances' | 'ima
 /** Every localized name of the card (`translations: CardTranslation[]`). Never a default. */
  | 'translations';
 /**
- * Language edition for names. `name` is always the English name; with any
- * value but `en`, cards and sets also carry `localized_name` (null where none
- * is known), and `name` / `q` match names in that language too. `pl` is not
- * accepted: no source has Polish card names.
+ * Language edition for names and scans. `name` is always the English name;
+ * with any value but `en`, cards and sets also carry `localized_name` (null
+ * where none is known), cards also carry `localized_image` (the scan in that
+ * edition, or null: show the English image), and `name` / `q` match names in
+ * that language too. `pl` is not accepted: no source has Polish card names.
  */
 type CardLanguage = 'en' | 'de' | 'fr' | 'it' | 'es' | 'pt';
+/**
+ * Card catalogue. `en` (English, the default), `ja` (Japanese: its own sets,
+ * numbering and printed names; ids are prefixed `ja-`), or `pl` (Polish:
+ * Diamond & Pearl, Mysterious Treasures, and promo Pikachu; ids are prefixed `pl-`).
+ * The API reserves further codes (`zh-tw`, `zh-cn`, `ko`, `th`) that answer
+ * 400 "not available yet"; they will be added here as they go live, and any
+ * string is accepted.
+ */
+type CardCatalog = 'en' | 'ja' | 'pl';
 type CardListParams = {
     name?: string;
     q?: string;
@@ -352,8 +401,10 @@ type CardListParams = {
     hp_gte?: number;
     hp_lte?: number;
     artist?: string;
-    /** Adds `localized_name` and searches names in that language too. Defaults to `en`. */
+    /** Adds `localized_name` and `localized_image`, and searches names in that language too. Defaults to `en`. */
     lang?: CardLanguage;
+    /** Card catalogue; defaults to `en`. Lists, searches and rankings read one catalogue only. */
+    catalog?: CardCatalog;
     page?: number;
     /** Max 250. */
     pageSize?: number;
@@ -365,16 +416,22 @@ type CardListParams = {
     source?: CardPriceSource | CardPriceSource[];
 };
 type CardGetParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     include?: CardInclude | CardInclude[];
     source?: CardPriceSource | CardPriceSource[];
-    /** Adds `localized_name`. Defaults to `en`. */
+    /** Adds `localized_name` and `localized_image`. Defaults to `en`. */
     lang?: CardLanguage;
 };
 type SetGetParams = {
+    /** Card catalogue; defaults to `en`. `sets.list` returns one catalogue's sets. */
+    catalog?: CardCatalog;
     /** Adds `localized_name` to the set(s). Defaults to `en`. */
     lang?: CardLanguage;
 };
 type CardPricesParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     /** Price this print instead of the base card. */
     variant_id?: string;
     source?: CardPriceSource | CardPriceSource[];
@@ -384,9 +441,11 @@ type CardPriceHistoryParams = CardPricesParams & {
     days?: number;
 };
 type SetCardsParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     page?: number;
     pageSize?: number;
-    /** Adds `localized_name` to every card. Defaults to `en`. */
+    /** Adds `localized_name` and `localized_image` to every card. Defaults to `en`. */
     lang?: CardLanguage;
 };
 type SealedListParams = {
@@ -408,9 +467,13 @@ type BulkPricesParams = {
     ids?: string[];
     /** Print (variant) ids, up to 100. At least one of `ids`/`variants` is required. */
     variants?: string[];
+    /** Catalogue to read; defaults to `en` when `ids` is absent. Each id is otherwise priced in its own catalogue. */
+    catalog?: CardCatalog;
     source?: CardPriceSource | CardPriceSource[];
 };
 type RankingParams = {
+    /** Card catalogue; defaults to `en`. Rankings rank one catalogue only. */
+    catalog?: CardCatalog;
     limit?: number;
     offset?: number;
     /** Narrow to one CardDex set id. */
@@ -425,11 +488,18 @@ type BargainsParams = RankingParams & {
     minPrice?: number;
 };
 type PriceHistoryParams = {
+    /** Optional on keyed reads: the catalogue is inferred from the id (`ja-`, `pl-` prefix). An id of another catalogue answers as unknown. */
+    catalog?: CardCatalog;
     days?: number;
     /** Print (variant) id; defaults to the base card. */
     variant?: string;
     source?: CardPriceSource | CardPriceSource[];
 };
+/** `GET /v1/cards/random` and `GET /v1/cards/rarities`. */
+type CatalogParams = {
+    /** Card catalogue; defaults to `en`. */
+    catalog?: CardCatalog;
+};
 
 declare class CardsResource {
     private readonly http;
@@ -446,8 +516,10 @@ declare class CardsResource {
      * ```
      */
     listAll(params?: Omit<CardListParams, 'page'>): AsyncGenerator<Card, void, void>;
-    /** `GET /v1/cards/random` */
-    random(): Promise<CardWithRelations>;
+    /** `GET /v1/cards/random` — `catalog: 'ja'` or `catalog: 'pl'` draws a card from that catalogue. */
+    random(params?: CatalogParams): Promise<CardWithRelations>;
+    /** `GET /v1/cards/rarities` — every distinct rarity of one catalogue. */
+    rarities(params?: CatalogParams): Promise<string[]>;
     /** `GET /v1/cards/{id}` */
     get(id: string, params?: CardGetParams): Promise<CardWithRelations>;
     /** `GET /v1/cards/{id}/prices` — the latest price row(s) for a card. */
@@ -493,7 +565,7 @@ declare class SealedResource {
 declare class SetsResource {
     private readonly http;
     constructor(http: HttpClient);
-    /** `GET /v1/sets` — every set. `lang` adds `localized_name`. */
+    /** `GET /v1/sets` — every set of one catalogue (`catalog`, default `en`). `lang` adds `localized_name`. */
     list(params?: SetGetParams): Promise<CardDexSet[]>;
     /** `GET /v1/sets/{id}` — `lang` adds `localized_name`. */
     get(id: string, params?: SetGetParams): Promise<CardDexSet>;
@@ -610,4 +682,4 @@ declare class CardDexError extends Error {
  */
 declare function paginate<T>(fetchPage: (page: number) => Promise<PaginatedResponse<T>>, startPage?: number): AsyncGenerator<T, void, void>;
 
-export { type ApiErrorBody, type BargainCardPrice, type BargainsParams, type BulkPricesParams, type Card, type CardAbility, type CardAttack, CardDex, CardDexError, type CardDexOptions, type CardDexSet, type CardGetParams, type CardImage, type CardInclude, type CardLanguage, type CardListParams, type CardNeighbors, type CardPrice, type CardPriceHistoryParams, type CardPriceSource, type CardPriceSourceOne, type CardPricesParams, type CardResistance, type CardSortField, type CardTranslation, type CardVariant, type CardWeakness, type CardWithRelations, type HealthResponse, type PaginatedResponse, type PaginationMeta, type PriceHistoryParams, type RankingParams, type RateLimitInfo, type RegisterResponse, type RetryOptions, type SealedLatestPrice, type SealedListParams, type SealedPrice, type SealedPriceHistoryParams, type SealedPriceSource, type SealedProduct, type SealedProductType, type SetCardsParams, type SetGetParams, type SingleResponse, type TrendsParams, type UsageRecentRequest, type UsageResponse, paginate };
+export { type ApiErrorBody, type BargainCardPrice, type BargainsParams, type BulkPricesParams, type Card, type CardAbility, type CardAttack, type CardCatalog, CardDex, CardDexError, type CardDexOptions, type CardDexSet, type CardGetParams, type CardImage, type CardInclude, type CardLanguage, type CardListParams, type CardNeighbors, type CardPrice, type CardPriceHistoryParams, type CardPriceSource, type CardPriceSourceOne, type CardPricesParams, type CardResistance, type CardSortField, type CardTranslation, type CardVariant, type CardWeakness, type CardWithRelations, type CatalogParams, type HealthResponse, type LocalizedCardImage, type PaginatedResponse, type PaginationMeta, type PriceHistoryParams, type RankingParams, type RateLimitInfo, type RegisterResponse, type RetryOptions, type SealedLatestPrice, type SealedListParams, type SealedPrice, type SealedPriceHistoryParams, type SealedPriceSource, type SealedProduct, type SealedProductType, type SetCardsParams, type SetGetParams, type SingleResponse, type TrendsParams, type UsageRecentRequest, type UsageResponse, paginate };

package/dist/index.js

@@ -213,9 +213,14 @@ var CardsResource = class {
   listAll(params) {
     return paginate((page) => this.list({ ...params, page }));
   }
-  /** `GET /v1/cards/random` */
-  async random() {
-    const res = await this.http.get("/v1/cards/random");
+  /** `GET /v1/cards/random` — `catalog: 'ja'` or `catalog: 'pl'` draws a card from that catalogue. */
+  async random(params) {
+    const res = await this.http.get("/v1/cards/random", params);
+    return res.data;
+  }
+  /** `GET /v1/cards/rarities` — every distinct rarity of one catalogue. */
+  async rarities(params) {
+    const res = await this.http.get("/v1/cards/rarities", params);
     return res.data;
   }
   /** `GET /v1/cards/{id}` */
@@ -328,7 +333,7 @@ var SetsResource = class {
     this.http = http;
   }
   http;
-  /** `GET /v1/sets` — every set. `lang` adds `localized_name`. */
+  /** `GET /v1/sets` — every set of one catalogue (`catalog`, default `en`). `lang` adds `localized_name`. */
   async list(params) {
     const res = await this.http.get("/v1/sets", params);
     return res.data;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/auth.ts","../src/pagination.ts","../src/resources/cards.ts","../src/resources/prices.ts","../src/resources/sealed.ts","../src/resources/sets.ts","../src/client.ts"],"sourcesContent":["/** Rate-limit info parsed from response headers, when present. */\nexport interface RateLimitInfo {\n  /** `X-RateLimit-Limit`: requests allowed per minute. */\n  limit: number | null;\n  /** `X-RateLimit-Daily-Limit`: requests allowed per UTC day, or `null` when the tier is uncapped. */\n  dailyLimit: number | null;\n  /** `X-RateLimit-Daily-Remaining`: approximate, can lag by about a minute. `null` when the API couldn't compute it. */\n  dailyRemaining: number | null;\n}\n\nfunction parseRateLimitHeaders(headers: Headers): RateLimitInfo {\n  const num = (name: string): number | null => {\n    const raw = headers.get(name);\n    if (raw == null) return null;\n    const n = Number(raw);\n    return Number.isFinite(n) ? n : null;\n  };\n  return {\n    limit: num('X-RateLimit-Limit'),\n    dailyLimit: num('X-RateLimit-Daily-Limit'),\n    dailyRemaining: num('X-RateLimit-Daily-Remaining'),\n  };\n}\n\n/**\n * Thrown for any non-2xx response, and for network/parse failures the fetch\n * layer can't attribute to the API itself.\n */\nexport class CardDexError extends Error {\n  /** HTTP status code. `0` for a request that never got a response (network failure, abort). */\n  readonly status: number;\n  /**\n   * The API's own `error.code`. For a response the API actually produced,\n   * this is the same number as `status` (see the note on `ApiErrorBody` in\n   * `types.ts`) — kept as its own field because a transport-level failure\n   * (no response at all) sets it to a string like `NETWORK_ERROR` instead.\n   */\n  readonly code: number | string;\n  /** Seconds to wait before retrying, parsed from `Retry-After` on a 429. `null` otherwise. */\n  readonly retryAfter: number | null;\n  /** Rate-limit headers on the response, when there was one. */\n  readonly rateLimit: RateLimitInfo | null;\n\n  constructor(\n    message: string,\n    options: {\n      status: number;\n      code: number | string;\n      retryAfter?: number | null;\n      rateLimit?: RateLimitInfo | null;\n      cause?: unknown;\n    },\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'CardDexError';\n    this.status = options.status;\n    this.code = options.code;\n    this.retryAfter = options.retryAfter ?? null;\n    this.rateLimit = options.rateLimit ?? null;\n    Object.setPrototypeOf(this, CardDexError.prototype);\n  }\n\n  /** Whether this is a 429 (either the per-minute or the daily cap). */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  static async fromResponse(response: Response): Promise<CardDexError> {\n    const rateLimit = parseRateLimitHeaders(response.headers);\n    const retryAfterHeader = response.headers.get('Retry-After');\n    const retryAfter = retryAfterHeader != null ? Number(retryAfterHeader) : null;\n\n    let message = `CardDex API error (${response.status})`;\n    let code: number | string = response.status;\n    try {\n      const body = (await response.clone().json()) as {\n        error?: { code?: unknown; message?: unknown };\n      };\n      if (body?.error) {\n        if (typeof body.error.message === 'string') message = body.error.message;\n        if (typeof body.error.code === 'number' || typeof body.error.code === 'string') {\n          code = body.error.code;\n        }\n      }\n    } catch {\n      // Non-JSON or empty error body — fall back to the status-derived message above.\n    }\n\n    return new CardDexError(message, {\n      status: response.status,\n      code,\n      retryAfter: Number.isFinite(retryAfter) ? retryAfter : null,\n      rateLimit,\n    });\n  }\n\n  static network(cause: unknown): CardDexError {\n    const message = cause instanceof Error ? cause.message : 'Network request failed';\n    return new CardDexError(message, { status: 0, code: 'NETWORK_ERROR', cause });\n  }\n}\n","import { CardDexError } from './errors.js';\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | undefined\n  | null\n  | readonly (string | number)[];\nexport type QueryParams = Record<string, QueryValue>;\n\nexport interface RetryOptions {\n  /** Max retry attempts on 429. Default 2. */\n  maxRetries?: number;\n  /**\n   * A computed `Retry-After` above this many seconds is never honoured — the\n   * request fails immediately instead of sleeping (this is what keeps a\n   * daily-quota 429, whose `Retry-After` can be most of a day, from blocking\n   * for hours). Default 60, matching the per-minute limiter's own\n   * `Retry-After: 60`.\n   */\n  maxWaitSeconds?: number;\n}\n\nexport interface HttpClientOptions {\n  baseUrl: string;\n  apiKey?: string;\n  fetch: typeof fetch;\n  /** `false` (default) disables retries; `true` enables them with the defaults below. */\n  retry?: boolean | RetryOptions;\n}\n\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_MAX_WAIT_SECONDS = 60;\n\nfunction buildQueryString(params?: QueryParams): string {\n  if (!params) return '';\n  const search = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) continue;\n      search.set(key, value.join(','));\n    } else {\n      search.set(key, String(value));\n    }\n  }\n  const qs = search.toString();\n  return qs ? `?${qs}` : '';\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Minimal fetch wrapper: builds URLs, attaches auth, parses JSON, and turns\n * non-2xx responses into `CardDexError`. No dependency beyond global `fetch`.\n */\nexport class HttpClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly fetchImpl: typeof fetch;\n  private readonly retryConfig: Required<RetryOptions> | null;\n\n  constructor(options: HttpClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, '');\n    this.apiKey = options.apiKey;\n    this.fetchImpl = options.fetch;\n    if (options.retry === true) {\n      this.retryConfig = {\n        maxRetries: DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else if (options.retry && typeof options.retry === 'object') {\n      this.retryConfig = {\n        maxRetries: options.retry.maxRetries ?? DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: options.retry.maxWaitSeconds ?? DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else {\n      this.retryConfig = null;\n    }\n  }\n\n  async get<T>(path: string, query?: QueryParams, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('GET', path, { query, signal });\n  }\n\n  async post<T>(path: string, body?: unknown, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('POST', path, { body, signal });\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    opts: { query?: QueryParams; body?: unknown; signal?: AbortSignal },\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}${buildQueryString(opts.query)}`;\n    const headers: Record<string, string> = { Accept: 'application/json' };\n    if (this.apiKey) headers['X-API-Key'] = this.apiKey;\n    if (opts.body !== undefined) headers['Content-Type'] = 'application/json';\n\n    let attempt = 0;\n    for (;;) {\n      let response: Response;\n      try {\n        response = await this.fetchImpl(url, {\n          method,\n          headers,\n          body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,\n          signal: opts.signal,\n        });\n      } catch (cause) {\n        throw CardDexError.network(cause);\n      }\n\n      if (response.status === 429 && this.retryConfig && attempt < this.retryConfig.maxRetries) {\n        const retryAfterHeader = response.headers.get('Retry-After');\n        const retryAfterSeconds = retryAfterHeader != null ? Number(retryAfterHeader) : Number.NaN;\n        if (\n          Number.isFinite(retryAfterSeconds) &&\n          retryAfterSeconds <= this.retryConfig.maxWaitSeconds\n        ) {\n          attempt++;\n          await sleep(retryAfterSeconds * 1000);\n          continue;\n        }\n        // Retry-After is missing or longer than we're willing to wait\n        // (typically the daily cap, which resets at UTC midnight) — surface\n        // the error instead of blocking.\n      }\n\n      if (!response.ok) {\n        throw await CardDexError.fromResponse(response);\n      }\n\n      if (response.status === 204) return undefined as T;\n      return (await response.json()) as T;\n    }\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type { RegisterResponse, SingleResponse, UsageResponse } from '../types.js';\n\nexport class AuthResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `POST /v1/auth/register` — claim a free API key. The key is returned\n   * exactly once, so store it immediately. A lost key can be replaced by signing\n   * in at https://carddex.dev/account (create, rotate or revoke keys there).\n   */\n  async register(email: string, name?: string): Promise<RegisterResponse> {\n    const res = await this.http.post<SingleResponse<RegisterResponse>>('/v1/auth/register', {\n      email,\n      name,\n    });\n    return res.data;\n  }\n\n  /** `GET /v1/auth/usage` — usage stats for the API key this client was constructed with. Requires an `apiKey`. */\n  async usage(): Promise<UsageResponse> {\n    const res = await this.http.get<SingleResponse<UsageResponse>>('/v1/auth/usage');\n    return res.data;\n  }\n}\n","import type { PaginatedResponse } from './types.js';\n\n/**\n * Turns a page-fetching function into an async iterator over every item,\n * fetching the next page lazily as the caller consumes items.\n *\n * @example\n * ```ts\n * for await (const card of paginate((page) => client.cards.list({ set: 'sv06', page }))) {\n *   console.log(card.name);\n * }\n * ```\n */\nexport async function* paginate<T>(\n  fetchPage: (page: number) => Promise<PaginatedResponse<T>>,\n  startPage = 1,\n): AsyncGenerator<T, void, void> {\n  let page = startPage;\n  for (;;) {\n    const response = await fetchPage(page);\n    if (response.data.length === 0) return;\n    yield* response.data;\n    if (page >= response.meta.totalPages) return;\n    page++;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type {\n  CardGetParams,\n  CardListParams,\n  CardPriceHistoryParams,\n  CardPricesParams,\n} from '../params.js';\nimport type {\n  Card,\n  CardPrice,\n  CardWithRelations,\n  PaginatedResponse,\n  SingleResponse,\n} from '../types.js';\n\nexport class CardsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/cards` — list, search, filter and sort cards. */\n  list(params?: CardListParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>('/v1/cards', params);\n  }\n\n  /**\n   * Iterates every card matching `params` across all pages, fetching pages\n   * lazily as you consume them.\n   *\n   * @example\n   * ```ts\n   * for await (const card of client.cards.listAll({ set: 'sv06' })) { ... }\n   * ```\n   */\n  listAll(params?: Omit<CardListParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/cards/random` */\n  async random(): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>('/v1/cards/random');\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}` */\n  async get(id: string, params?: CardGetParams): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>(\n      `/v1/cards/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices` — the latest price row(s) for a card. */\n  async prices(id: string, params?: CardPricesParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices/history` — one row per day per price guide, oldest first. */\n  async priceHistory(id: string, params?: CardPriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type {\n  BargainsParams,\n  BulkPricesParams,\n  PriceHistoryParams,\n  RankingParams,\n  TrendsParams,\n} from '../params.js';\nimport type { BargainCardPrice, CardPrice, SingleResponse } from '../types.js';\n\nexport class PricesResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `GET /v1/prices` — latest price rows for up to 100 card ids (and/or up\n   * to 100 print/variant ids) in one request. Keyed by the id you asked for;\n   * an id with no price data maps to `[]`.\n   */\n  async bulk(params: BulkPricesParams): Promise<Record<string, CardPrice[]>> {\n    const res = await this.http.get<SingleResponse<Record<string, CardPrice[]>>>(\n      '/v1/prices',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/top` — highest-valued cards. */\n  async top(params?: RankingParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/top', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/trends` — biggest movers against the card's own rolling average. */\n  async trends(params?: TrendsParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/trends', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/bargains` — cards trading below a reference price, best discount first. */\n  async bargains(params?: BargainsParams): Promise<BargainCardPrice[]> {\n    const res = await this.http.get<SingleResponse<BargainCardPrice[]>>(\n      '/v1/prices/bargains',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/{cardId}/history` — one row per day per guide, oldest first. */\n  async history(cardId: string, params?: PriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/prices/${encodeURIComponent(cardId)}/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedListParams, SealedPriceHistoryParams } from '../params.js';\nimport type { PaginatedResponse, SealedPrice, SealedProduct, SingleResponse } from '../types.js';\n\nexport class SealedResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sealed` — list sealed products with their latest price. */\n  list(params?: SealedListParams): Promise<PaginatedResponse<SealedProduct>> {\n    return this.http.get<PaginatedResponse<SealedProduct>>('/v1/sealed', params);\n  }\n\n  /** Iterates every sealed product matching `params` across all pages. */\n  listAll(params?: Omit<SealedListParams, 'page'>): AsyncGenerator<SealedProduct, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/sealed/{id}` */\n  async get(id: string, params?: { source?: SealedListParams['source'] }): Promise<SealedProduct> {\n    const res = await this.http.get<SingleResponse<SealedProduct>>(\n      `/v1/sealed/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sealed/{id}/prices` — one row per synced day, oldest first. */\n  async prices(id: string, params?: SealedPriceHistoryParams): Promise<SealedPrice[]> {\n    const res = await this.http.get<SingleResponse<SealedPrice[]>>(\n      `/v1/sealed/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedPriceSource, SetCardsParams, SetGetParams } from '../params.js';\nimport type {\n  Card,\n  CardDexSet,\n  CardNeighbors,\n  PaginatedResponse,\n  SealedProduct,\n  SingleResponse,\n} from '../types.js';\n\nexport class SetsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sets` — every set. `lang` adds `localized_name`. */\n  async list(params?: SetGetParams): Promise<CardDexSet[]> {\n    const res = await this.http.get<SingleResponse<CardDexSet[]>>('/v1/sets', params);\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}` — `lang` adds `localized_name`. */\n  async get(id: string, params?: SetGetParams): Promise<CardDexSet> {\n    const res = await this.http.get<SingleResponse<CardDexSet>>(\n      `/v1/sets/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/cards` */\n  cards(id: string, params?: SetCardsParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>(\n      `/v1/sets/${encodeURIComponent(id)}/cards`,\n      params,\n    );\n  }\n\n  /** Iterates every card in a set across all pages. */\n  cardsAll(id: string, params?: Omit<SetCardsParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.cards(id, { ...params, page }));\n  }\n\n  /** `GET /v1/sets/{id}/cards/{cardId}/neighbors` — the 2 previous / 2 next card ids. */\n  async neighbors(setId: string, cardId: string): Promise<CardNeighbors> {\n    const res = await this.http.get<SingleResponse<CardNeighbors>>(\n      `/v1/sets/${encodeURIComponent(setId)}/cards/${encodeURIComponent(cardId)}/neighbors`,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/sealed` — sealed products attached to a set, each with its latest price. */\n  async sealed(id: string, params?: { source?: SealedPriceSource }): Promise<SealedProduct[]> {\n    const res = await this.http.get<SingleResponse<SealedProduct[]>>(\n      `/v1/sets/${encodeURIComponent(id)}/sealed`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { RetryOptions } from './http.js';\nimport { HttpClient } from './http.js';\nimport { AuthResource } from './resources/auth.js';\nimport { CardsResource } from './resources/cards.js';\nimport { PricesResource } from './resources/prices.js';\nimport { SealedResource } from './resources/sealed.js';\nimport { SetsResource } from './resources/sets.js';\nimport type { HealthResponse, UsageResponse } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.carddex.dev';\n\nexport interface CardDexOptions {\n  /**\n   * A `pk_live_...` key from `POST /v1/auth/register`. Omit it to call the\n   * API anonymously — CardDex allows this at a lower rate (30 req/min,\n   * 5,000 req/day per IP), specifically so a browser can call it without a\n   * key. **Never ship a real API key in public frontend code**: it would be\n   * readable by anyone who opens dev tools and shared by every visitor to\n   * your site. Proxy through your own backend instead if you need the\n   * higher, keyed limits from a browser context.\n   */\n  apiKey?: string;\n  /** Defaults to `https://api.carddex.dev`. Override for a local/staging API or a CORS proxy. */\n  baseUrl?: string;\n  /** Defaults to the global `fetch`. Override to inject a custom implementation (proxies, logging, tests). */\n  fetch?: typeof fetch;\n  /**\n   * Automatic retry on `429`, honouring `Retry-After`. **Off by default.**\n   * Pass `true` for the defaults (up to 2 retries, never waiting more than\n   * 60s), or an object to tune them. A `Retry-After` longer than\n   * `maxWaitSeconds` — typically the daily-quota reset, which can be most of\n   * a day away — is never honoured; the request fails immediately instead.\n   */\n  retry?: boolean | RetryOptions;\n}\n\nfunction isBrowserLike(): boolean {\n  return (\n    typeof window !== 'undefined' &&\n    typeof (window as { document?: unknown }).document !== 'undefined'\n  );\n}\n\n/**\n * CardDex API client.\n *\n * ```ts\n * import { CardDex } from '@carddex/sdk';\n *\n * const client = new CardDex({ apiKey: process.env.CARDDEX_API_KEY });\n * const { data } = await client.cards.list({ name: 'Charizard' });\n * ```\n */\nexport class CardDex {\n  readonly cards: CardsResource;\n  readonly sets: SetsResource;\n  readonly sealed: SealedResource;\n  readonly prices: PricesResource;\n  readonly auth: AuthResource;\n\n  private readonly http: HttpClient;\n\n  constructor(options: CardDexOptions = {}) {\n    if (options.apiKey && isBrowserLike()) {\n      // biome-ignore lint/suspicious/noConsole: deliberate one-time safety warning, not app logging\n      console.warn(\n        '[@carddex/sdk] An apiKey was passed in what looks like a browser environment. ' +\n          'API keys shipped in frontend code are visible to every visitor. Omit apiKey for ' +\n          \"CardDex's anonymous browser mode, or proxy authenticated requests through your own backend.\",\n      );\n    }\n\n    const fetchImpl = options.fetch ?? globalThis.fetch;\n    if (!fetchImpl) {\n      throw new Error(\n        '@carddex/sdk requires a global fetch implementation. On Node < 18, pass one via `fetch` in the options.',\n      );\n    }\n\n    this.http = new HttpClient({\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: options.apiKey,\n      fetch: fetchImpl.bind(globalThis),\n      retry: options.retry,\n    });\n\n    this.cards = new CardsResource(this.http);\n    this.sets = new SetsResource(this.http);\n    this.sealed = new SealedResource(this.http);\n    this.prices = new PricesResource(this.http);\n    this.auth = new AuthResource(this.http);\n  }\n\n  /** `GET /v1/auth/usage` — shorthand for `client.auth.usage()`. Requires an `apiKey`. */\n  usage(): Promise<UsageResponse> {\n    return this.auth.usage();\n  }\n\n  /** `GET /v1/health` — API health, price freshness, and cron status. */\n  async health(): Promise<HealthResponse> {\n    return this.http.get<HealthResponse>('/v1/health');\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/errors.ts","../src/http.ts","../src/resources/auth.ts","../src/pagination.ts","../src/resources/cards.ts","../src/resources/prices.ts","../src/resources/sealed.ts","../src/resources/sets.ts","../src/client.ts"],"sourcesContent":["/** Rate-limit info parsed from response headers, when present. */\nexport interface RateLimitInfo {\n  /** `X-RateLimit-Limit`: requests allowed per minute. */\n  limit: number | null;\n  /** `X-RateLimit-Daily-Limit`: requests allowed per UTC day, or `null` when the tier is uncapped. */\n  dailyLimit: number | null;\n  /** `X-RateLimit-Daily-Remaining`: approximate, can lag by about a minute. `null` when the API couldn't compute it. */\n  dailyRemaining: number | null;\n}\n\nfunction parseRateLimitHeaders(headers: Headers): RateLimitInfo {\n  const num = (name: string): number | null => {\n    const raw = headers.get(name);\n    if (raw == null) return null;\n    const n = Number(raw);\n    return Number.isFinite(n) ? n : null;\n  };\n  return {\n    limit: num('X-RateLimit-Limit'),\n    dailyLimit: num('X-RateLimit-Daily-Limit'),\n    dailyRemaining: num('X-RateLimit-Daily-Remaining'),\n  };\n}\n\n/**\n * Thrown for any non-2xx response, and for network/parse failures the fetch\n * layer can't attribute to the API itself.\n */\nexport class CardDexError extends Error {\n  /** HTTP status code. `0` for a request that never got a response (network failure, abort). */\n  readonly status: number;\n  /**\n   * The API's own `error.code`. For a response the API actually produced,\n   * this is the same number as `status` (see the note on `ApiErrorBody` in\n   * `types.ts`) — kept as its own field because a transport-level failure\n   * (no response at all) sets it to a string like `NETWORK_ERROR` instead.\n   */\n  readonly code: number | string;\n  /** Seconds to wait before retrying, parsed from `Retry-After` on a 429. `null` otherwise. */\n  readonly retryAfter: number | null;\n  /** Rate-limit headers on the response, when there was one. */\n  readonly rateLimit: RateLimitInfo | null;\n\n  constructor(\n    message: string,\n    options: {\n      status: number;\n      code: number | string;\n      retryAfter?: number | null;\n      rateLimit?: RateLimitInfo | null;\n      cause?: unknown;\n    },\n  ) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = 'CardDexError';\n    this.status = options.status;\n    this.code = options.code;\n    this.retryAfter = options.retryAfter ?? null;\n    this.rateLimit = options.rateLimit ?? null;\n    Object.setPrototypeOf(this, CardDexError.prototype);\n  }\n\n  /** Whether this is a 429 (either the per-minute or the daily cap). */\n  get isRateLimited(): boolean {\n    return this.status === 429;\n  }\n\n  static async fromResponse(response: Response): Promise<CardDexError> {\n    const rateLimit = parseRateLimitHeaders(response.headers);\n    const retryAfterHeader = response.headers.get('Retry-After');\n    const retryAfter = retryAfterHeader != null ? Number(retryAfterHeader) : null;\n\n    let message = `CardDex API error (${response.status})`;\n    let code: number | string = response.status;\n    try {\n      const body = (await response.clone().json()) as {\n        error?: { code?: unknown; message?: unknown };\n      };\n      if (body?.error) {\n        if (typeof body.error.message === 'string') message = body.error.message;\n        if (typeof body.error.code === 'number' || typeof body.error.code === 'string') {\n          code = body.error.code;\n        }\n      }\n    } catch {\n      // Non-JSON or empty error body — fall back to the status-derived message above.\n    }\n\n    return new CardDexError(message, {\n      status: response.status,\n      code,\n      retryAfter: Number.isFinite(retryAfter) ? retryAfter : null,\n      rateLimit,\n    });\n  }\n\n  static network(cause: unknown): CardDexError {\n    const message = cause instanceof Error ? cause.message : 'Network request failed';\n    return new CardDexError(message, { status: 0, code: 'NETWORK_ERROR', cause });\n  }\n}\n","import { CardDexError } from './errors.js';\n\nexport type QueryValue =\n  | string\n  | number\n  | boolean\n  | undefined\n  | null\n  | readonly (string | number)[];\nexport type QueryParams = Record<string, QueryValue>;\n\nexport interface RetryOptions {\n  /** Max retry attempts on 429. Default 2. */\n  maxRetries?: number;\n  /**\n   * A computed `Retry-After` above this many seconds is never honoured — the\n   * request fails immediately instead of sleeping (this is what keeps a\n   * daily-quota 429, whose `Retry-After` can be most of a day, from blocking\n   * for hours). Default 60, matching the per-minute limiter's own\n   * `Retry-After: 60`.\n   */\n  maxWaitSeconds?: number;\n}\n\nexport interface HttpClientOptions {\n  baseUrl: string;\n  apiKey?: string;\n  fetch: typeof fetch;\n  /** `false` (default) disables retries; `true` enables them with the defaults below. */\n  retry?: boolean | RetryOptions;\n}\n\nconst DEFAULT_MAX_RETRIES = 2;\nconst DEFAULT_MAX_WAIT_SECONDS = 60;\n\nfunction buildQueryString(params?: QueryParams): string {\n  if (!params) return '';\n  const search = new URLSearchParams();\n  for (const [key, value] of Object.entries(params)) {\n    if (value === undefined || value === null) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) continue;\n      search.set(key, value.join(','));\n    } else {\n      search.set(key, String(value));\n    }\n  }\n  const qs = search.toString();\n  return qs ? `?${qs}` : '';\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\n/**\n * Minimal fetch wrapper: builds URLs, attaches auth, parses JSON, and turns\n * non-2xx responses into `CardDexError`. No dependency beyond global `fetch`.\n */\nexport class HttpClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string | undefined;\n  private readonly fetchImpl: typeof fetch;\n  private readonly retryConfig: Required<RetryOptions> | null;\n\n  constructor(options: HttpClientOptions) {\n    this.baseUrl = options.baseUrl.replace(/\\/+$/, '');\n    this.apiKey = options.apiKey;\n    this.fetchImpl = options.fetch;\n    if (options.retry === true) {\n      this.retryConfig = {\n        maxRetries: DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else if (options.retry && typeof options.retry === 'object') {\n      this.retryConfig = {\n        maxRetries: options.retry.maxRetries ?? DEFAULT_MAX_RETRIES,\n        maxWaitSeconds: options.retry.maxWaitSeconds ?? DEFAULT_MAX_WAIT_SECONDS,\n      };\n    } else {\n      this.retryConfig = null;\n    }\n  }\n\n  async get<T>(path: string, query?: QueryParams, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('GET', path, { query, signal });\n  }\n\n  async post<T>(path: string, body?: unknown, signal?: AbortSignal): Promise<T> {\n    return this.request<T>('POST', path, { body, signal });\n  }\n\n  private async request<T>(\n    method: string,\n    path: string,\n    opts: { query?: QueryParams; body?: unknown; signal?: AbortSignal },\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}${buildQueryString(opts.query)}`;\n    const headers: Record<string, string> = { Accept: 'application/json' };\n    if (this.apiKey) headers['X-API-Key'] = this.apiKey;\n    if (opts.body !== undefined) headers['Content-Type'] = 'application/json';\n\n    let attempt = 0;\n    for (;;) {\n      let response: Response;\n      try {\n        response = await this.fetchImpl(url, {\n          method,\n          headers,\n          body: opts.body !== undefined ? JSON.stringify(opts.body) : undefined,\n          signal: opts.signal,\n        });\n      } catch (cause) {\n        throw CardDexError.network(cause);\n      }\n\n      if (response.status === 429 && this.retryConfig && attempt < this.retryConfig.maxRetries) {\n        const retryAfterHeader = response.headers.get('Retry-After');\n        const retryAfterSeconds = retryAfterHeader != null ? Number(retryAfterHeader) : Number.NaN;\n        if (\n          Number.isFinite(retryAfterSeconds) &&\n          retryAfterSeconds <= this.retryConfig.maxWaitSeconds\n        ) {\n          attempt++;\n          await sleep(retryAfterSeconds * 1000);\n          continue;\n        }\n        // Retry-After is missing or longer than we're willing to wait\n        // (typically the daily cap, which resets at UTC midnight) — surface\n        // the error instead of blocking.\n      }\n\n      if (!response.ok) {\n        throw await CardDexError.fromResponse(response);\n      }\n\n      if (response.status === 204) return undefined as T;\n      return (await response.json()) as T;\n    }\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type { RegisterResponse, SingleResponse, UsageResponse } from '../types.js';\n\nexport class AuthResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `POST /v1/auth/register` — claim a free API key. The key is returned\n   * exactly once, so store it immediately. A lost key can be replaced by signing\n   * in at https://carddex.dev/account (create, rotate or revoke keys there).\n   */\n  async register(email: string, name?: string): Promise<RegisterResponse> {\n    const res = await this.http.post<SingleResponse<RegisterResponse>>('/v1/auth/register', {\n      email,\n      name,\n    });\n    return res.data;\n  }\n\n  /** `GET /v1/auth/usage` — usage stats for the API key this client was constructed with. Requires an `apiKey`. */\n  async usage(): Promise<UsageResponse> {\n    const res = await this.http.get<SingleResponse<UsageResponse>>('/v1/auth/usage');\n    return res.data;\n  }\n}\n","import type { PaginatedResponse } from './types.js';\n\n/**\n * Turns a page-fetching function into an async iterator over every item,\n * fetching the next page lazily as the caller consumes items.\n *\n * @example\n * ```ts\n * for await (const card of paginate((page) => client.cards.list({ set: 'sv06', page }))) {\n *   console.log(card.name);\n * }\n * ```\n */\nexport async function* paginate<T>(\n  fetchPage: (page: number) => Promise<PaginatedResponse<T>>,\n  startPage = 1,\n): AsyncGenerator<T, void, void> {\n  let page = startPage;\n  for (;;) {\n    const response = await fetchPage(page);\n    if (response.data.length === 0) return;\n    yield* response.data;\n    if (page >= response.meta.totalPages) return;\n    page++;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type {\n  CardGetParams,\n  CardListParams,\n  CardPriceHistoryParams,\n  CardPricesParams,\n  CatalogParams,\n} from '../params.js';\nimport type {\n  Card,\n  CardPrice,\n  CardWithRelations,\n  PaginatedResponse,\n  SingleResponse,\n} from '../types.js';\n\nexport class CardsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/cards` — list, search, filter and sort cards. */\n  list(params?: CardListParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>('/v1/cards', params);\n  }\n\n  /**\n   * Iterates every card matching `params` across all pages, fetching pages\n   * lazily as you consume them.\n   *\n   * @example\n   * ```ts\n   * for await (const card of client.cards.listAll({ set: 'sv06' })) { ... }\n   * ```\n   */\n  listAll(params?: Omit<CardListParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/cards/random` — `catalog: 'ja'` or `catalog: 'pl'` draws a card from that catalogue. */\n  async random(params?: CatalogParams): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>('/v1/cards/random', params);\n    return res.data;\n  }\n\n  /** `GET /v1/cards/rarities` — every distinct rarity of one catalogue. */\n  async rarities(params?: CatalogParams): Promise<string[]> {\n    const res = await this.http.get<SingleResponse<string[]>>('/v1/cards/rarities', params);\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}` */\n  async get(id: string, params?: CardGetParams): Promise<CardWithRelations> {\n    const res = await this.http.get<SingleResponse<CardWithRelations>>(\n      `/v1/cards/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices` — the latest price row(s) for a card. */\n  async prices(id: string, params?: CardPricesParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/cards/{id}/prices/history` — one row per day per price guide, oldest first. */\n  async priceHistory(id: string, params?: CardPriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/cards/${encodeURIComponent(id)}/prices/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport type {\n  BargainsParams,\n  BulkPricesParams,\n  PriceHistoryParams,\n  RankingParams,\n  TrendsParams,\n} from '../params.js';\nimport type { BargainCardPrice, CardPrice, SingleResponse } from '../types.js';\n\nexport class PricesResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * `GET /v1/prices` — latest price rows for up to 100 card ids (and/or up\n   * to 100 print/variant ids) in one request. Keyed by the id you asked for;\n   * an id with no price data maps to `[]`.\n   */\n  async bulk(params: BulkPricesParams): Promise<Record<string, CardPrice[]>> {\n    const res = await this.http.get<SingleResponse<Record<string, CardPrice[]>>>(\n      '/v1/prices',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/top` — highest-valued cards. */\n  async top(params?: RankingParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/top', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/trends` — biggest movers against the card's own rolling average. */\n  async trends(params?: TrendsParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>('/v1/prices/trends', params);\n    return res.data;\n  }\n\n  /** `GET /v1/prices/bargains` — cards trading below a reference price, best discount first. */\n  async bargains(params?: BargainsParams): Promise<BargainCardPrice[]> {\n    const res = await this.http.get<SingleResponse<BargainCardPrice[]>>(\n      '/v1/prices/bargains',\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/prices/{cardId}/history` — one row per day per guide, oldest first. */\n  async history(cardId: string, params?: PriceHistoryParams): Promise<CardPrice[]> {\n    const res = await this.http.get<SingleResponse<CardPrice[]>>(\n      `/v1/prices/${encodeURIComponent(cardId)}/history`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedListParams, SealedPriceHistoryParams } from '../params.js';\nimport type { PaginatedResponse, SealedPrice, SealedProduct, SingleResponse } from '../types.js';\n\nexport class SealedResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sealed` — list sealed products with their latest price. */\n  list(params?: SealedListParams): Promise<PaginatedResponse<SealedProduct>> {\n    return this.http.get<PaginatedResponse<SealedProduct>>('/v1/sealed', params);\n  }\n\n  /** Iterates every sealed product matching `params` across all pages. */\n  listAll(params?: Omit<SealedListParams, 'page'>): AsyncGenerator<SealedProduct, void, void> {\n    return paginate((page) => this.list({ ...params, page }));\n  }\n\n  /** `GET /v1/sealed/{id}` */\n  async get(id: string, params?: { source?: SealedListParams['source'] }): Promise<SealedProduct> {\n    const res = await this.http.get<SingleResponse<SealedProduct>>(\n      `/v1/sealed/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sealed/{id}/prices` — one row per synced day, oldest first. */\n  async prices(id: string, params?: SealedPriceHistoryParams): Promise<SealedPrice[]> {\n    const res = await this.http.get<SingleResponse<SealedPrice[]>>(\n      `/v1/sealed/${encodeURIComponent(id)}/prices`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { HttpClient } from '../http.js';\nimport { paginate } from '../pagination.js';\nimport type { SealedPriceSource, SetCardsParams, SetGetParams } from '../params.js';\nimport type {\n  Card,\n  CardDexSet,\n  CardNeighbors,\n  PaginatedResponse,\n  SealedProduct,\n  SingleResponse,\n} from '../types.js';\n\nexport class SetsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /** `GET /v1/sets` — every set of one catalogue (`catalog`, default `en`). `lang` adds `localized_name`. */\n  async list(params?: SetGetParams): Promise<CardDexSet[]> {\n    const res = await this.http.get<SingleResponse<CardDexSet[]>>('/v1/sets', params);\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}` — `lang` adds `localized_name`. */\n  async get(id: string, params?: SetGetParams): Promise<CardDexSet> {\n    const res = await this.http.get<SingleResponse<CardDexSet>>(\n      `/v1/sets/${encodeURIComponent(id)}`,\n      params,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/cards` */\n  cards(id: string, params?: SetCardsParams): Promise<PaginatedResponse<Card>> {\n    return this.http.get<PaginatedResponse<Card>>(\n      `/v1/sets/${encodeURIComponent(id)}/cards`,\n      params,\n    );\n  }\n\n  /** Iterates every card in a set across all pages. */\n  cardsAll(id: string, params?: Omit<SetCardsParams, 'page'>): AsyncGenerator<Card, void, void> {\n    return paginate((page) => this.cards(id, { ...params, page }));\n  }\n\n  /** `GET /v1/sets/{id}/cards/{cardId}/neighbors` — the 2 previous / 2 next card ids. */\n  async neighbors(setId: string, cardId: string): Promise<CardNeighbors> {\n    const res = await this.http.get<SingleResponse<CardNeighbors>>(\n      `/v1/sets/${encodeURIComponent(setId)}/cards/${encodeURIComponent(cardId)}/neighbors`,\n    );\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}/sealed` — sealed products attached to a set, each with its latest price. */\n  async sealed(id: string, params?: { source?: SealedPriceSource }): Promise<SealedProduct[]> {\n    const res = await this.http.get<SingleResponse<SealedProduct[]>>(\n      `/v1/sets/${encodeURIComponent(id)}/sealed`,\n      params,\n    );\n    return res.data;\n  }\n}\n","import type { RetryOptions } from './http.js';\nimport { HttpClient } from './http.js';\nimport { AuthResource } from './resources/auth.js';\nimport { CardsResource } from './resources/cards.js';\nimport { PricesResource } from './resources/prices.js';\nimport { SealedResource } from './resources/sealed.js';\nimport { SetsResource } from './resources/sets.js';\nimport type { HealthResponse, UsageResponse } from './types.js';\n\nconst DEFAULT_BASE_URL = 'https://api.carddex.dev';\n\nexport interface CardDexOptions {\n  /**\n   * A `pk_live_...` key from `POST /v1/auth/register`. Omit it to call the\n   * API anonymously — CardDex allows this at a lower rate (30 req/min,\n   * 5,000 req/day per IP), specifically so a browser can call it without a\n   * key. **Never ship a real API key in public frontend code**: it would be\n   * readable by anyone who opens dev tools and shared by every visitor to\n   * your site. Proxy through your own backend instead if you need the\n   * higher, keyed limits from a browser context.\n   */\n  apiKey?: string;\n  /** Defaults to `https://api.carddex.dev`. Override for a local/staging API or a CORS proxy. */\n  baseUrl?: string;\n  /** Defaults to the global `fetch`. Override to inject a custom implementation (proxies, logging, tests). */\n  fetch?: typeof fetch;\n  /**\n   * Automatic retry on `429`, honouring `Retry-After`. **Off by default.**\n   * Pass `true` for the defaults (up to 2 retries, never waiting more than\n   * 60s), or an object to tune them. A `Retry-After` longer than\n   * `maxWaitSeconds` — typically the daily-quota reset, which can be most of\n   * a day away — is never honoured; the request fails immediately instead.\n   */\n  retry?: boolean | RetryOptions;\n}\n\nfunction isBrowserLike(): boolean {\n  return (\n    typeof window !== 'undefined' &&\n    typeof (window as { document?: unknown }).document !== 'undefined'\n  );\n}\n\n/**\n * CardDex API client.\n *\n * ```ts\n * import { CardDex } from '@carddex/sdk';\n *\n * const client = new CardDex({ apiKey: process.env.CARDDEX_API_KEY });\n * const { data } = await client.cards.list({ name: 'Charizard' });\n * ```\n */\nexport class CardDex {\n  readonly cards: CardsResource;\n  readonly sets: SetsResource;\n  readonly sealed: SealedResource;\n  readonly prices: PricesResource;\n  readonly auth: AuthResource;\n\n  private readonly http: HttpClient;\n\n  constructor(options: CardDexOptions = {}) {\n    if (options.apiKey && isBrowserLike()) {\n      // biome-ignore lint/suspicious/noConsole: deliberate one-time safety warning, not app logging\n      console.warn(\n        '[@carddex/sdk] An apiKey was passed in what looks like a browser environment. ' +\n          'API keys shipped in frontend code are visible to every visitor. Omit apiKey for ' +\n          \"CardDex's anonymous browser mode, or proxy authenticated requests through your own backend.\",\n      );\n    }\n\n    const fetchImpl = options.fetch ?? globalThis.fetch;\n    if (!fetchImpl) {\n      throw new Error(\n        '@carddex/sdk requires a global fetch implementation. On Node < 18, pass one via `fetch` in the options.',\n      );\n    }\n\n    this.http = new HttpClient({\n      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,\n      apiKey: options.apiKey,\n      fetch: fetchImpl.bind(globalThis),\n      retry: options.retry,\n    });\n\n    this.cards = new CardsResource(this.http);\n    this.sets = new SetsResource(this.http);\n    this.sealed = new SealedResource(this.http);\n    this.prices = new PricesResource(this.http);\n    this.auth = new AuthResource(this.http);\n  }\n\n  /** `GET /v1/auth/usage` — shorthand for `client.auth.usage()`. Requires an `apiKey`. */\n  usage(): Promise<UsageResponse> {\n    return this.auth.usage();\n  }\n\n  /** `GET /v1/health` — API health, price freshness, and cron status. */\n  async health(): Promise<HealthResponse> {\n    return this.http.get<HealthResponse>('/v1/health');\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carddex/sdk",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Official TypeScript/JavaScript client for the CardDex Pokémon TCG API",
   "keywords": [
     "pokemon",