scryfall-api 4.0.0-beta.0 → 4.0.0-beta.1

package/dist/scryfall-api.cjs

@@ -0,0 +1,488 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/scryfall-api.ts
+var scryfall_api_exports = {};
+__export(scryfall_api_exports, {
+  CardIdentifierBuilder: () => card_identifier_default,
+  Cards: () => card_default,
+  Catalogs: () => catalog_default,
+  InvalidScryfallArgumentError: () => InvalidScryfallArgumentError,
+  MagicPageResult: () => MagicPageResult,
+  Rulings: () => ruling_default,
+  ScryfallError: () => ScryfallError,
+  Sets: () => set_default,
+  SymbologyApi: () => symbology_default,
+  UnknownScryfallError: () => UnknownScryfallError
+});
+module.exports = __toCommonJS(scryfall_api_exports);
+
+// src/error/invalid.error.ts
+var InvalidScryfallArgumentError = class extends Error {
+};
+
+// src/error/scryfall.error.ts
+var ScryfallError = class extends Error {
+  constructor(code, details, status, type, warnings) {
+    super(details);
+    this.code = code;
+    this.status = status;
+    this.type = type;
+    this.warnings = warnings;
+  }
+};
+
+// src/error/unknown.error.ts
+var UnknownScryfallError = class extends Error {
+};
+
+// src/fetcher/debounce.fetcher.ts
+var lastQuery = 100;
+var rateLimit = 100;
+async function sleep(ms = 0) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+async function debounce() {
+  const now = Date.now();
+  const timeSinceLastQuery = now - lastQuery;
+  if (timeSinceLastQuery >= rateLimit) {
+    lastQuery = now;
+  } else {
+    const timeUntilNextQuery = rateLimit - timeSinceLastQuery;
+    lastQuery += timeUntilNextQuery;
+    await sleep(timeUntilNextQuery);
+  }
+}
+function createDebounceFetcher(fetcher2 = fetch) {
+  return async function debounceFetcher(...args) {
+    await debounce();
+    return fetcher2(...args);
+  };
+}
+
+// src/fetcher/page.result.ts
+var MagicPageResult = class {
+  constructor(apiPath, query) {
+    this.apiPath = apiPath;
+    this.query = query;
+    this.#hasMore = true;
+    this.#count = 0;
+  }
+  #count;
+  #hasMore;
+  get count() {
+    return this.#count;
+  }
+  get hasMore() {
+    return this.#hasMore;
+  }
+  async all() {
+    const r = [];
+    while (this.#hasMore) {
+      const result = await this.next();
+      r.push(...result);
+    }
+    return r;
+  }
+  async get(limit) {
+    const r = [];
+    while (this.#hasMore) {
+      const result = await this.next();
+      r.push(...result);
+      if (r.length === limit) {
+        return r;
+      }
+      if (r.length > limit) {
+        return r.slice(0, limit);
+      }
+    }
+    return r;
+  }
+  async next() {
+    const results = await fetcher(this.apiPath, this.query);
+    this.#hasMore = results?.has_more ?? false;
+    this.#count = Number.parseInt(`${results?.total_cards ?? 0}`, 10);
+    if (this.#hasMore) {
+      this.setNextPage();
+    }
+    return results?.data ?? [];
+  }
+  async page(page) {
+    this.query.page = page;
+    return this.next();
+  }
+  setNextPage() {
+    this.query.page += 1;
+  }
+};
+
+// src/fetcher/retry.fetcher.ts
+var defaultCanRetry = async (response) => {
+  const object = await response.json();
+  const status = "status" in object ? Number(object.status) : void 0;
+  if (status && status >= 500) {
+    return true;
+  }
+  const code = "code" in object && typeof object.code === "string" ? object.code : void 0;
+  return code !== "not_found" && code !== "bad_request";
+};
+function createRetryFetcher({ maxAttempts = 3, canRetry = defaultCanRetry } = {}, fetcher2 = fetch) {
+  let retries = 0;
+  return async function retryFetcher(...args) {
+    retries++;
+    const response = await fetcher2(...args);
+    if (response.ok) {
+      return response;
+    }
+    const object = await response.json();
+    const code = "code" in object && typeof object.code === "string" ? object.code : void 0;
+    const status = "status" in object ? Number(object.status) : void 0;
+    const details = "details" in object && typeof object.details === "string" ? object.details : void 0;
+    const type = "type" in object && typeof object.type === "string" ? object.type : void 0;
+    const warnings = "warnings" in object && Array.isArray(object.warnings) ? object.warnings : void 0;
+    if (retries >= maxAttempts) {
+      if (code && details && status) {
+        throw new ScryfallError(code, details, status, type, warnings);
+      }
+      throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+    }
+    if (canRetry(response)) {
+      return retryFetcher(...args);
+    }
+    if (code && details && status) {
+      throw new ScryfallError(code, details, status, type, warnings);
+    }
+    throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+  };
+}
+
+// src/fetcher/index.ts
+var simpleFetcher = createDebounceFetcher(createRetryFetcher());
+var endpoint = "https://api.scryfall.com";
+var DATE_REGEXP = /^\d{4}-\d{2}-\d{2}?$/;
+var dateParser = (_key, value) => {
+  if (typeof value === "string") {
+    if (DATE_REGEXP.test(value)) {
+      return new Date(value);
+    }
+  }
+  return value;
+};
+async function fetcher(apiPath, params, body) {
+  let path = "";
+  if (typeof apiPath === "number" || typeof apiPath === "string") {
+    path = apiPath;
+  } else if (apiPath) {
+    path = apiPath.join("/");
+  }
+  const url = new URL(`${endpoint}/${path}`);
+  if (params) {
+    Object.entries(params).forEach(([key, value]) => {
+      if (value !== void 0) {
+        url.searchParams.append(key, `${value}`);
+      }
+    });
+  }
+  try {
+    const init = {
+      method: body ? "POST" : "GET"
+    };
+    if (body) {
+      init.body = JSON.stringify(body);
+      init.headers = {
+        "Content-Type": "application/json"
+      };
+    }
+    const response = await simpleFetcher(url, init);
+    const content = await response.text();
+    return JSON.parse(content, dateParser);
+  } catch (e) {
+    if (e instanceof ScryfallError) {
+      if (e.warnings) {
+        console.warn(e.warnings);
+      }
+      if (e.code === "not_found" || e.code === "bad_request") {
+        return void 0;
+      }
+    }
+    throw e;
+  }
+}
+
+// src/api/card/card.api.ts
+var CardApi = class {
+  /*
+   * Returns up to 20 full English card names that could be autocompletions of the given string parameter.
+   * @param {string} name
+   * 	The string to search for
+   * @returns {Promise<string[]>}
+   * 	A list of up to 20 full English card names.
+   */
+  async autoCompleteName(name) {
+    const result = await fetcher("cards/autocomplete", {
+      q: name
+    });
+    return result?.data ?? [];
+  }
+  /*
+   * Returns a single card with the given Magic: The Gathering Arena ID.
+   * @param {number} id
+   * 	The Magic: The Gathering Arena ID of the card to retrieve.
+   * @returns {Promise<Card | undefined>}
+   * 	Returns a single card or undefined if no card is found.
+   */
+  async byArenaId(id) {
+    return fetcher(["cards/arena", id]);
+  }
+  /*
+   * Returns a single card with the given Scryfall ID.
+   * @param {number} id
+   * 	The Scryfall ID.
+   * @returns {Promise<Card | undefined>}
+   * 	Returns a single card or undefined if no card is found.
+   */
+  async byId(id) {
+    return fetcher(["cards", id]);
+  }
+  async byMtgoId(id) {
+    return fetcher(["cards/mtgo", id]);
+  }
+  async byMultiverseId(id) {
+    return fetcher(["cards/multiverse", id]);
+  }
+  async byName(name, set2, fuzzy = false) {
+    let f = fuzzy;
+    let s = set2;
+    if (typeof set2 === "boolean") {
+      f = set2;
+      s = void 0;
+    }
+    return fetcher("cards/named", {
+      [f ? "fuzzy" : "exact"]: name,
+      set: s
+    });
+  }
+  async bySet(setCode, collectorNumber, lang) {
+    const path = ["cards", setCode, collectorNumber];
+    if (lang) {
+      path.push(lang);
+    }
+    return fetcher(path);
+  }
+  async byTcgPlayerId(id) {
+    return fetcher(["cards/tcgplayer", id]);
+  }
+  async collection(...identifiers) {
+    const cards2 = [];
+    for (let i = 0; i < identifiers.length; i += 75) {
+      const collectionSection = { identifiers: identifiers.slice(i, i + 75) };
+      const result = await fetcher(
+        "cards/collection",
+        void 0,
+        collectionSection
+      );
+      cards2.push(...result?.data ?? []);
+    }
+    return cards2;
+  }
+  async random() {
+    return fetcher("cards/random");
+  }
+  search(query, options) {
+    return new MagicPageResult("cards/search", {
+      q: query,
+      ...typeof options === "number" ? { page: options } : { ...options, page: options?.page ?? 1 }
+    });
+  }
+};
+var cards = new CardApi();
+var card_api_default = cards;
+
+// src/api/card/index.ts
+var card_default = card_api_default;
+
+// src/api/card-identifier/card-identifier.api.ts
+var CardIdentifierApi = class {
+  static byId(id) {
+    return { id };
+  }
+  static byIllustrationId(id) {
+    return { illustration_id: id };
+  }
+  static byMtgoId(id) {
+    return { mtgo_id: id };
+  }
+  static byMultiverseId(id) {
+    return { multiverse_id: id };
+  }
+  static byName(name, set2) {
+    if (set2) {
+      return { name, set: set2 };
+    }
+    return { name };
+  }
+  static byOracleId(id) {
+    return { oracle_id: id };
+  }
+  static bySet(set2, collectorNumber) {
+    return { collector_number: `${collectorNumber}`, set: set2 };
+  }
+};
+
+// src/api/card-identifier/index.ts
+var card_identifier_default = CardIdentifierApi;
+
+// src/api/catalog/catalog.api.ts
+var CatalogApi = class {
+  async artifactTypes() {
+    return (await fetcher("catalog/artifact-types"))?.data ?? [];
+  }
+  async artistNames() {
+    return (await fetcher("catalog/artist-names"))?.data ?? [];
+  }
+  async cardNames() {
+    return (await fetcher("catalog/card-names"))?.data ?? [];
+  }
+  async creatureTypes() {
+    return (await fetcher("catalog/creature-types"))?.data ?? [];
+  }
+  async enchantmentTypes() {
+    return (await fetcher("catalog/enchantment-types"))?.data ?? [];
+  }
+  async landTypes() {
+    return (await fetcher("catalog/land-types"))?.data ?? [];
+  }
+  async loyalties() {
+    return (await fetcher("catalog/loyalties"))?.data ?? [];
+  }
+  async planeswalkerTypes() {
+    return (await fetcher("catalog/planeswalker-types"))?.data ?? [];
+  }
+  async powers() {
+    return (await fetcher("catalog/powers"))?.data ?? [];
+  }
+  async spellTypes() {
+    return (await fetcher("catalog/spell-types"))?.data ?? [];
+  }
+  async toughnesses() {
+    return (await fetcher("catalog/toughnesses"))?.data ?? [];
+  }
+  async watermarks() {
+    return (await fetcher("catalog/watermarks"))?.data ?? [];
+  }
+  async wordBank() {
+    return (await fetcher("catalog/word-bank"))?.data ?? [];
+  }
+};
+var catalog = new CatalogApi();
+var catalog_api_default = catalog;
+
+// src/api/catalog/index.ts
+var catalog_default = catalog_api_default;
+
+// src/api/ruling/ruling.api.ts
+var RulingApi = class {
+  async byArenaId(id) {
+    return (await fetcher(["cards/arena", id, "rulings"]))?.data ?? [];
+  }
+  async byId(id) {
+    return (await fetcher(["cards", id, "rulings"]))?.data ?? [];
+  }
+  async byMtgoId(id) {
+    return (await fetcher(["cards/mtgo", id, "rulings"]))?.data ?? [];
+  }
+  async byMultiverseId(id) {
+    return (await fetcher(["cards/multiverse", id, "rulings"]))?.data ?? [];
+  }
+  async bySet(setCode, collectorNumber) {
+    return (await fetcher(["cards", setCode, `${collectorNumber}`, "rulings"]))?.data ?? [];
+  }
+};
+var rulings = new RulingApi();
+var ruling_api_default = rulings;
+
+// src/api/ruling/index.ts
+var ruling_default = ruling_api_default;
+
+// src/api/set/set.api.ts
+var SetApi = class {
+  async all() {
+    const result = await fetcher("sets");
+    return result?.data ?? [];
+  }
+  async byCode(code) {
+    return await fetcher(["sets", code]);
+  }
+  async byId(id) {
+    return fetcher(["sets", id]);
+  }
+  async byTcgPlayerId(id) {
+    return fetcher(["sets/tcgplayer", id]);
+  }
+};
+var set = new SetApi();
+var set_api_default = set;
+
+// src/api/set/index.ts
+var set_default = set_api_default;
+
+// src/api/symbology/symbology.api.ts
+var SymbologyApi = class {
+  async all() {
+    const list = await fetcher("symbology");
+    return list?.data ?? [];
+  }
+  async parseMana(shorthand) {
+    if (!shorthand || typeof shorthand !== "string") {
+      throw new InvalidScryfallArgumentError("shorthand must be a string");
+    }
+    const cost = await fetcher("symbology/parse-mana", {
+      cost: shorthand
+    });
+    return cost ?? {
+      cost: "",
+      colors: [],
+      cmc: 0,
+      colorless: false,
+      monocolored: false,
+      multicolored: false,
+      object: "mana_cost"
+    };
+  }
+};
+var symbology = new SymbologyApi();
+var symbology_api_default = symbology;
+
+// src/api/symbology/index.ts
+var symbology_default = symbology_api_default;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CardIdentifierBuilder,
+  Cards,
+  Catalogs,
+  InvalidScryfallArgumentError,
+  MagicPageResult,
+  Rulings,
+  ScryfallError,
+  Sets,
+  SymbologyApi,
+  UnknownScryfallError
+});

