scryfall-api 4.0.0-beta.1 → 4.0.0

package/README.md

@@ -39,21 +39,26 @@ bun add scryfall-api
 
 In the documentation below, requiring the package is assumed.
 
-```js
+```ts
 import scryfall from 'scryfall-api';
-```
 
+scryfall.Cards.byName('Black Lotus').then(console.log);
+```
 
 **With CommonJS**
 
 ```js
 const scryfall = require('scryfall-api');
+
+scryfall.Cards.byName('Black Lotus').then(console.log);
 ```
 
 **If you only need Cards**
 
-```js
+```ts
 import { Cards } from 'scryfall-api';
+
+Cards.byName('Black Lotus').then(console.log);
 ```
 
 Link to [full documentation.](./DOCUMENTATION.md)

package/dist/scryfall-api.cjs

@@ -20,15 +20,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/scryfall-api.ts
 var scryfall_api_exports = {};
 __export(scryfall_api_exports, {
-  CardIdentifierBuilder: () => card_identifier_default,
-  Cards: () => card_default,
-  Catalogs: () => catalog_default,
+  CardIdentifierBuilder: () => CardIdentifierApi,
+  Cards: () => card_api_default,
+  Catalogs: () => catalog_api_default,
   InvalidScryfallArgumentError: () => InvalidScryfallArgumentError,
   MagicPageResult: () => MagicPageResult,
-  Rulings: () => ruling_default,
+  Rulings: () => ruling_api_default,
   ScryfallError: () => ScryfallError,
-  Sets: () => set_default,
-  SymbologyApi: () => symbology_default,
+  Sets: () => set_api_default,
+  SymbologyApi: () => symbology_api_default,
   UnknownScryfallError: () => UnknownScryfallError
 });
 module.exports = __toCommonJS(scryfall_api_exports);
@@ -72,68 +72,12 @@ async function debounce() {
   }
 }
 function createDebounceFetcher(fetcher2 = fetch) {
-  return async function debounceFetcher(...args) {
+  return async function debounceFetcher(...arguments_) {
     await debounce();
-    return fetcher2(...args);
+    return fetcher2(...arguments_);
   };
 }
 
-// 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();
@@ -144,11 +88,11 @@ var defaultCanRetry = async (response) => {
   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) {
+function createRetryFetcher({ canRetry = defaultCanRetry, maxAttempts = 3 } = {}, fetcher2 = fetch) {
   let retries = 0;
-  return async function retryFetcher(...args) {
+  return async function retryFetcher(...arguments_) {
     retries++;
-    const response = await fetcher2(...args);
+    const response = await fetcher2(...arguments_);
     if (response.ok) {
       return response;
     }
@@ -162,44 +106,42 @@ function createRetryFetcher({ maxAttempts = 3, canRetry = defaultCanRetry } = {}
       if (code && details && status) {
         throw new ScryfallError(code, details, status, type, warnings);
       }
-      throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+      throw new UnknownScryfallError(`Request failed with status ${response.status.toFixed(0)}`);
     }
     if (canRetry(response)) {
-      return retryFetcher(...args);
+      return retryFetcher(...arguments_);
     }
     if (code && details && status) {
       throw new ScryfallError(code, details, status, type, warnings);
     }
-    throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+    throw new UnknownScryfallError(`Request failed with status ${response.status.toFixed(0)}`);
   };
 }
 
-// src/fetcher/index.ts
+// src/fetcher/fetcher.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);
-    }
+  if (typeof value === "string" && DATE_REGEXP.test(value)) {
+    return new Date(value);
   }
   return value;
 };
-async function fetcher(apiPath, params, body) {
+async function fetcher(apiPath, parameters, 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]) => {
+  const url = new URL(`${endpoint}/${String(path)}`);
+  if (parameters) {
+    for (const [key, value] of Object.entries(parameters)) {
       if (value !== void 0) {
-        url.searchParams.append(key, `${value}`);
+        url.searchParams.append(key, value.toString());
       }
-    });
+    }
   }
   try {
     const init = {
@@ -214,19 +156,75 @@ async function fetcher(apiPath, params, body) {
     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);
+  } catch (error) {
+    if (error instanceof ScryfallError) {
+      if (error.warnings) {
+        console.warn(error.warnings);
       }
-      if (e.code === "not_found" || e.code === "bad_request") {
+      if (error.code === "not_found" || error.code === "bad_request") {
         return void 0;
       }
     }
-    throw e;
+    throw error;
   }
 }
 
+// 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?.toFixed(0) ?? "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/api/card/card.api.ts
 var CardApi = class {
   /*
@@ -292,8 +290,8 @@ var CardApi = class {
   }
   async collection(...identifiers) {
     const cards2 = [];
-    for (let i = 0; i < identifiers.length; i += 75) {
-      const collectionSection = { identifiers: identifiers.slice(i, i + 75) };
+    for (let index = 0; index < identifiers.length; index += 75) {
+      const collectionSection = { identifiers: identifiers.slice(index, index + 75) };
       const result = await fetcher(
         "cards/collection",
         void 0,
@@ -316,9 +314,6 @@ var CardApi = class {
 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) {
@@ -343,85 +338,94 @@ var CardIdentifierApi = class {
     return { oracle_id: id };
   }
   static bySet(set2, collectorNumber) {
-    return { collector_number: `${collectorNumber}`, set: set2 };
+    return { collector_number: String(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 ?? [];
+    const response = await fetcher("catalog/artifact-types");
+    return response?.data ?? [];
   }
   async artistNames() {
-    return (await fetcher("catalog/artist-names"))?.data ?? [];
+    const response = await fetcher("catalog/artist-names");
+    return response?.data ?? [];
   }
   async cardNames() {
-    return (await fetcher("catalog/card-names"))?.data ?? [];
+    const response = await fetcher("catalog/card-names");
+    return response?.data ?? [];
   }
   async creatureTypes() {
-    return (await fetcher("catalog/creature-types"))?.data ?? [];
+    const response = await fetcher("catalog/creature-types");
+    return response?.data ?? [];
   }
   async enchantmentTypes() {
-    return (await fetcher("catalog/enchantment-types"))?.data ?? [];
+    const response = await fetcher("catalog/enchantment-types");
+    return response?.data ?? [];
   }
   async landTypes() {
-    return (await fetcher("catalog/land-types"))?.data ?? [];
+    const response = await fetcher("catalog/land-types");
+    return response?.data ?? [];
   }
   async loyalties() {
-    return (await fetcher("catalog/loyalties"))?.data ?? [];
+    const response = await fetcher("catalog/loyalties");
+    return response?.data ?? [];
   }
   async planeswalkerTypes() {
-    return (await fetcher("catalog/planeswalker-types"))?.data ?? [];
+    const response = await fetcher("catalog/planeswalker-types");
+    return response?.data ?? [];
   }
   async powers() {
-    return (await fetcher("catalog/powers"))?.data ?? [];
+    const response = await fetcher("catalog/powers");
+    return response?.data ?? [];
   }
   async spellTypes() {
-    return (await fetcher("catalog/spell-types"))?.data ?? [];
+    const response = await fetcher("catalog/spell-types");
+    return response?.data ?? [];
   }
   async toughnesses() {
-    return (await fetcher("catalog/toughnesses"))?.data ?? [];
+    const response = await fetcher("catalog/toughnesses");
+    return response?.data ?? [];
   }
   async watermarks() {
-    return (await fetcher("catalog/watermarks"))?.data ?? [];
+    const response = await fetcher("catalog/watermarks");
+    return response?.data ?? [];
   }
   async wordBank() {
-    return (await fetcher("catalog/word-bank"))?.data ?? [];
+    const response = await fetcher("catalog/word-bank");
+    return response?.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 ?? [];
+    const response = await fetcher(["cards/arena", id, "rulings"]);
+    return response?.data ?? [];
   }
   async byId(id) {
-    return (await fetcher(["cards", id, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards", id, "rulings"]);
+    return response?.data ?? [];
   }
   async byMtgoId(id) {
-    return (await fetcher(["cards/mtgo", id, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards/mtgo", id, "rulings"]);
+    return response?.data ?? [];
   }
   async byMultiverseId(id) {
-    return (await fetcher(["cards/multiverse", id, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards/multiverse", id, "rulings"]);
+    return response?.data ?? [];
   }
   async bySet(setCode, collectorNumber) {
-    return (await fetcher(["cards", setCode, `${collectorNumber}`, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards", setCode, String(collectorNumber), "rulings"]);
+    return response?.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() {
@@ -441,9 +445,6 @@ var SetApi = class {
 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() {
@@ -458,10 +459,10 @@ var SymbologyApi = class {
       cost: shorthand
     });
     return cost ?? {
-      cost: "",
-      colors: [],
       cmc: 0,
       colorless: false,
+      colors: [],
+      cost: "",
       monocolored: false,
       multicolored: false,
       object: "mana_cost"
@@ -470,9 +471,6 @@ var SymbologyApi = class {
 };
 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,

package/dist/scryfall-api.d.ts

@@ -47,7 +47,7 @@ interface CardIdentifierCollectorSet {
     collector_number: string;
     set: string;
 }
-type CardIdentifier = CardIdentifierId | CardIdentifierIllustrationId | CardIdentifierMtgGoId | CardIdentifierMultiverseId | CardIdentifierNameSet | CardIdentifierOracleId | CardIdentifierCollectorSet;
+type CardIdentifier = CardIdentifierCollectorSet | CardIdentifierId | CardIdentifierIllustrationId | CardIdentifierMtgGoId | CardIdentifierMultiverseId | CardIdentifierNameSet | CardIdentifierOracleId;
 
 declare class CardIdentifierApi {
     static byId(id: string): CardIdentifier;
@@ -59,8 +59,8 @@ declare class CardIdentifierApi {
     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';
+type CardLanguage = 'ar' | 'de' | 'en' | 'es' | 'fr' | 'grc' | 'he' | 'it' | 'ja' | 'ko' | 'la' | 'ph' | 'pt' | 'ru' | 'sa' | 'zhs' | 'zht';
+type CardLayout = 'adventure' | 'art_series' | 'augment' | 'battle' | 'case' | 'class' | 'double_faced_token' | 'emblem' | 'flip' | 'host' | 'leveler' | 'meld' | 'modal_dfc' | 'mutate' | 'normal' | 'planar' | 'prototype' | 'reversible_card' | 'saga' | 'scheme' | 'split' | 'token' | 'transform' | 'vanguard';
 interface CardCore {
     arena_id?: Nullable<string>;
     cardmarket_id?: Nullable<number>;
@@ -80,7 +80,7 @@ interface CardCore {
     uri: string;
 }
 
-type Color = 'W' | 'B' | 'R' | 'U' | 'G';
+type Color = 'B' | 'G' | 'R' | 'U' | 'W';
 interface ManaCost {
     cmc: number;
     colorless: boolean;
@@ -113,8 +113,8 @@ declare class SymbologyApi {
 }
 declare const symbology: SymbologyApi;
 
-type CardComponent = 'token' | 'meld_part' | 'meld_result' | 'combo_piece';
-type Legality = 'legal' | 'not_legal' | 'restricted' | 'banned';
+type CardComponent = 'combo_piece' | 'meld_part' | 'meld_result' | 'token';
+type Legality = 'banned' | 'legal' | 'not_legal' | 'restricted';
 interface ImageUris$1 {
     art_crop: string;
     border_crop: string;
@@ -205,7 +205,7 @@ interface GameplayCard {
     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';
+type SetType = 'alchemy' | 'archenemy' | 'arsenal' | 'box' | 'commander' | 'core' | 'draft_innovation' | 'duel_deck' | 'expansion' | 'from_the_vault' | 'funny' | 'masterpiece' | 'masters' | 'memorabilia' | 'minigame' | 'planechase' | 'premium_deck' | 'promo' | 'spellbook' | 'starter' | 'token' | 'treasure_chest' | 'vanguard';
 interface Set {
     arena_code?: Nullable<string>;
     block?: Nullable<string>;
@@ -239,11 +239,11 @@ declare class SetApi {
 declare const set: SetApi;
 
 type BorderColor = 'black' | 'borderless' | 'gold' | 'silver' | 'white';
-type Finish = 'foil' | 'nonfoil' | 'etched';
+type Finish = 'etched' | 'foil' | 'nonfoil';
 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';
+type FrameEffect = 'colorshifted' | 'companion' | 'compasslanddfc' | 'convertdfc' | 'devoid' | 'draft' | 'etched' | 'extendedart' | 'fandfc' | 'inverted' | 'legendary' | 'lesson' | 'miracle' | 'mooneldrazidfc' | 'nyxtouched' | 'originpwdfc' | 'shatteredglass' | 'showcase' | 'snow' | 'sunmoondfc' | 'tombstone' | 'upsidedowndfc' | 'waxingandwaningmoondfc';
+type Game = 'arena' | 'mtgo' | 'paper';
+type ImageStatus = 'highres_scan' | 'lowres' | 'missing' | 'placeholder';
 interface ImageUris {
     art_crop: string;
     border_crop: string;
@@ -265,14 +265,14 @@ interface Prices {
     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';
+type PromoType = 'arenaleague' | 'buyabox' | 'convention' | 'datestamped' | 'draftweekend' | 'duels' | 'event' | 'fnm' | 'gameday' | 'gateway' | 'giftbox' | 'instore' | 'intropack' | 'judgegift' | 'league' | 'openhouse' | 'ourney' | 'planeswalkerdeck' | 'playerrewards' | 'premiereshop' | 'prerelease' | 'release' | 'setpromo' | 'starterdeck' | 'wizardsplaynetwork';
 interface PurchaseUris {
     [key: string]: Nullable<string>;
     cardhoarder?: Nullable<string>;
     cardmarket?: Nullable<string>;
     tcgplayer?: Nullable<string>;
 }
-type Rarity = 'common' | 'uncommon' | 'rare' | 'special' | 'mythic' | 'bonus';
+type Rarity = 'bonus' | 'common' | 'mythic' | 'rare' | 'special' | 'uncommon';
 interface RelatedUris {
     [key: string]: Nullable<string>;
     edhrec?: Nullable<string>;
@@ -282,7 +282,7 @@ interface RelatedUris {
     tcgplayer_infinite_articles?: Nullable<string>;
     tcgplayer_infinite_decks?: Nullable<string>;
 }
-type SecurityStamp = 'oval' | 'triangle' | 'acorn' | 'circle' | 'arena' | 'heart';
+type SecurityStamp = 'acorn' | 'arena' | 'circle' | 'heart' | 'oval' | 'triangle';
 interface CardPrint {
     artist?: Nullable<string>;
     artist_ids?: Nullable<string[]>;
@@ -332,14 +332,14 @@ interface CardPrint {
     watermark?: Nullable<string>;
 }
 
-type Card = CardCore & GameplayCard & CardPrint;
+type Card = CardCore & CardPrint & GameplayCard;
 
-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';
+type CardSearchUnique = 'art' | 'cards' | 'prints';
+type CardSearchOrder = 'artist' | 'cmc' | 'color' | 'edhrec' | 'eur' | 'name' | 'penny' | 'power' | 'rarity' | 'released' | 'review' | 'set' | 'tix' | 'toughness' | 'usd';
+type CardSearchDirection = 'asc' | 'auto' | 'desc';
+type CardSearchFormat = 'csv' | 'json';
 interface CardSearch {
-    dir?: CardSearchDir;
+    dir?: CardSearchDirection;
     format?: CardSearchFormat;
     include_extras?: boolean;
     include_multilingual?: boolean;
@@ -361,7 +361,7 @@ declare class CardApi {
     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>;
+    random(): Promise<Card>;
     search(query: string, options?: CardSearch | number): MagicPageResult<Card>;
 }
 declare const cards: CardApi;
@@ -413,12 +413,12 @@ 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);
+    readonly type?: null | string | undefined;
+    readonly warnings?: null | string[] | undefined;
+    constructor(code: string, details: string, status: number, type?: null | string | undefined, warnings?: null | string[] | 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 };
+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 CardSearchDirection, 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

@@ -37,68 +37,12 @@ async function debounce() {
   }
 }
 function createDebounceFetcher(fetcher2 = fetch) {
-  return async function debounceFetcher(...args) {
+  return async function debounceFetcher(...arguments_) {
     await debounce();
-    return fetcher2(...args);
+    return fetcher2(...arguments_);
   };
 }
 
-// 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();
@@ -109,11 +53,11 @@ var defaultCanRetry = async (response) => {
   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) {
+function createRetryFetcher({ canRetry = defaultCanRetry, maxAttempts = 3 } = {}, fetcher2 = fetch) {
   let retries = 0;
-  return async function retryFetcher(...args) {
+  return async function retryFetcher(...arguments_) {
     retries++;
-    const response = await fetcher2(...args);
+    const response = await fetcher2(...arguments_);
     if (response.ok) {
       return response;
     }
@@ -127,44 +71,42 @@ function createRetryFetcher({ maxAttempts = 3, canRetry = defaultCanRetry } = {}
       if (code && details && status) {
         throw new ScryfallError(code, details, status, type, warnings);
       }
-      throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+      throw new UnknownScryfallError(`Request failed with status ${response.status.toFixed(0)}`);
     }
     if (canRetry(response)) {
-      return retryFetcher(...args);
+      return retryFetcher(...arguments_);
     }
     if (code && details && status) {
       throw new ScryfallError(code, details, status, type, warnings);
     }
-    throw new UnknownScryfallError(`Request failed with status ${response.status}`);
+    throw new UnknownScryfallError(`Request failed with status ${response.status.toFixed(0)}`);
   };
 }
 
-// src/fetcher/index.ts
+// src/fetcher/fetcher.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);
-    }
+  if (typeof value === "string" && DATE_REGEXP.test(value)) {
+    return new Date(value);
   }
   return value;
 };
-async function fetcher(apiPath, params, body) {
+async function fetcher(apiPath, parameters, 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]) => {
+  const url = new URL(`${endpoint}/${String(path)}`);
+  if (parameters) {
+    for (const [key, value] of Object.entries(parameters)) {
       if (value !== void 0) {
-        url.searchParams.append(key, `${value}`);
+        url.searchParams.append(key, value.toString());
       }
-    });
+    }
   }
   try {
     const init = {
@@ -179,19 +121,75 @@ async function fetcher(apiPath, params, body) {
     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);
+  } catch (error) {
+    if (error instanceof ScryfallError) {
+      if (error.warnings) {
+        console.warn(error.warnings);
       }
-      if (e.code === "not_found" || e.code === "bad_request") {
+      if (error.code === "not_found" || error.code === "bad_request") {
         return void 0;
       }
     }
-    throw e;
+    throw error;
   }
 }
 
+// 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?.toFixed(0) ?? "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/api/card/card.api.ts
 var CardApi = class {
   /*
@@ -257,8 +255,8 @@ var CardApi = class {
   }
   async collection(...identifiers) {
     const cards2 = [];
-    for (let i = 0; i < identifiers.length; i += 75) {
-      const collectionSection = { identifiers: identifiers.slice(i, i + 75) };
+    for (let index = 0; index < identifiers.length; index += 75) {
+      const collectionSection = { identifiers: identifiers.slice(index, index + 75) };
       const result = await fetcher(
         "cards/collection",
         void 0,
@@ -281,9 +279,6 @@ var CardApi = class {
 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) {
@@ -308,85 +303,94 @@ var CardIdentifierApi = class {
     return { oracle_id: id };
   }
   static bySet(set2, collectorNumber) {
-    return { collector_number: `${collectorNumber}`, set: set2 };
+    return { collector_number: String(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 ?? [];
+    const response = await fetcher("catalog/artifact-types");
+    return response?.data ?? [];
   }
   async artistNames() {
-    return (await fetcher("catalog/artist-names"))?.data ?? [];
+    const response = await fetcher("catalog/artist-names");
+    return response?.data ?? [];
   }
   async cardNames() {
-    return (await fetcher("catalog/card-names"))?.data ?? [];
+    const response = await fetcher("catalog/card-names");
+    return response?.data ?? [];
   }
   async creatureTypes() {
-    return (await fetcher("catalog/creature-types"))?.data ?? [];
+    const response = await fetcher("catalog/creature-types");
+    return response?.data ?? [];
   }
   async enchantmentTypes() {
-    return (await fetcher("catalog/enchantment-types"))?.data ?? [];
+    const response = await fetcher("catalog/enchantment-types");
+    return response?.data ?? [];
   }
   async landTypes() {
-    return (await fetcher("catalog/land-types"))?.data ?? [];
+    const response = await fetcher("catalog/land-types");
+    return response?.data ?? [];
   }
   async loyalties() {
-    return (await fetcher("catalog/loyalties"))?.data ?? [];
+    const response = await fetcher("catalog/loyalties");
+    return response?.data ?? [];
   }
   async planeswalkerTypes() {
-    return (await fetcher("catalog/planeswalker-types"))?.data ?? [];
+    const response = await fetcher("catalog/planeswalker-types");
+    return response?.data ?? [];
   }
   async powers() {
-    return (await fetcher("catalog/powers"))?.data ?? [];
+    const response = await fetcher("catalog/powers");
+    return response?.data ?? [];
   }
   async spellTypes() {
-    return (await fetcher("catalog/spell-types"))?.data ?? [];
+    const response = await fetcher("catalog/spell-types");
+    return response?.data ?? [];
   }
   async toughnesses() {
-    return (await fetcher("catalog/toughnesses"))?.data ?? [];
+    const response = await fetcher("catalog/toughnesses");
+    return response?.data ?? [];
   }
   async watermarks() {
-    return (await fetcher("catalog/watermarks"))?.data ?? [];
+    const response = await fetcher("catalog/watermarks");
+    return response?.data ?? [];
   }
   async wordBank() {
-    return (await fetcher("catalog/word-bank"))?.data ?? [];
+    const response = await fetcher("catalog/word-bank");
+    return response?.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 ?? [];
+    const response = await fetcher(["cards/arena", id, "rulings"]);
+    return response?.data ?? [];
   }
   async byId(id) {
-    return (await fetcher(["cards", id, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards", id, "rulings"]);
+    return response?.data ?? [];
   }
   async byMtgoId(id) {
-    return (await fetcher(["cards/mtgo", id, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards/mtgo", id, "rulings"]);
+    return response?.data ?? [];
   }
   async byMultiverseId(id) {
-    return (await fetcher(["cards/multiverse", id, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards/multiverse", id, "rulings"]);
+    return response?.data ?? [];
   }
   async bySet(setCode, collectorNumber) {
-    return (await fetcher(["cards", setCode, `${collectorNumber}`, "rulings"]))?.data ?? [];
+    const response = await fetcher(["cards", setCode, String(collectorNumber), "rulings"]);
+    return response?.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() {
@@ -406,9 +410,6 @@ var SetApi = class {
 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() {
@@ -423,10 +424,10 @@ var SymbologyApi = class {
       cost: shorthand
     });
     return cost ?? {
-      cost: "",
-      colors: [],
       cmc: 0,
       colorless: false,
+      colors: [],
+      cost: "",
       monocolored: false,
       multicolored: false,
       object: "mana_cost"
@@ -435,18 +436,15 @@ var SymbologyApi = class {
 };
 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,
+  CardIdentifierApi as CardIdentifierBuilder,
+  card_api_default as Cards,
+  catalog_api_default as Catalogs,
   InvalidScryfallArgumentError,
   MagicPageResult,
-  ruling_default as Rulings,
+  ruling_api_default as Rulings,
   ScryfallError,
-  set_default as Sets,
-  symbology_default as SymbologyApi,
+  set_api_default as Sets,
+  symbology_api_default as SymbologyApi,
   UnknownScryfallError
 };

package/dist/scryfall-api.min.cjs

@@ -1 +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});
+"use strict";var b=Object.defineProperty;var q=Object.getOwnPropertyDescriptor;var E=Object.getOwnPropertyNames;var O=Object.prototype.hasOwnProperty;var v=(s,e)=>{for(var t in e)b(s,t,{get:e[t],enumerable:!0})},D=(s,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of E(e))!O.call(s,o)&&o!==t&&b(s,o,{get:()=>e[o],enumerable:!(n=q(e,o))||n.enumerable});return s};var Q=s=>D(b({},"__esModule",{value:!0}),s);var Y={};v(Y,{CardIdentifierBuilder:()=>m,Cards:()=>P,Catalogs:()=>T,InvalidScryfallArgumentError:()=>d,MagicPageResult:()=>l,Rulings:()=>S,ScryfallError:()=>u,Sets:()=>L,SymbologyApi:()=>N,UnknownScryfallError:()=>p});module.exports=Q(Y);var d=class extends Error{};var u=class extends Error{constructor(t,n,o,a,c){super(n);this.code=t;this.status=o;this.type=a;this.warnings=c}};var p=class extends Error{};var h=100,j=100;async function z(s=0){return new Promise(e=>{setTimeout(e,s)})}async function $(){let s=Date.now(),e=s-h;if(e>=j)h=s;else{let t=j-e;h+=t,await z(t)}}function w(s=fetch){return async function(...t){return await $(),s(...t)}}var A=async s=>{let e=await s.json(),t="status"in e?Number(e.status):void 0;if(t&&t>=500)return!0;let n="code"in e&&typeof e.code=="string"?e.code:void 0;return n!=="not_found"&&n!=="bad_request"};function x({canRetry:s=A,maxAttempts:e=3}={},t=fetch){let n=0;return async function o(...a){n++;let c=await t(...a);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,_="type"in i&&typeof i.type=="string"?i.type:void 0,k="warnings"in i&&Array.isArray(i.warnings)?i.warnings:void 0;if(n>=e)throw f&&g&&y?new u(f,g,y,_,k):new p(`Request failed with status ${c.status.toFixed(0)}`);if(s(c))return o(...a);throw f&&g&&y?new u(f,g,y,_,k):new p(`Request failed with status ${c.status.toFixed(0)}`)}}var U=w(x()),B="https://api.scryfall.com",G=/^\d{4}-\d{2}-\d{2}?$/,J=(s,e)=>typeof e=="string"&&G.test(e)?new Date(e):e;async function r(s,e,t){let n="";typeof s=="number"||typeof s=="string"?n=s:s&&(n=s.join("/"));let o=new URL(`${B}/${String(n)}`);if(e)for(let[a,c]of Object.entries(e))c!==void 0&&o.searchParams.append(a,c.toString());try{let a={method:t?"POST":"GET"};t&&(a.body=JSON.stringify(t),a.headers={"Content-Type":"application/json"});let i=await(await U(o,a)).text();return JSON.parse(i,J)}catch(a){if(a instanceof u&&(a.warnings&&console.warn(a.warnings),a.code==="not_found"||a.code==="bad_request"))return;throw a}}var l=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 n=await this.next();if(t.push(...n),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?.toFixed(0)??"0",10),this.#e&&this.setNextPage(),e?.data??[]}async page(e){return this.query.page=e,this.next()}setNextPage(){this.query.page+=1}};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,n=!1){let o=n,a=t;return typeof t=="boolean"&&(o=t,a=void 0),r("cards/named",{[o?"fuzzy":"exact"]:e,set:a})}async bySet(e,t,n){let o=["cards",e,t];return n&&o.push(n),r(o)}async byTcgPlayerId(e){return r(["cards/tcgplayer",e])}async collection(...e){let t=[];for(let n=0;n<e.length;n+=75){let o={identifiers:e.slice(n,n+75)},a=await r("cards/collection",void 0,o);t.push(...a?.data??[])}return t}async random(){return r("cards/random")}search(e,t){return new l("cards/search",{q:e,...typeof t=="number"?{page:t}:{...t,page:t?.page??1}})}},V=new C,P=V;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:String(t),set:e}}};var R=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??[]}},X=new R,T=X;var I=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,String(t),"rulings"]))?.data??[]}},H=new I,S=H;var F=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])}},K=new F,L=K;var M=class{async all(){return(await r("symbology"))?.data??[]}async parseMana(e){if(!e||typeof e!="string")throw new d("shorthand must be a string");return await r("symbology/parse-mana",{cost:e})??{cmc:0,colorless:!1,colors:[],cost:"",monocolored:!1,multicolored:!1,object:"mana_cost"}}},W=new M,N=W;0&&(module.exports={CardIdentifierBuilder,Cards,Catalogs,InvalidScryfallArgumentError,MagicPageResult,Rulings,ScryfallError,Sets,SymbologyApi,UnknownScryfallError});

package/dist/scryfall-api.min.js

@@ -1 +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};
+var d=class extends Error{};var u=class extends Error{constructor(t,n,i,a,c){super(n);this.code=t;this.status=i;this.type=a;this.warnings=c}};var p=class extends Error{};var b=100,F=100;async function j(s=0){return new Promise(e=>{setTimeout(e,s)})}async function q(){let s=Date.now(),e=s-b;if(e>=F)b=s;else{let t=F-e;b+=t,await j(t)}}function h(s=fetch){return async function(...t){return await q(),s(...t)}}var E=async s=>{let e=await s.json(),t="status"in e?Number(e.status):void 0;if(t&&t>=500)return!0;let n="code"in e&&typeof e.code=="string"?e.code:void 0;return n!=="not_found"&&n!=="bad_request"};function w({canRetry:s=E,maxAttempts:e=3}={},t=fetch){let n=0;return async function i(...a){n++;let c=await t(...a);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(n>=e)throw f&&g&&y?new u(f,g,y,I,S):new p(`Request failed with status ${c.status.toFixed(0)}`);if(s(c))return i(...a);throw f&&g&&y?new u(f,g,y,I,S):new p(`Request failed with status ${c.status.toFixed(0)}`)}}var O=h(w()),v="https://api.scryfall.com",D=/^\d{4}-\d{2}-\d{2}?$/,Q=(s,e)=>typeof e=="string"&&D.test(e)?new Date(e):e;async function r(s,e,t){let n="";typeof s=="number"||typeof s=="string"?n=s:s&&(n=s.join("/"));let i=new URL(`${v}/${String(n)}`);if(e)for(let[a,c]of Object.entries(e))c!==void 0&&i.searchParams.append(a,c.toString());try{let a={method:t?"POST":"GET"};t&&(a.body=JSON.stringify(t),a.headers={"Content-Type":"application/json"});let o=await(await O(i,a)).text();return JSON.parse(o,Q)}catch(a){if(a instanceof u&&(a.warnings&&console.warn(a.warnings),a.code==="not_found"||a.code==="bad_request"))return;throw a}}var l=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 n=await this.next();if(t.push(...n),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?.toFixed(0)??"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=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,n=!1){let i=n,a=t;return typeof t=="boolean"&&(i=t,a=void 0),r("cards/named",{[i?"fuzzy":"exact"]:e,set:a})}async bySet(e,t,n){let i=["cards",e,t];return n&&i.push(n),r(i)}async byTcgPlayerId(e){return r(["cards/tcgplayer",e])}async collection(...e){let t=[];for(let n=0;n<e.length;n+=75){let i={identifiers:e.slice(n,n+75)},a=await r("cards/collection",void 0,i);t.push(...a?.data??[])}return t}async random(){return r("cards/random")}search(e,t){return new l("cards/search",{q:e,...typeof t=="number"?{page:t}:{...t,page:t?.page??1}})}},z=new x,L=z;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:String(t),set:e}}};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??[]}},$=new C,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,String(t),"rulings"]))?.data??[]}},A=new P,N=A;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])}},U=new R,_=U;var T=class{async all(){return(await r("symbology"))?.data??[]}async parseMana(e){if(!e||typeof e!="string")throw new d("shorthand must be a string");return await r("symbology/parse-mana",{cost:e})??{cmc:0,colorless:!1,colors:[],cost:"",monocolored:!1,multicolored:!1,object:"mana_cost"}}},B=new T,k=B;export{m as CardIdentifierBuilder,L as Cards,M as Catalogs,d as InvalidScryfallArgumentError,l as MagicPageResult,N as Rulings,u as ScryfallError,_ as Sets,k as SymbologyApi,p as UnknownScryfallError};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "scryfall-api",
-	"version": "4.0.0-beta.1",
+	"version": "4.0.0",
 	"description": "A Javascript library for https://scryfall.com/docs/api written in Typescript.",
 	"keywords": [
 		"magic",
@@ -15,26 +15,27 @@
 		"scryfall",
 		"scry"
 	],
-	"homepage": "https://github.com/MarioMH8/scryfall-api",
-	"bugs": {
-		"url": "https://github.com/MarioMH8/scryfall-api/issues"
-	},
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/MarioMH8/scryfall-api"
 	},
+	"homepage": "https://github.com/MarioMH8/scryfall-api",
+	"bugs": {
+		"url": "https://github.com/MarioMH8/scryfall-api/issues"
+	},
 	"license": "MIT",
+	"type": "module",
 	"files": [
 		"dist"
 	],
-	"type": "module",
+	"main": "./dist/scryfall-api.js",
 	"module": "./dist/scryfall-api.js",
 	"types": "./dist/scryfall-api.d.ts",
 	"exports": {
 		".": {
 			"types": "./dist/scryfall-api.d.ts",
-			"require": "./dist/scryfall-api.cjs",
 			"import": "./dist/scryfall-api.js",
+			"require": "./dist/scryfall-api.cjs",
 			"default": "./dist/scryfall-api.js"
 		}
 	},
@@ -47,12 +48,12 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"devDependencies": {
-		"@changesets/cli": "2.27.1",
-		"@hexatool/eslint-config": "2.3.0",
-		"@hexatool/tsconfig": "20.0.1",
-		"@types/bun": "1.0.7",
-		"eslint": "8.57.0",
-		"tsup": "8.0.2",
-		"typescript": "5.3.3"
+		"@changesets/cli": "2.27.7",
+		"@hexadrop/eslint-config": "0.0.1-beta.14",
+		"@hexadrop/tsconfig": "0.0.5",
+		"@types/bun": "1.1.6",
+		"eslint": "9.6.0",
+		"tsup": "8.1.0",
+		"typescript": "5.5.3"
 	}
 }