@carddex/sdk 0.1.0 → 0.2.0

package/dist/index.js

@@ -1,2 +1,421 @@
-export { CardDexClient } from './client.js';
+// src/errors.ts
+function parseRateLimitHeaders(headers) {
+  const num = (name) => {
+    const raw = headers.get(name);
+    if (raw == null) return null;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : null;
+  };
+  return {
+    limit: num("X-RateLimit-Limit"),
+    dailyLimit: num("X-RateLimit-Daily-Limit"),
+    dailyRemaining: num("X-RateLimit-Daily-Remaining")
+  };
+}
+var CardDexError = class _CardDexError extends Error {
+  /** HTTP status code. `0` for a request that never got a response (network failure, abort). */
+  status;
+  /**
+   * The API's own `error.code`. For a response the API actually produced,
+   * this is the same number as `status` (see the note on `ApiErrorBody` in
+   * `types.ts`) — kept as its own field because a transport-level failure
+   * (no response at all) sets it to a string like `NETWORK_ERROR` instead.
+   */
+  code;
+  /** Seconds to wait before retrying, parsed from `Retry-After` on a 429. `null` otherwise. */
+  retryAfter;
+  /** Rate-limit headers on the response, when there was one. */
+  rateLimit;
+  constructor(message, options) {
+    super(message, options.cause !== void 0 ? { cause: options.cause } : void 0);
+    this.name = "CardDexError";
+    this.status = options.status;
+    this.code = options.code;
+    this.retryAfter = options.retryAfter ?? null;
+    this.rateLimit = options.rateLimit ?? null;
+    Object.setPrototypeOf(this, _CardDexError.prototype);
+  }
+  /** Whether this is a 429 (either the per-minute or the daily cap). */
+  get isRateLimited() {
+    return this.status === 429;
+  }
+  static async fromResponse(response) {
+    const rateLimit = parseRateLimitHeaders(response.headers);
+    const retryAfterHeader = response.headers.get("Retry-After");
+    const retryAfter = retryAfterHeader != null ? Number(retryAfterHeader) : null;
+    let message = `CardDex API error (${response.status})`;
+    let code = response.status;
+    try {
+      const body = await response.clone().json();
+      if (body?.error) {
+        if (typeof body.error.message === "string") message = body.error.message;
+        if (typeof body.error.code === "number" || typeof body.error.code === "string") {
+          code = body.error.code;
+        }
+      }
+    } catch {
+    }
+    return new _CardDexError(message, {
+      status: response.status,
+      code,
+      retryAfter: Number.isFinite(retryAfter) ? retryAfter : null,
+      rateLimit
+    });
+  }
+  static network(cause) {
+    const message = cause instanceof Error ? cause.message : "Network request failed";
+    return new _CardDexError(message, { status: 0, code: "NETWORK_ERROR", cause });
+  }
+};
+
+// src/http.ts
+var DEFAULT_MAX_RETRIES = 2;
+var DEFAULT_MAX_WAIT_SECONDS = 60;
+function buildQueryString(params) {
+  if (!params) return "";
+  const search = new URLSearchParams();
+  for (const [key, value] of Object.entries(params)) {
+    if (value === void 0 || value === null) continue;
+    if (Array.isArray(value)) {
+      if (value.length === 0) continue;
+      search.set(key, value.join(","));
+    } else {
+      search.set(key, String(value));
+    }
+  }
+  const qs = search.toString();
+  return qs ? `?${qs}` : "";
+}
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+var HttpClient = class {
+  baseUrl;
+  apiKey;
+  fetchImpl;
+  retryConfig;
+  constructor(options) {
+    this.baseUrl = options.baseUrl.replace(/\/+$/, "");
+    this.apiKey = options.apiKey;
+    this.fetchImpl = options.fetch;
+    if (options.retry === true) {
+      this.retryConfig = {
+        maxRetries: DEFAULT_MAX_RETRIES,
+        maxWaitSeconds: DEFAULT_MAX_WAIT_SECONDS
+      };
+    } else if (options.retry && typeof options.retry === "object") {
+      this.retryConfig = {
+        maxRetries: options.retry.maxRetries ?? DEFAULT_MAX_RETRIES,
+        maxWaitSeconds: options.retry.maxWaitSeconds ?? DEFAULT_MAX_WAIT_SECONDS
+      };
+    } else {
+      this.retryConfig = null;
+    }
+  }
+  async get(path, query, signal) {
+    return this.request("GET", path, { query, signal });
+  }
+  async post(path, body, signal) {
+    return this.request("POST", path, { body, signal });
+  }
+  async request(method, path, opts) {
+    const url = `${this.baseUrl}${path}${buildQueryString(opts.query)}`;
+    const headers = { Accept: "application/json" };
+    if (this.apiKey) headers["X-API-Key"] = this.apiKey;
+    if (opts.body !== void 0) headers["Content-Type"] = "application/json";
+    let attempt = 0;
+    for (; ; ) {
+      let response;
+      try {
+        response = await this.fetchImpl(url, {
+          method,
+          headers,
+          body: opts.body !== void 0 ? JSON.stringify(opts.body) : void 0,
+          signal: opts.signal
+        });
+      } catch (cause) {
+        throw CardDexError.network(cause);
+      }
+      if (response.status === 429 && this.retryConfig && attempt < this.retryConfig.maxRetries) {
+        const retryAfterHeader = response.headers.get("Retry-After");
+        const retryAfterSeconds = retryAfterHeader != null ? Number(retryAfterHeader) : Number.NaN;
+        if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds <= this.retryConfig.maxWaitSeconds) {
+          attempt++;
+          await sleep(retryAfterSeconds * 1e3);
+          continue;
+        }
+      }
+      if (!response.ok) {
+        throw await CardDexError.fromResponse(response);
+      }
+      if (response.status === 204) return void 0;
+      return await response.json();
+    }
+  }
+};
+
+// src/resources/auth.ts
+var AuthResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * `POST /v1/auth/register` — claim a free API key. The key is returned
+   * exactly once, so store it immediately. A lost key can be replaced by signing
+   * in at https://carddex.dev/account (create, rotate or revoke keys there).
+   */
+  async register(email, name) {
+    const res = await this.http.post("/v1/auth/register", {
+      email,
+      name
+    });
+    return res.data;
+  }
+  /** `GET /v1/auth/usage` — usage stats for the API key this client was constructed with. Requires an `apiKey`. */
+  async usage() {
+    const res = await this.http.get("/v1/auth/usage");
+    return res.data;
+  }
+};
+
+// src/pagination.ts
+async function* paginate(fetchPage, startPage = 1) {
+  let page = startPage;
+  for (; ; ) {
+    const response = await fetchPage(page);
+    if (response.data.length === 0) return;
+    yield* response.data;
+    if (page >= response.meta.totalPages) return;
+    page++;
+  }
+}
+
+// src/resources/cards.ts
+var CardsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** `GET /v1/cards` — list, search, filter and sort cards. */
+  list(params) {
+    return this.http.get("/v1/cards", params);
+  }
+  /**
+   * Iterates every card matching `params` across all pages, fetching pages
+   * lazily as you consume them.
+   *
+   * @example
+   * ```ts
+   * for await (const card of client.cards.listAll({ set: 'sv06' })) { ... }
+   * ```
+   */
+  listAll(params) {
+    return paginate((page) => this.list({ ...params, page }));
+  }
+  /** `GET /v1/cards/random` */
+  async random() {
+    const res = await this.http.get("/v1/cards/random");
+    return res.data;
+  }
+  /** `GET /v1/cards/{id}` */
+  async get(id, params) {
+    const res = await this.http.get(
+      `/v1/cards/${encodeURIComponent(id)}`,
+      params
+    );
+    return res.data;
+  }
+  /** `GET /v1/cards/{id}/prices` — the latest price row(s) for a card. */
+  async prices(id, params) {
+    const res = await this.http.get(
+      `/v1/cards/${encodeURIComponent(id)}/prices`,
+      params
+    );
+    return res.data;
+  }
+  /** `GET /v1/cards/{id}/prices/history` — one row per day per price guide, oldest first. */
+  async priceHistory(id, params) {
+    const res = await this.http.get(
+      `/v1/cards/${encodeURIComponent(id)}/prices/history`,
+      params
+    );
+    return res.data;
+  }
+};
+
+// src/resources/prices.ts
+var PricesResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /**
+   * `GET /v1/prices` — latest price rows for up to 100 card ids (and/or up
+   * to 100 print/variant ids) in one request. Keyed by the id you asked for;
+   * an id with no price data maps to `[]`.
+   */
+  async bulk(params) {
+    const res = await this.http.get(
+      "/v1/prices",
+      params
+    );
+    return res.data;
+  }
+  /** `GET /v1/prices/top` — highest-valued cards. */
+  async top(params) {
+    const res = await this.http.get("/v1/prices/top", params);
+    return res.data;
+  }
+  /** `GET /v1/prices/trends` — biggest movers against the card's own rolling average. */
+  async trends(params) {
+    const res = await this.http.get("/v1/prices/trends", params);
+    return res.data;
+  }
+  /** `GET /v1/prices/bargains` — cards trading below a reference price, best discount first. */
+  async bargains(params) {
+    const res = await this.http.get(
+      "/v1/prices/bargains",
+      params
+    );
+    return res.data;
+  }
+  /** `GET /v1/prices/{cardId}/history` — one row per day per guide, oldest first. */
+  async history(cardId, params) {
+    const res = await this.http.get(
+      `/v1/prices/${encodeURIComponent(cardId)}/history`,
+      params
+    );
+    return res.data;
+  }
+};
+
+// src/resources/sealed.ts
+var SealedResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** `GET /v1/sealed` — list sealed products with their latest price. */
+  list(params) {
+    return this.http.get("/v1/sealed", params);
+  }
+  /** Iterates every sealed product matching `params` across all pages. */
+  listAll(params) {
+    return paginate((page) => this.list({ ...params, page }));
+  }
+  /** `GET /v1/sealed/{id}` */
+  async get(id, params) {
+    const res = await this.http.get(
+      `/v1/sealed/${encodeURIComponent(id)}`,
+      params
+    );
+    return res.data;
+  }
+  /** `GET /v1/sealed/{id}/prices` — one row per synced day, oldest first. */
+  async prices(id, params) {
+    const res = await this.http.get(
+      `/v1/sealed/${encodeURIComponent(id)}/prices`,
+      params
+    );
+    return res.data;
+  }
+};
+
+// src/resources/sets.ts
+var SetsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  http;
+  /** `GET /v1/sets` — every set. */
+  async list() {
+    const res = await this.http.get("/v1/sets");
+    return res.data;
+  }
+  /** `GET /v1/sets/{id}` */
+  async get(id) {
+    const res = await this.http.get(
+      `/v1/sets/${encodeURIComponent(id)}`
+    );
+    return res.data;
+  }
+  /** `GET /v1/sets/{id}/cards` */
+  cards(id, params) {
+    return this.http.get(
+      `/v1/sets/${encodeURIComponent(id)}/cards`,
+      params
+    );
+  }
+  /** Iterates every card in a set across all pages. */
+  cardsAll(id, params) {
+    return paginate((page) => this.cards(id, { ...params, page }));
+  }
+  /** `GET /v1/sets/{id}/cards/{cardId}/neighbors` — the 2 previous / 2 next card ids. */
+  async neighbors(setId, cardId) {
+    const res = await this.http.get(
+      `/v1/sets/${encodeURIComponent(setId)}/cards/${encodeURIComponent(cardId)}/neighbors`
+    );
+    return res.data;
+  }
+  /** `GET /v1/sets/{id}/sealed` — sealed products attached to a set, each with its latest price. */
+  async sealed(id, params) {
+    const res = await this.http.get(
+      `/v1/sets/${encodeURIComponent(id)}/sealed`,
+      params
+    );
+    return res.data;
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.carddex.dev";
+function isBrowserLike() {
+  return typeof window !== "undefined" && typeof window.document !== "undefined";
+}
+var CardDex = class {
+  cards;
+  sets;
+  sealed;
+  prices;
+  auth;
+  http;
+  constructor(options = {}) {
+    if (options.apiKey && isBrowserLike()) {
+      console.warn(
+        "[@carddex/sdk] An apiKey was passed in what looks like a browser environment. API keys shipped in frontend code are visible to every visitor. Omit apiKey for CardDex's anonymous browser mode, or proxy authenticated requests through your own backend."
+      );
+    }
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    if (!fetchImpl) {
+      throw new Error(
+        "@carddex/sdk requires a global fetch implementation. On Node < 18, pass one via `fetch` in the options."
+      );
+    }
+    this.http = new HttpClient({
+      baseUrl: options.baseUrl ?? DEFAULT_BASE_URL,
+      apiKey: options.apiKey,
+      fetch: fetchImpl.bind(globalThis),
+      retry: options.retry
+    });
+    this.cards = new CardsResource(this.http);
+    this.sets = new SetsResource(this.http);
+    this.sealed = new SealedResource(this.http);
+    this.prices = new PricesResource(this.http);
+    this.auth = new AuthResource(this.http);
+  }
+  /** `GET /v1/auth/usage` — shorthand for `client.auth.usage()`. Requires an `apiKey`. */
+  usage() {
+    return this.auth.usage();
+  }
+  /** `GET /v1/health` — API health, price freshness, and cron status. */
+  async health() {
+    return this.http.get("/v1/health");
+  }
+};
+export {
+  CardDex,
+  CardDexError,
+  paginate
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"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 } 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. */\n  async list(): Promise<CardDexSet[]> {\n    const res = await this.http.get<SingleResponse<CardDexSet[]>>('/v1/sets');\n    return res.data;\n  }\n\n  /** `GET /v1/sets/{id}` */\n  async get(id: string): Promise<CardDexSet> {\n    const res = await this.http.get<SingleResponse<CardDexSet>>(\n      `/v1/sets/${encodeURIComponent(id)}`,\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,24 +1,61 @@
 {
   "name": "@carddex/sdk",
-  "version": "0.1.0",
-  "description": "TypeScript SDK for the CardDex Pokémon TCG API",
+  "version": "0.2.0",
+  "description": "Official TypeScript/JavaScript client for the CardDex Pokémon TCG API",
+  "keywords": [
+    "pokemon",
+    "tcg",
+    "trading cards",
+    "api",
+    "sdk",
+    "carddex"
+  ],
+  "homepage": "https://carddex.dev/docs",
+  "bugs": {
+    "email": "api@carddex.dev",
+    "url": "https://carddex.dev/docs"
+  },
+  "license": "MIT",
+  "author": "CardDex",
   "type": "module",
-  "main": "./dist/index.js",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
   },
-  "files": ["dist"],
   "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "generate": "node scripts/generate.mjs",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome check --write .",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
-  "keywords": ["pokemon", "tcg", "api", "sdk"],
-  "license": "MIT",
+  "dependencies": {},
   "devDependencies": {
-    "typescript": "^5.7.0"
+    "openapi-typescript": "^7.9.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
   }
 }

package/dist/client.d.ts

@@ -1,85 +0,0 @@
-import type { Card, CardWithRelations, CardListParams, CardPrice, Set, CardMeta, PaginatedResponse, CardDexClientOptions, WebhookSubscription } from './types.js';
-export declare class CardDexClient {
-    private baseUrl;
-    private headers;
-    constructor(options?: CardDexClientOptions);
-    private fetch;
-    cards: {
-        list: (params?: CardListParams) => Promise<PaginatedResponse<Card>>;
-        get: (id: string, include?: CardListParams["include"]) => Promise<{
-            data: CardWithRelations;
-        }>;
-        random: () => Promise<{
-            data: CardWithRelations;
-        }>;
-        prices: (id: string, variantId?: string) => Promise<{
-            data: any[];
-        }>;
-        priceHistory: (id: string, options?: {
-            variantId?: string;
-            days?: number;
-        }) => Promise<{
-            data: any[];
-        }>;
-        rarities: () => Promise<{
-            data: string[];
-        }>;
-    };
-    sets: {
-        list: () => Promise<{
-            data: Set[];
-        }>;
-        get: (id: string) => Promise<{
-            data: Set;
-        }>;
-        cards: (id: string, params?: {
-            page?: number;
-            pageSize?: number;
-        }) => Promise<PaginatedResponse<Card>>;
-    };
-    prices: {
-        top: (limit?: number) => Promise<{
-            data: CardPrice[];
-        }>;
-        trends: (limit?: number) => Promise<{
-            data: CardPrice[];
-        }>;
-    };
-    meta: {
-        formats: () => Promise<{
-            data: {
-                id: string;
-                name: string;
-            }[];
-        }>;
-        top: (format: "standard" | "expanded" | "unlimited", limit?: number) => Promise<{
-            data: CardMeta[];
-        }>;
-    };
-    webhooks: {
-        subscribe: (url: string, events?: string[]) => Promise<{
-            data: WebhookSubscription;
-        }>;
-        list: () => Promise<{
-            data: WebhookSubscription[];
-        }>;
-        unsubscribe: (id: string) => Promise<{
-            data: {
-                message: string;
-            };
-        }>;
-    };
-    auth: {
-        register: (email: string, name?: string) => Promise<{
-            data: {
-                api_key: string;
-                tier: string;
-                rate_limit: number;
-            };
-        }>;
-        usage: () => Promise<{
-            data: any;
-        }>;
-    };
-}
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,IAAI,EAAE,iBAAiB,EAAE,cAAc,EAAE,SAAS,EAClD,GAAG,EAAE,QAAQ,EAAE,iBAAiB,EAAE,oBAAoB,EACtD,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAIpB,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,GAAE,oBAAyB;YAQhC,KAAK;IAcnB,KAAK;wBACY,cAAc,KAAQ,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;kBAqB3D,MAAM,YAAY,cAAc,CAAC,SAAS,CAAC,KAAG,OAAO,CAAC;YAAE,IAAI,EAAE,iBAAiB,CAAA;SAAE,CAAC;sBAKhF,OAAO,CAAC;YAAE,IAAI,EAAE,iBAAiB,CAAA;SAAE,CAAC;qBAGnC,MAAM,cAAc,MAAM,KAAG,OAAO,CAAC;YAAE,IAAI,EAAE,GAAG,EAAE,CAAA;SAAE,CAAC;2BAK/C,MAAM,YAAW;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,KAAQ,OAAO,CAAC;YAAE,IAAI,EAAE,GAAG,EAAE,CAAA;SAAE,CAAC;wBAO3F,OAAO,CAAC;YAAE,IAAI,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;MAEzC;IAIF,IAAI;oBACQ,OAAO,CAAC;YAAE,IAAI,EAAE,GAAG,EAAE,CAAA;SAAE,CAAC;kBAGxB,MAAM,KAAG,OAAO,CAAC;YAAE,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC;oBAG7B,MAAM,WAAU;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,KAAQ,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;MAMxG;IAIF,MAAM;iCACe,OAAO,CAAC;YAAE,IAAI,EAAE,SAAS,EAAE,CAAA;SAAE,CAAC;oCAG3B,OAAO,CAAC;YAAE,IAAI,EAAE,SAAS,EAAE,CAAA;SAAE,CAAC;MAEpD;IAIF,IAAI;uBACW,OAAO,CAAC;YAAE,IAAI,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAAE,CAAC;sBAGhD,UAAU,GAAG,UAAU,GAAG,WAAW,qBAAe,OAAO,CAAC;YAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;SAAE,CAAC;MAE/F;IAIF,QAAQ;yBACW,MAAM,WAAU,MAAM,EAAE,KAAwB,OAAO,CAAC;YAAE,IAAI,EAAE,mBAAmB,CAAA;SAAE,CAAC;oBAM7F,OAAO,CAAC;YAAE,IAAI,EAAE,mBAAmB,EAAE,CAAA;SAAE,CAAC;0BAGhC,MAAM,KAAG,OAAO,CAAC;YAAE,IAAI,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC;MAEjE;IAIF,IAAI;0BACgB,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC;YAAE,IAAI,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAC;gBAAC,UAAU,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAC;qBAMvG,OAAO,CAAC;YAAE,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC;MAEjC;CACH"}