package/dist/scryfall-api.d.ts

@@ -0,0 +1,424 @@
+/**
+ * Type definition for Nullable.
+ * @type {T | null | undefined} The type can be T, null, or undefined.
+ * @template T The type of the value that can be null or undefined.
+ */
+type Nullable<T> = T | null | undefined;
+
+type QueryValue = boolean | number | string | undefined;
+interface PageQuery {
+    [key: string]: QueryValue;
+    page: number;
+}
+declare class MagicPageResult<T> {
+    #private;
+    private readonly apiPath;
+    private readonly query;
+    constructor(apiPath: string, query: PageQuery);
+    get count(): number;
+    get hasMore(): boolean;
+    all(): Promise<T[]>;
+    get(limit: number): Promise<T[]>;
+    next(): Promise<T[]>;
+    page(page: number): Promise<T[]>;
+    private setNextPage;
+}
+
+interface CardIdentifierId {
+    id: string;
+}
+interface CardIdentifierIllustrationId {
+    illustration_id: string;
+}
+interface CardIdentifierMtgGoId {
+    mtgo_id: number;
+}
+interface CardIdentifierMultiverseId {
+    multiverse_id: number;
+}
+interface CardIdentifierNameSet {
+    name: string;
+    set?: string;
+}
+interface CardIdentifierOracleId {
+    oracle_id: string;
+}
+interface CardIdentifierCollectorSet {
+    collector_number: string;
+    set: string;
+}
+type CardIdentifier = CardIdentifierId | CardIdentifierIllustrationId | CardIdentifierMtgGoId | CardIdentifierMultiverseId | CardIdentifierNameSet | CardIdentifierOracleId | CardIdentifierCollectorSet;
+
+declare class CardIdentifierApi {
+    static byId(id: string): CardIdentifier;
+    static byIllustrationId(id: string): CardIdentifier;
+    static byMtgoId(id: number): CardIdentifier;
+    static byMultiverseId(id: number): CardIdentifier;
+    static byName(name: string, set?: string): CardIdentifier;
+    static byOracleId(id: string): CardIdentifier;
+    static bySet(set: string, collectorNumber: number | string): CardIdentifier;
+}
+
+type CardLanguage = 'en' | 'es' | 'fr' | 'de' | 'it' | 'pt' | 'ja' | 'ko' | 'ru' | 'zhs' | 'zht' | 'he' | 'la' | 'grc' | 'ar' | 'sa' | 'ph';
+type CardLayout = 'normal' | 'split' | 'flip' | 'transform' | 'modal_dfc' | 'meld' | 'leveler' | 'class' | 'case' | 'saga' | 'adventure' | 'mutate' | 'prototype' | 'battle' | 'planar' | 'scheme' | 'vanguard' | 'token' | 'double_faced_token' | 'emblem' | 'augment' | 'host' | 'art_series' | 'reversible_card';
+interface CardCore {
+    arena_id?: Nullable<string>;
+    cardmarket_id?: Nullable<number>;
+    id: string;
+    lang: CardLanguage;
+    layout: CardLayout;
+    mtgo_foil_id?: Nullable<number>;
+    mtgo_id?: Nullable<number>;
+    multiverse_ids?: Nullable<number[]>;
+    object: 'card';
+    oracle_id?: Nullable<string>;
+    prints_search_uri: string;
+    rulings_uri: string;
+    scryfall_uri: string;
+    tcgplayer_etched_id?: Nullable<number>;
+    tcgplayer_id?: Nullable<number>;
+    uri: string;
+}
+
+type Color = 'W' | 'B' | 'R' | 'U' | 'G';
+interface ManaCost {
+    cmc: number;
+    colorless: boolean;
+    colors: Color[];
+    cost: string;
+    monocolored: boolean;
+    multicolored: boolean;
+    object: 'mana_cost';
+}
+interface Symbology {
+    appears_in_mana_costs: boolean;
+    colors: Color[];
+    english: string;
+    funny: boolean;
+    gatherer_alternates?: Nullable<string[]>;
+    hybrid: boolean;
+    loose_variant?: Nullable<string>;
+    mana_value?: Nullable<number>;
+    object: 'card_symbol';
+    phyrexian: boolean;
+    represents_mana: boolean;
+    svg_uri?: Nullable<string>;
+    symbol: string;
+    transposable: boolean;
+}
+
+declare class SymbologyApi {
+    all(): Promise<Symbology[]>;
+    parseMana(shorthand: string): Promise<ManaCost>;
+}
+declare const symbology: SymbologyApi;
+
+type CardComponent = 'token' | 'meld_part' | 'meld_result' | 'combo_piece';
+type Legality = 'legal' | 'not_legal' | 'restricted' | 'banned';
+interface ImageUris$1 {
+    art_crop: string;
+    border_crop: string;
+    large: string;
+    normal: string;
+    png: string;
+    small: string;
+}
+interface CardFace {
+    artist?: Nullable<string>;
+    artist_id?: Nullable<string>;
+    cmc?: Nullable<number>;
+    color_indicator?: Nullable<Color[]>;
+    colors?: Nullable<Color[]>;
+    defense?: Nullable<string>;
+    flavor_text?: Nullable<string>;
+    illustration_id?: Nullable<string>;
+    image_uris?: Nullable<ImageUris$1>;
+    layout?: Nullable<string>;
+    loyalty?: Nullable<string>;
+    mana_cost: string;
+    name: string;
+    object: 'card_face';
+    oracle_id?: Nullable<string>;
+    oracle_text?: Nullable<string>;
+    power?: Nullable<string>;
+    printed_name?: Nullable<string>;
+    printed_text?: Nullable<string>;
+    printed_type_line?: Nullable<string>;
+    toughness?: Nullable<string>;
+    type_line?: Nullable<string>;
+    watermark?: Nullable<string>;
+}
+interface RelatedCard {
+    component: CardComponent;
+    id: string;
+    name: string;
+    object: 'related_card';
+    type_line: string;
+    uri: string;
+}
+interface Legalities {
+    alchemy: Legality;
+    brawl: Legality;
+    commander: Legality;
+    duel: Legality;
+    explorer: Legality;
+    future: Legality;
+    gladiator: Legality;
+    historic: Legality;
+    legacy: Legality;
+    modern: Legality;
+    oathbreaker: Legality;
+    oldschool: Legality;
+    pauper: Legality;
+    paupercommander: Legality;
+    penny: Legality;
+    pioneer: Legality;
+    predh: Legality;
+    premodern: Legality;
+    standard: Legality;
+    standardbrawl: Legality;
+    timeless: Legality;
+    vintage: Legality;
+}
+interface GameplayCard {
+    all_parts?: Nullable<RelatedCard[]>;
+    card_faces?: Nullable<CardFace[]>;
+    cmc: number;
+    color_identity: Color[];
+    color_indicator?: Nullable<Color[]>;
+    colors?: Nullable<Color[]>;
+    defense?: Nullable<string>;
+    edhrec_rank?: Nullable<number>;
+    hand_modifier?: Nullable<string>;
+    keywords: string[];
+    legalities: Legalities;
+    life_modifier?: Nullable<string>;
+    loyalty?: Nullable<string>;
+    mana_cost?: Nullable<string>;
+    name: string;
+    oracle_text?: Nullable<string>;
+    penny_rank?: Nullable<number>;
+    power?: Nullable<string>;
+    produced_mana?: Nullable<Color[]>;
+    reserved: boolean;
+    toughness?: Nullable<string>;
+    type_line: string;
+}
+
+type SetType = 'core' | 'expansion' | 'masters' | 'alchemy' | 'masterpiece' | 'arsenal' | 'from_the_vault' | 'spellbook' | 'premium_deck' | 'duel_deck' | 'draft_innovation' | 'treasure_chest' | 'commander' | 'planechase' | 'archenemy' | 'vanguard' | 'funny' | 'starter' | 'box' | 'promo' | 'token' | 'memorabilia' | 'minigame';
+interface Set {
+    arena_code?: Nullable<string>;
+    block?: Nullable<string>;
+    block_code?: Nullable<string>;
+    card_count: number;
+    code: string;
+    digital: boolean;
+    foil_only: boolean;
+    icon_svg_uri: string;
+    id: string;
+    mtgo_code?: Nullable<string>;
+    name: string;
+    nonfoil_only: boolean;
+    object: 'set';
+    parent_set_code?: Nullable<string>;
+    printed_size?: Nullable<number>;
+    released_at?: Nullable<Date>;
+    scryfall_uri: string;
+    search_uri: string;
+    set_type: SetType;
+    tcgplayer_id?: Nullable<number>;
+    uri: string;
+}
+
+declare class SetApi {
+    all(): Promise<Set[]>;
+    byCode(code: string): Promise<Set | undefined>;
+    byId(id: string): Promise<Set | undefined>;
+    byTcgPlayerId(id: number): Promise<Set | undefined>;
+}
+declare const set: SetApi;
+
+type BorderColor = 'black' | 'borderless' | 'gold' | 'silver' | 'white';
+type Finish = 'foil' | 'nonfoil' | 'etched';
+type Frame = '1993' | '1997' | '2003' | '2015' | 'future';
+type FrameEffect = 'legendary' | 'miracle' | 'nyxtouched' | 'draft' | 'devoid' | 'tombstone' | 'colorshifted' | 'inverted' | 'sunmoondfc' | 'compasslanddfc' | 'originpwdfc' | 'mooneldrazidfc' | 'waxingandwaningmoondfc' | 'showcase' | 'extendedart' | 'companion' | 'etched' | 'snow' | 'lesson' | 'shatteredglass' | 'convertdfc' | 'fandfc' | 'upsidedowndfc';
+type Game = 'paper' | 'arena' | 'mtgo';
+type ImageStatus = 'missing' | 'placeholder' | 'lowres' | 'highres_scan';
+interface ImageUris {
+    art_crop: string;
+    border_crop: string;
+    large: string;
+    normal: string;
+    png: string;
+    small: string;
+}
+interface Preview {
+    previewed_at: Date;
+    source: string;
+    source_uri: string;
+}
+interface Prices {
+    eur?: Nullable<string>;
+    eur_foil?: Nullable<string>;
+    tix?: Nullable<string>;
+    usd?: Nullable<string>;
+    usd_etched?: Nullable<string>;
+    usd_foil?: Nullable<string>;
+}
+type PromoType = 'ourney' | 'prerelease' | 'datestamped' | 'planeswalkerdeck' | 'buyabox' | 'judgegift' | 'event' | 'convention' | 'starterdeck' | 'instore' | 'setpromo' | 'fnm' | 'openhouse' | 'league' | 'draftweekend' | 'gameday' | 'release' | 'intropack' | 'giftbox' | 'duels' | 'wizardsplaynetwork' | 'premiereshop' | 'playerrewards' | 'gateway' | 'arenaleague';
+interface PurchaseUris {
+    [key: string]: Nullable<string>;
+    cardhoarder?: Nullable<string>;
+    cardmarket?: Nullable<string>;
+    tcgplayer?: Nullable<string>;
+}
+type Rarity = 'common' | 'uncommon' | 'rare' | 'special' | 'mythic' | 'bonus';
+interface RelatedUris {
+    [key: string]: Nullable<string>;
+    edhrec?: Nullable<string>;
+    gatherer?: Nullable<string>;
+    mtgtop8?: Nullable<string>;
+    tcgplayer_decks?: Nullable<string>;
+    tcgplayer_infinite_articles?: Nullable<string>;
+    tcgplayer_infinite_decks?: Nullable<string>;
+}
+type SecurityStamp = 'oval' | 'triangle' | 'acorn' | 'circle' | 'arena' | 'heart';
+interface CardPrint {
+    artist?: Nullable<string>;
+    artist_ids?: Nullable<string[]>;
+    attraction_lights?: Nullable<number[]>;
+    booster: boolean;
+    border_color: BorderColor;
+    card_back_id: string;
+    collector_number: string;
+    content_warning?: Nullable<boolean>;
+    digital: boolean;
+    finishes: Finish[];
+    flavor_name?: Nullable<string>;
+    flavor_text?: Nullable<string>;
+    frame: Frame;
+    frame_effects?: Nullable<FrameEffect[]>;
+    full_art: boolean;
+    games: Game[];
+    highres_image: boolean;
+    illustration_id?: Nullable<string>;
+    image_status: ImageStatus;
+    image_uris?: Nullable<ImageUris>;
+    oversized: boolean;
+    preview: Preview;
+    prices: Prices;
+    printed_name?: Nullable<string>;
+    printed_text?: Nullable<string>;
+    printed_type_line?: Nullable<string>;
+    promo: boolean;
+    promo_types?: Nullable<PromoType[]>;
+    purchase_uris?: Nullable<PurchaseUris>;
+    rarity: Rarity;
+    related_uris: RelatedUris;
+    released_at: Date;
+    reprint: boolean;
+    scryfall_set_uri: string;
+    security_stamp?: Nullable<SecurityStamp>;
+    set: string;
+    set_id: string;
+    set_name: string;
+    set_search_uri: string;
+    set_type: SetType;
+    set_uri: string;
+    story_spotlight: boolean;
+    textless: boolean;
+    variation: boolean;
+    variation_of?: Nullable<string>;
+    watermark?: Nullable<string>;
+}
+
+type Card = CardCore & GameplayCard & CardPrint;
+
+type CardSearchUnique = 'cards' | 'art' | 'prints';
+type CardSearchOrder = 'name' | 'set' | 'released' | 'rarity' | 'color' | 'usd' | 'tix' | 'eur' | 'cmc' | 'power' | 'toughness' | 'edhrec' | 'penny' | 'artist' | 'review';
+type CardSearchDir = 'auto' | 'asc' | 'desc';
+type CardSearchFormat = 'json' | 'csv';
+interface CardSearch {
+    dir?: CardSearchDir;
+    format?: CardSearchFormat;
+    include_extras?: boolean;
+    include_multilingual?: boolean;
+    include_variations?: boolean;
+    order?: CardSearchOrder;
+    page?: number;
+    pretty?: boolean;
+    unique?: CardSearchUnique;
+}
+
+declare class CardApi {
+    autoCompleteName(name: string): Promise<string[]>;
+    byArenaId(id: number): Promise<Card | undefined>;
+    byId(id: string): Promise<Card | undefined>;
+    byMtgoId(id: number): Promise<Card | undefined>;
+    byMultiverseId(id: number): Promise<Card | undefined>;
+    byName(name: string, fuzzy?: boolean): Promise<Card | undefined>;
+    byName(name: string, set?: string, fuzzy?: boolean): Promise<Card | undefined>;
+    bySet(setCode: string, collectorNumber: number, lang?: string): Promise<Card | undefined>;
+    byTcgPlayerId(id: number): Promise<Card | undefined>;
+    collection(...identifiers: CardIdentifier[]): Promise<Card[]>;
+    random(): Promise<Card | undefined>;
+    search(query: string, options?: CardSearch | number): MagicPageResult<Card>;
+}
+declare const cards: CardApi;
+
+declare class CatalogApi {
+    artifactTypes(): Promise<string[]>;
+    artistNames(): Promise<string[]>;
+    cardNames(): Promise<string[]>;
+    creatureTypes(): Promise<string[]>;
+    enchantmentTypes(): Promise<string[]>;
+    landTypes(): Promise<string[]>;
+    loyalties(): Promise<string[]>;
+    planeswalkerTypes(): Promise<string[]>;
+    powers(): Promise<string[]>;
+    spellTypes(): Promise<string[]>;
+    toughnesses(): Promise<string[]>;
+    watermarks(): Promise<string[]>;
+    wordBank(): Promise<string[]>;
+}
+declare const catalog: CatalogApi;
+
+interface Catalog {
+    data: string[];
+    object: 'catalog';
+    total_values: number;
+    uri: string;
+}
+
+interface Ruling {
+    comment: string;
+    object: 'ruling';
+    oracle_id: string;
+    published_at: Date;
+    source: string;
+}
+
+declare class RulingApi {
+    byArenaId(id: number): Promise<Ruling[]>;
+    byId(id: string): Promise<Ruling[]>;
+    byMtgoId(id: number): Promise<Ruling[]>;
+    byMultiverseId(id: number): Promise<Ruling[]>;
+    bySet(setCode: string, collectorNumber: number | string): Promise<Ruling[]>;
+}
+declare const rulings: RulingApi;
+
+declare class InvalidScryfallArgumentError extends Error {
+}
+
+declare class ScryfallError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly type?: string | null | undefined;
+    readonly warnings?: string[] | null | undefined;
+    constructor(code: string, details: string, status: number, type?: string | null | undefined, warnings?: string[] | null | undefined);
+}
+
+declare class UnknownScryfallError extends Error {
+}
+
+export { type Card, type CardIdentifier, CardIdentifierApi as CardIdentifierBuilder, type CardIdentifierCollectorSet, type CardIdentifierId, type CardIdentifierIllustrationId, type CardIdentifierMtgGoId, type CardIdentifierMultiverseId, type CardIdentifierNameSet, type CardIdentifierOracleId, type CardSearch, type CardSearchDir, type CardSearchFormat, type CardSearchOrder, type CardSearchUnique, cards as Cards, type Catalog, catalog as Catalogs, type Color, InvalidScryfallArgumentError, MagicPageResult, type ManaCost, type Ruling, rulings as Rulings, ScryfallError, type Set, type SetType, set as Sets, type Symbology, symbology as SymbologyApi, UnknownScryfallError };

package/dist/scryfall-api.js

@@ -0,0 +1,452 @@
+// src/error/invalid.error.ts
+var InvalidScryfallArgumentError = class extends Error {
+};
+
+// src/error/scryfall.error.ts
+var ScryfallError = class extends Error {
+  constructor(code, details, status, type, warnings) {
+    super(details);
+    this.code = code;
+    this.status = status;
+    this.type = type;
+    this.warnings = warnings;
+  }
+};
+
+// src/error/unknown.error.ts
+var UnknownScryfallError = class extends Error {
+};
+
+// src/fetcher/debounce.fetcher.ts
+var lastQuery = 100;
+var rateLimit = 100;
+async function sleep(ms = 0) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+async function debounce() {
+  const now = Date.now();
+  const timeSinceLastQuery = now - lastQuery;
+  if (timeSinceLastQuery >= rateLimit) {
+    lastQuery = now;
+  } else {
+    const timeUntilNextQuery = rateLimit - timeSinceLastQuery;
+    lastQuery += timeUntilNextQuery;
+    await sleep(timeUntilNextQuery);
+  }
+}
+function createDebounceFetcher(fetcher2 = fetch) {
+  return async function debounceFetcher(...args) {
+    await debounce();
+    return fetcher2(...args);
+  };
+}
+
+// src/fetcher/page.result.ts
+var MagicPageResult = class {
+  constructor(apiPath, query) {
+    this.apiPath = apiPath;
+    this.query = query;
+    this.#hasMore = true;
+    this.#count = 0;
+  }
+  #count;
+  #hasMore;
+  get count() {
+    return this.#count;
+  }
+  get hasMore() {
+    return this.#hasMore;
+  }
+  async all() {
+    const r = [];
+    while (this.#hasMore) {
+      const result = await this.next();
+      r.push(...result);
+    }
+    return r;
+  }
+  async get(limit) {
+    const r = [];
+    while (this.#hasMore) {
+      const result = await this.next();
+      r.push(...result);
+      if (r.length === limit) {
+        return r;
+      }
+      if (r.length > limit) {
+        return r.slice(0, limit);
+      }
+    }
+    return r;
+  }
+  async next() {
+    const results = await fetcher(this.apiPath, this.query);
+    this.#hasMore = results?.has_more ?? false;
+    this.#count = Number.parseInt(`${results?.total_cards ?? 0}`, 10);
+    if (this.#hasMore) {
+      this.setNextPage();
+    }
+    return results?.data ?? [];
+  }
+  async page(page) {
+    this.query.page = page;
+    return this.next();
+  }
+  setNextPage() {
+    this.query.page += 1;
+  }
+};
+
+// src/fetcher/retry.fetcher.ts
+var defaultCanRetry = async (response) => {
+  const object = await response.json();
+  const status = "status" in object ? Number(object.status) : void 0;
+  if (status && status >= 500) {
+    return true;
+  }
+  const code = "code" in object && typeof object.code === "string" ? object.code : void 0;
+  return code !== "not_found" && code !== "bad_request";
+};
+function createRetryFetcher({ maxAttempts = 3, canRetry = defaultCanRetry } = {}, fetcher2 = fetch) {
+  let retries = 0;
+  return async function retryFetcher(...args) {
+    retries++;
+    const response = await fetcher2(...args);
+    if (response.ok) {
+      return response;
+    }
+    const object = await response.json();
+    const code = "code" in object && typeof object.code === "string" ? object.code : void 0;
+    const status = "status" in object ? Number(object.status) : void 0;
+    const details = "details" in object && typeof object.details === "string" ? object.details : void 0;
+    const type = "type" in object && typeof object.type === "string" ? object.type : void 0;
+    const warnings = "warnings" in object && Array.isArray(object.warnings) ? object.warnings : void 0;
+    if (retries >= maxAttempts) {
+      if (code && details && status) {
+        throw new ScryfallError(code, details, status, type, warnings);
+      }
+      throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+    }
+    if (canRetry(response)) {
+      return retryFetcher(...args);
+    }
+    if (code && details && status) {
+      throw new ScryfallError(code, details, status, type, warnings);
+    }
+    throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+  };
+}
+
+// src/fetcher/index.ts
+var simpleFetcher = createDebounceFetcher(createRetryFetcher());
+var endpoint = "https://api.scryfall.com";
+var DATE_REGEXP = /^\d{4}-\d{2}-\d{2}?$/;
+var dateParser = (_key, value) => {
+  if (typeof value === "string") {
+    if (DATE_REGEXP.test(value)) {
+      return new Date(value);
+    }
+  }
+  return value;
+};
+async function fetcher(apiPath, params, body) {
+  let path = "";
+  if (typeof apiPath === "number" || typeof apiPath === "string") {
+    path = apiPath;
+  } else if (apiPath) {
+    path = apiPath.join("/");
+  }
+  const url = new URL(`${endpoint}/${path}`);
+  if (params) {
+    Object.entries(params).forEach(([key, value]) => {
+      if (value !== void 0) {
+        url.searchParams.append(key, `${value}`);
+      }
+    });
+  }
+  try {
+    const init = {
+      method: body ? "POST" : "GET"
+    };
+    if (body) {
+      init.body = JSON.stringify(body);
+      init.headers = {
+        "Content-Type": "application/json"
+      };
+    }
+    const response = await simpleFetcher(url, init);
+    const content = await response.text();
+    return JSON.parse(content, dateParser);
+  } catch (e) {
+    if (e instanceof ScryfallError) {
+      if (e.warnings) {
+        console.warn(e.warnings);
+      }
+      if (e.code === "not_found" || e.code === "bad_request") {
+        return void 0;
+      }
+    }
+    throw e;
+  }
+}
+
+// src/api/card/card.api.ts
+var CardApi = class {
+  /*
+   * Returns up to 20 full English card names that could be autocompletions of the given string parameter.
+   * @param {string} name
+   * 	The string to search for
+   * @returns {Promise<string[]>}
+   * 	A list of up to 20 full English card names.
+   */
+  async autoCompleteName(name) {
+    const result = await fetcher("cards/autocomplete", {
+      q: name
+    });
+    return result?.data ?? [];
+  }
+  /*
+   * Returns a single card with the given Magic: The Gathering Arena ID.
+   * @param {number} id
+   * 	The Magic: The Gathering Arena ID of the card to retrieve.
+   * @returns {Promise<Card | undefined>}
+   * 	Returns a single card or undefined if no card is found.
+   */
+  async byArenaId(id) {
+    return fetcher(["cards/arena", id]);
+  }
+  /*
+   * Returns a single card with the given Scryfall ID.
+   * @param {number} id
+   * 	The Scryfall ID.
+   * @returns {Promise<Card | undefined>}
+   * 	Returns a single card or undefined if no card is found.
+   */
+  async byId(id) {
+    return fetcher(["cards", id]);
+  }
+  async byMtgoId(id) {
+    return fetcher(["cards/mtgo", id]);
+  }
+  async byMultiverseId(id) {
+    return fetcher(["cards/multiverse", id]);
+  }
+  async byName(name, set2, fuzzy = false) {
+    let f = fuzzy;
+    let s = set2;
+    if (typeof set2 === "boolean") {
+      f = set2;
+      s = void 0;
+    }
+    return fetcher("cards/named", {
+      [f ? "fuzzy" : "exact"]: name,
+      set: s
+    });
+  }
+  async bySet(setCode, collectorNumber, lang) {
+    const path = ["cards", setCode, collectorNumber];
+    if (lang) {
+      path.push(lang);
+    }
+    return fetcher(path);
+  }
+  async byTcgPlayerId(id) {
+    return fetcher(["cards/tcgplayer", id]);
+  }
+  async collection(...identifiers) {
+    const cards2 = [];
+    for (let i = 0; i < identifiers.length; i += 75) {
+      const collectionSection = { identifiers: identifiers.slice(i, i + 75) };
+      const result = await fetcher(
+        "cards/collection",
+        void 0,
+        collectionSection
+      );
+      cards2.push(...result?.data ?? []);
+    }
+    return cards2;
+  }
+  async random() {
+    return fetcher("cards/random");
+  }
+  search(query, options) {
+    return new MagicPageResult("cards/search", {
+      q: query,
+      ...typeof options === "number" ? { page: options } : { ...options, page: options?.page ?? 1 }
+    });
+  }
+};
+var cards = new CardApi();
+var card_api_default = cards;
+
+// src/api/card/index.ts
+var card_default = card_api_default;
+
+// src/api/card-identifier/card-identifier.api.ts
+var CardIdentifierApi = class {
+  static byId(id) {
+    return { id };
+  }
+  static byIllustrationId(id) {
+    return { illustration_id: id };
+  }
+  static byMtgoId(id) {
+    return { mtgo_id: id };
+  }
+  static byMultiverseId(id) {
+    return { multiverse_id: id };
+  }
+  static byName(name, set2) {
+    if (set2) {
+      return { name, set: set2 };
+    }
+    return { name };
+  }
+  static byOracleId(id) {
+    return { oracle_id: id };
+  }
+  static bySet(set2, collectorNumber) {
+    return { collector_number: `${collectorNumber}`, set: set2 };
+  }
+};
+
+// src/api/card-identifier/index.ts
+var card_identifier_default = CardIdentifierApi;
+
+// src/api/catalog/catalog.api.ts
+var CatalogApi = class {
+  async artifactTypes() {
+    return (await fetcher("catalog/artifact-types"))?.data ?? [];
+  }
+  async artistNames() {
+    return (await fetcher("catalog/artist-names"))?.data ?? [];
+  }
+  async cardNames() {
+    return (await fetcher("catalog/card-names"))?.data ?? [];
+  }
+  async creatureTypes() {
+    return (await fetcher("catalog/creature-types"))?.data ?? [];
+  }
+  async enchantmentTypes() {
+    return (await fetcher("catalog/enchantment-types"))?.data ?? [];
+  }
+  async landTypes() {
+    return (await fetcher("catalog/land-types"))?.data ?? [];
+  }
+  async loyalties() {
+    return (await fetcher("catalog/loyalties"))?.data ?? [];
+  }
+  async planeswalkerTypes() {
+    return (await fetcher("catalog/planeswalker-types"))?.data ?? [];
+  }
+  async powers() {
+    return (await fetcher("catalog/powers"))?.data ?? [];
+  }
+  async spellTypes() {
+    return (await fetcher("catalog/spell-types"))?.data ?? [];
+  }
+  async toughnesses() {
+    return (await fetcher("catalog/toughnesses"))?.data ?? [];
+  }
+  async watermarks() {
+    return (await fetcher("catalog/watermarks"))?.data ?? [];
+  }
+  async wordBank() {
+    return (await fetcher("catalog/word-bank"))?.data ?? [];
+  }
+};
+var catalog = new CatalogApi();
+var catalog_api_default = catalog;
+
+// src/api/catalog/index.ts
+var catalog_default = catalog_api_default;
+
+// src/api/ruling/ruling.api.ts
+var RulingApi = class {
+  async byArenaId(id) {
+    return (await fetcher(["cards/arena", id, "rulings"]))?.data ?? [];
+  }
+  async byId(id) {
+    return (await fetcher(["cards", id, "rulings"]))?.data ?? [];
+  }
+  async byMtgoId(id) {
+    return (await fetcher(["cards/mtgo", id, "rulings"]))?.data ?? [];
+  }
+  async byMultiverseId(id) {
+    return (await fetcher(["cards/multiverse", id, "rulings"]))?.data ?? [];
+  }
+  async bySet(setCode, collectorNumber) {
+    return (await fetcher(["cards", setCode, `${collectorNumber}`, "rulings"]))?.data ?? [];
+  }
+};
+var rulings = new RulingApi();
+var ruling_api_default = rulings;
+
+// src/api/ruling/index.ts
+var ruling_default = ruling_api_default;
+
+// src/api/set/set.api.ts
+var SetApi = class {
+  async all() {
+    const result = await fetcher("sets");
+    return result?.data ?? [];
+  }
+  async byCode(code) {
+    return await fetcher(["sets", code]);
+  }
+  async byId(id) {
+    return fetcher(["sets", id]);
+  }
+  async byTcgPlayerId(id) {
+    return fetcher(["sets/tcgplayer", id]);
+  }
+};
+var set = new SetApi();
+var set_api_default = set;
+
+// src/api/set/index.ts
+var set_default = set_api_default;
+
+// src/api/symbology/symbology.api.ts
+var SymbologyApi = class {
+  async all() {
+    const list = await fetcher("symbology");
+    return list?.data ?? [];
+  }
+  async parseMana(shorthand) {
+    if (!shorthand || typeof shorthand !== "string") {
+      throw new InvalidScryfallArgumentError("shorthand must be a string");
+    }
+    const cost = await fetcher("symbology/parse-mana", {
+      cost: shorthand
+    });
+    return cost ?? {
+      cost: "",
+      colors: [],
+      cmc: 0,
+      colorless: false,
+      monocolored: false,
+      multicolored: false,
+      object: "mana_cost"
+    };
+  }
+};
+var symbology = new SymbologyApi();
+var symbology_api_default = symbology;
+
+// src/api/symbology/index.ts
+var symbology_default = symbology_api_default;
+export {
+  card_identifier_default as CardIdentifierBuilder,
+  card_default as Cards,
+  catalog_default as Catalogs,
+  InvalidScryfallArgumentError,
+  MagicPageResult,
+  ruling_default as Rulings,
+  ScryfallError,
+  set_default as Sets,
+  symbology_default as SymbologyApi,
+  UnknownScryfallError
+};

package/dist/scryfall-api.min.cjs

@@ -0,0 +1 @@
+"use strict";var b=Object.defineProperty;var Q=Object.getOwnPropertyDescriptor;var z=Object.getOwnPropertyNames;var A=Object.prototype.hasOwnProperty;var U=(a,e)=>{for(var t in e)b(a,t,{get:e[t],enumerable:!0})},B=(a,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of z(e))!A.call(a,o)&&o!==t&&b(a,o,{get:()=>e[o],enumerable:!(s=Q(e,o))||s.enumerable});return a};var G=a=>B(b({},"__esModule",{value:!0}),a);var se={};U(se,{CardIdentifierBuilder:()=>_,Cards:()=>N,Catalogs:()=>j,InvalidScryfallArgumentError:()=>p,MagicPageResult:()=>d,Rulings:()=>q,ScryfallError:()=>u,Sets:()=>$,SymbologyApi:()=>D,UnknownScryfallError:()=>l});module.exports=G(se);var p=class extends Error{};var u=class extends Error{constructor(t,s,o,n,c){super(s);this.code=t;this.status=o;this.type=n;this.warnings=c}};var l=class extends Error{};var h=100,L=100;async function J(a=0){return new Promise(e=>{setTimeout(e,a)})}async function V(){let a=Date.now(),e=a-h;if(e>=L)h=a;else{let t=L-e;h+=t,await J(t)}}function w(a=fetch){return async function(...t){return await V(),a(...t)}}var d=class{constructor(e,t){this.apiPath=e;this.query=t;this.#e=!0,this.#t=0}#t;#e;get count(){return this.#t}get hasMore(){return this.#e}async all(){let e=[];for(;this.#e;){let t=await this.next();e.push(...t)}return e}async get(e){let t=[];for(;this.#e;){let s=await this.next();if(t.push(...s),t.length===e)return t;if(t.length>e)return t.slice(0,e)}return t}async next(){let e=await r(this.apiPath,this.query);return this.#e=e?.has_more??!1,this.#t=Number.parseInt(`${e?.total_cards??0}`,10),this.#e&&this.setNextPage(),e?.data??[]}async page(e){return this.query.page=e,this.next()}setNextPage(){this.query.page+=1}};var X=async a=>{let e=await a.json(),t="status"in e?Number(e.status):void 0;if(t&&t>=500)return!0;let s="code"in e&&typeof e.code=="string"?e.code:void 0;return s!=="not_found"&&s!=="bad_request"};function x({maxAttempts:a=3,canRetry:e=X}={},t=fetch){let s=0;return async function o(...n){s++;let c=await t(...n);if(c.ok)return c;let i=await c.json(),f="code"in i&&typeof i.code=="string"?i.code:void 0,y="status"in i?Number(i.status):void 0,g="details"in i&&typeof i.details=="string"?i.details:void 0,S="type"in i&&typeof i.type=="string"?i.type:void 0,F="warnings"in i&&Array.isArray(i.warnings)?i.warnings:void 0;if(s>=a)throw f&&g&&y?new u(f,g,y,S,F):new l(`Request failed with status ${c.status}`);if(e(c))return o(...n);throw f&&g&&y?new u(f,g,y,S,F):new l(`Request failed with status ${c.status}`)}}var H=w(x()),K="https://api.scryfall.com",W=/^\d{4}-\d{2}-\d{2}?$/,Y=(a,e)=>typeof e=="string"&&W.test(e)?new Date(e):e;async function r(a,e,t){let s="";typeof a=="number"||typeof a=="string"?s=a:a&&(s=a.join("/"));let o=new URL(`${K}/${s}`);e&&Object.entries(e).forEach(([n,c])=>{c!==void 0&&o.searchParams.append(n,`${c}`)});try{let n={method:t?"POST":"GET"};t&&(n.body=JSON.stringify(t),n.headers={"Content-Type":"application/json"});let i=await(await H(o,n)).text();return JSON.parse(i,Y)}catch(n){if(n instanceof u&&(n.warnings&&console.warn(n.warnings),n.code==="not_found"||n.code==="bad_request"))return;throw n}}var C=class{async autoCompleteName(e){return(await r("cards/autocomplete",{q:e}))?.data??[]}async byArenaId(e){return r(["cards/arena",e])}async byId(e){return r(["cards",e])}async byMtgoId(e){return r(["cards/mtgo",e])}async byMultiverseId(e){return r(["cards/multiverse",e])}async byName(e,t,s=!1){let o=s,n=t;return typeof t=="boolean"&&(o=t,n=void 0),r("cards/named",{[o?"fuzzy":"exact"]:e,set:n})}async bySet(e,t,s){let o=["cards",e,t];return s&&o.push(s),r(o)}async byTcgPlayerId(e){return r(["cards/tcgplayer",e])}async collection(...e){let t=[];for(let s=0;s<e.length;s+=75){let o={identifiers:e.slice(s,s+75)},n=await r("cards/collection",void 0,o);t.push(...n?.data??[])}return t}async random(){return r("cards/random")}search(e,t){return new d("cards/search",{q:e,...typeof t=="number"?{page:t}:{...t,page:t?.page??1}})}},Z=new C,M=Z;var N=M;var m=class{static byId(e){return{id:e}}static byIllustrationId(e){return{illustration_id:e}}static byMtgoId(e){return{mtgo_id:e}}static byMultiverseId(e){return{multiverse_id:e}}static byName(e,t){return t?{name:e,set:t}:{name:e}}static byOracleId(e){return{oracle_id:e}}static bySet(e,t){return{collector_number:`${t}`,set:e}}};var _=m;var P=class{async artifactTypes(){return(await r("catalog/artifact-types"))?.data??[]}async artistNames(){return(await r("catalog/artist-names"))?.data??[]}async cardNames(){return(await r("catalog/card-names"))?.data??[]}async creatureTypes(){return(await r("catalog/creature-types"))?.data??[]}async enchantmentTypes(){return(await r("catalog/enchantment-types"))?.data??[]}async landTypes(){return(await r("catalog/land-types"))?.data??[]}async loyalties(){return(await r("catalog/loyalties"))?.data??[]}async planeswalkerTypes(){return(await r("catalog/planeswalker-types"))?.data??[]}async powers(){return(await r("catalog/powers"))?.data??[]}async spellTypes(){return(await r("catalog/spell-types"))?.data??[]}async toughnesses(){return(await r("catalog/toughnesses"))?.data??[]}async watermarks(){return(await r("catalog/watermarks"))?.data??[]}async wordBank(){return(await r("catalog/word-bank"))?.data??[]}},ee=new P,E=ee;var j=E;var R=class{async byArenaId(e){return(await r(["cards/arena",e,"rulings"]))?.data??[]}async byId(e){return(await r(["cards",e,"rulings"]))?.data??[]}async byMtgoId(e){return(await r(["cards/mtgo",e,"rulings"]))?.data??[]}async byMultiverseId(e){return(await r(["cards/multiverse",e,"rulings"]))?.data??[]}async bySet(e,t){return(await r(["cards",e,`${t}`,"rulings"]))?.data??[]}},te=new R,k=te;var q=k;var T=class{async all(){return(await r("sets"))?.data??[]}async byCode(e){return await r(["sets",e])}async byId(e){return r(["sets",e])}async byTcgPlayerId(e){return r(["sets/tcgplayer",e])}},re=new T,O=re;var $=O;var I=class{async all(){return(await r("symbology"))?.data??[]}async parseMana(e){if(!e||typeof e!="string")throw new p("shorthand must be a string");return await r("symbology/parse-mana",{cost:e})??{cost:"",colors:[],cmc:0,colorless:!1,monocolored:!1,multicolored:!1,object:"mana_cost"}}},ae=new I,v=ae;var D=v;0&&(module.exports={CardIdentifierBuilder,Cards,Catalogs,InvalidScryfallArgumentError,MagicPageResult,Rulings,ScryfallError,Sets,SymbologyApi,UnknownScryfallError});

package/dist/scryfall-api.min.js

@@ -0,0 +1 @@
+var p=class extends Error{};var u=class extends Error{constructor(t,s,i,n,c){super(s);this.code=t;this.status=i;this.type=n;this.warnings=c}};var l=class extends Error{};var b=100,F=100;async function j(a=0){return new Promise(e=>{setTimeout(e,a)})}async function k(){let a=Date.now(),e=a-b;if(e>=F)b=a;else{let t=F-e;b+=t,await j(t)}}function h(a=fetch){return async function(...t){return await k(),a(...t)}}var d=class{constructor(e,t){this.apiPath=e;this.query=t;this.#e=!0,this.#t=0}#t;#e;get count(){return this.#t}get hasMore(){return this.#e}async all(){let e=[];for(;this.#e;){let t=await this.next();e.push(...t)}return e}async get(e){let t=[];for(;this.#e;){let s=await this.next();if(t.push(...s),t.length===e)return t;if(t.length>e)return t.slice(0,e)}return t}async next(){let e=await r(this.apiPath,this.query);return this.#e=e?.has_more??!1,this.#t=Number.parseInt(`${e?.total_cards??0}`,10),this.#e&&this.setNextPage(),e?.data??[]}async page(e){return this.query.page=e,this.next()}setNextPage(){this.query.page+=1}};var q=async a=>{let e=await a.json(),t="status"in e?Number(e.status):void 0;if(t&&t>=500)return!0;let s="code"in e&&typeof e.code=="string"?e.code:void 0;return s!=="not_found"&&s!=="bad_request"};function w({maxAttempts:a=3,canRetry:e=q}={},t=fetch){let s=0;return async function i(...n){s++;let c=await t(...n);if(c.ok)return c;let o=await c.json(),f="code"in o&&typeof o.code=="string"?o.code:void 0,y="status"in o?Number(o.status):void 0,g="details"in o&&typeof o.details=="string"?o.details:void 0,I="type"in o&&typeof o.type=="string"?o.type:void 0,S="warnings"in o&&Array.isArray(o.warnings)?o.warnings:void 0;if(s>=a)throw f&&g&&y?new u(f,g,y,I,S):new l(`Request failed with status ${c.status}`);if(e(c))return i(...n);throw f&&g&&y?new u(f,g,y,I,S):new l(`Request failed with status ${c.status}`)}}var O=h(w()),$="https://api.scryfall.com",v=/^\d{4}-\d{2}-\d{2}?$/,D=(a,e)=>typeof e=="string"&&v.test(e)?new Date(e):e;async function r(a,e,t){let s="";typeof a=="number"||typeof a=="string"?s=a:a&&(s=a.join("/"));let i=new URL(`${$}/${s}`);e&&Object.entries(e).forEach(([n,c])=>{c!==void 0&&i.searchParams.append(n,`${c}`)});try{let n={method:t?"POST":"GET"};t&&(n.body=JSON.stringify(t),n.headers={"Content-Type":"application/json"});let o=await(await O(i,n)).text();return JSON.parse(o,D)}catch(n){if(n instanceof u&&(n.warnings&&console.warn(n.warnings),n.code==="not_found"||n.code==="bad_request"))return;throw n}}var x=class{async autoCompleteName(e){return(await r("cards/autocomplete",{q:e}))?.data??[]}async byArenaId(e){return r(["cards/arena",e])}async byId(e){return r(["cards",e])}async byMtgoId(e){return r(["cards/mtgo",e])}async byMultiverseId(e){return r(["cards/multiverse",e])}async byName(e,t,s=!1){let i=s,n=t;return typeof t=="boolean"&&(i=t,n=void 0),r("cards/named",{[i?"fuzzy":"exact"]:e,set:n})}async bySet(e,t,s){let i=["cards",e,t];return s&&i.push(s),r(i)}async byTcgPlayerId(e){return r(["cards/tcgplayer",e])}async collection(...e){let t=[];for(let s=0;s<e.length;s+=75){let i={identifiers:e.slice(s,s+75)},n=await r("cards/collection",void 0,i);t.push(...n?.data??[])}return t}async random(){return r("cards/random")}search(e,t){return new d("cards/search",{q:e,...typeof t=="number"?{page:t}:{...t,page:t?.page??1}})}},Q=new x,L=Q;var z=L;var m=class{static byId(e){return{id:e}}static byIllustrationId(e){return{illustration_id:e}}static byMtgoId(e){return{mtgo_id:e}}static byMultiverseId(e){return{multiverse_id:e}}static byName(e,t){return t?{name:e,set:t}:{name:e}}static byOracleId(e){return{oracle_id:e}}static bySet(e,t){return{collector_number:`${t}`,set:e}}};var A=m;var C=class{async artifactTypes(){return(await r("catalog/artifact-types"))?.data??[]}async artistNames(){return(await r("catalog/artist-names"))?.data??[]}async cardNames(){return(await r("catalog/card-names"))?.data??[]}async creatureTypes(){return(await r("catalog/creature-types"))?.data??[]}async enchantmentTypes(){return(await r("catalog/enchantment-types"))?.data??[]}async landTypes(){return(await r("catalog/land-types"))?.data??[]}async loyalties(){return(await r("catalog/loyalties"))?.data??[]}async planeswalkerTypes(){return(await r("catalog/planeswalker-types"))?.data??[]}async powers(){return(await r("catalog/powers"))?.data??[]}async spellTypes(){return(await r("catalog/spell-types"))?.data??[]}async toughnesses(){return(await r("catalog/toughnesses"))?.data??[]}async watermarks(){return(await r("catalog/watermarks"))?.data??[]}async wordBank(){return(await r("catalog/word-bank"))?.data??[]}},U=new C,M=U;var B=M;var P=class{async byArenaId(e){return(await r(["cards/arena",e,"rulings"]))?.data??[]}async byId(e){return(await r(["cards",e,"rulings"]))?.data??[]}async byMtgoId(e){return(await r(["cards/mtgo",e,"rulings"]))?.data??[]}async byMultiverseId(e){return(await r(["cards/multiverse",e,"rulings"]))?.data??[]}async bySet(e,t){return(await r(["cards",e,`${t}`,"rulings"]))?.data??[]}},G=new P,N=G;var J=N;var R=class{async all(){return(await r("sets"))?.data??[]}async byCode(e){return await r(["sets",e])}async byId(e){return r(["sets",e])}async byTcgPlayerId(e){return r(["sets/tcgplayer",e])}},V=new R,_=V;var X=_;var T=class{async all(){return(await r("symbology"))?.data??[]}async parseMana(e){if(!e||typeof e!="string")throw new p("shorthand must be a string");return await r("symbology/parse-mana",{cost:e})??{cost:"",colors:[],cmc:0,colorless:!1,monocolored:!1,multicolored:!1,object:"mana_cost"}}},H=new T,E=H;var K=E;export{A as CardIdentifierBuilder,z as Cards,B as Catalogs,p as InvalidScryfallArgumentError,d as MagicPageResult,J as Rulings,u as ScryfallError,X as Sets,K as SymbologyApi,l as UnknownScryfallError};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "scryfall-api",
-	"version": "4.0.0-beta.0",
+	"version": "4.0.0-beta.1",
 	"description": "A Javascript library for https://scryfall.com/docs/api written in Typescript.",
 	"keywords": [
 		"magic",
@@ -42,6 +42,7 @@
 		"build": "tsup",
 		"lint": "eslint .",
 		"lint:fix": "eslint --fix .",
+		"prepublishOnly": "tsup",
 		"test": "bun test",
 		"typecheck": "tsc --noEmit"
 	},