scryfall-api 4.0.0-beta.0 → 4.0.0-beta.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/scryfall-api.cjs +488 -0
- package/dist/scryfall-api.d.ts +424 -0
- package/dist/scryfall-api.js +452 -0
- package/dist/scryfall-api.min.cjs +1 -0
- package/dist/scryfall-api.min.js +1 -0
- package/package.json +4 -3
|
@@ -0,0 +1,452 @@
|
|
|
1
|
+
// src/error/invalid.error.ts
|
|
2
|
+
var InvalidScryfallArgumentError = class extends Error {
|
|
3
|
+
};
|
|
4
|
+
|
|
5
|
+
// src/error/scryfall.error.ts
|
|
6
|
+
var ScryfallError = class extends Error {
|
|
7
|
+
constructor(code, details, status, type, warnings) {
|
|
8
|
+
super(details);
|
|
9
|
+
this.code = code;
|
|
10
|
+
this.status = status;
|
|
11
|
+
this.type = type;
|
|
12
|
+
this.warnings = warnings;
|
|
13
|
+
}
|
|
14
|
+
};
|
|
15
|
+
|
|
16
|
+
// src/error/unknown.error.ts
|
|
17
|
+
var UnknownScryfallError = class extends Error {
|
|
18
|
+
};
|
|
19
|
+
|
|
20
|
+
// src/fetcher/debounce.fetcher.ts
|
|
21
|
+
var lastQuery = 100;
|
|
22
|
+
var rateLimit = 100;
|
|
23
|
+
async function sleep(ms = 0) {
|
|
24
|
+
return new Promise((resolve) => {
|
|
25
|
+
setTimeout(resolve, ms);
|
|
26
|
+
});
|
|
27
|
+
}
|
|
28
|
+
async function debounce() {
|
|
29
|
+
const now = Date.now();
|
|
30
|
+
const timeSinceLastQuery = now - lastQuery;
|
|
31
|
+
if (timeSinceLastQuery >= rateLimit) {
|
|
32
|
+
lastQuery = now;
|
|
33
|
+
} else {
|
|
34
|
+
const timeUntilNextQuery = rateLimit - timeSinceLastQuery;
|
|
35
|
+
lastQuery += timeUntilNextQuery;
|
|
36
|
+
await sleep(timeUntilNextQuery);
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
function createDebounceFetcher(fetcher2 = fetch) {
|
|
40
|
+
return async function debounceFetcher(...args) {
|
|
41
|
+
await debounce();
|
|
42
|
+
return fetcher2(...args);
|
|
43
|
+
};
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// src/fetcher/page.result.ts
|
|
47
|
+
var MagicPageResult = class {
|
|
48
|
+
constructor(apiPath, query) {
|
|
49
|
+
this.apiPath = apiPath;
|
|
50
|
+
this.query = query;
|
|
51
|
+
this.#hasMore = true;
|
|
52
|
+
this.#count = 0;
|
|
53
|
+
}
|
|
54
|
+
#count;
|
|
55
|
+
#hasMore;
|
|
56
|
+
get count() {
|
|
57
|
+
return this.#count;
|
|
58
|
+
}
|
|
59
|
+
get hasMore() {
|
|
60
|
+
return this.#hasMore;
|
|
61
|
+
}
|
|
62
|
+
async all() {
|
|
63
|
+
const r = [];
|
|
64
|
+
while (this.#hasMore) {
|
|
65
|
+
const result = await this.next();
|
|
66
|
+
r.push(...result);
|
|
67
|
+
}
|
|
68
|
+
return r;
|
|
69
|
+
}
|
|
70
|
+
async get(limit) {
|
|
71
|
+
const r = [];
|
|
72
|
+
while (this.#hasMore) {
|
|
73
|
+
const result = await this.next();
|
|
74
|
+
r.push(...result);
|
|
75
|
+
if (r.length === limit) {
|
|
76
|
+
return r;
|
|
77
|
+
}
|
|
78
|
+
if (r.length > limit) {
|
|
79
|
+
return r.slice(0, limit);
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
return r;
|
|
83
|
+
}
|
|
84
|
+
async next() {
|
|
85
|
+
const results = await fetcher(this.apiPath, this.query);
|
|
86
|
+
this.#hasMore = results?.has_more ?? false;
|
|
87
|
+
this.#count = Number.parseInt(`${results?.total_cards ?? 0}`, 10);
|
|
88
|
+
if (this.#hasMore) {
|
|
89
|
+
this.setNextPage();
|
|
90
|
+
}
|
|
91
|
+
return results?.data ?? [];
|
|
92
|
+
}
|
|
93
|
+
async page(page) {
|
|
94
|
+
this.query.page = page;
|
|
95
|
+
return this.next();
|
|
96
|
+
}
|
|
97
|
+
setNextPage() {
|
|
98
|
+
this.query.page += 1;
|
|
99
|
+
}
|
|
100
|
+
};
|
|
101
|
+
|
|
102
|
+
// src/fetcher/retry.fetcher.ts
|
|
103
|
+
var defaultCanRetry = async (response) => {
|
|
104
|
+
const object = await response.json();
|
|
105
|
+
const status = "status" in object ? Number(object.status) : void 0;
|
|
106
|
+
if (status && status >= 500) {
|
|
107
|
+
return true;
|
|
108
|
+
}
|
|
109
|
+
const code = "code" in object && typeof object.code === "string" ? object.code : void 0;
|
|
110
|
+
return code !== "not_found" && code !== "bad_request";
|
|
111
|
+
};
|
|
112
|
+
function createRetryFetcher({ maxAttempts = 3, canRetry = defaultCanRetry } = {}, fetcher2 = fetch) {
|
|
113
|
+
let retries = 0;
|
|
114
|
+
return async function retryFetcher(...args) {
|
|
115
|
+
retries++;
|
|
116
|
+
const response = await fetcher2(...args);
|
|
117
|
+
if (response.ok) {
|
|
118
|
+
return response;
|
|
119
|
+
}
|
|
120
|
+
const object = await response.json();
|
|
121
|
+
const code = "code" in object && typeof object.code === "string" ? object.code : void 0;
|
|
122
|
+
const status = "status" in object ? Number(object.status) : void 0;
|
|
123
|
+
const details = "details" in object && typeof object.details === "string" ? object.details : void 0;
|
|
124
|
+
const type = "type" in object && typeof object.type === "string" ? object.type : void 0;
|
|
125
|
+
const warnings = "warnings" in object && Array.isArray(object.warnings) ? object.warnings : void 0;
|
|
126
|
+
if (retries >= maxAttempts) {
|
|
127
|
+
if (code && details && status) {
|
|
128
|
+
throw new ScryfallError(code, details, status, type, warnings);
|
|
129
|
+
}
|
|
130
|
+
throw new UnknownScryfallError(`Request failed with status ${response.status}`);
|
|
131
|
+
}
|
|
132
|
+
if (canRetry(response)) {
|
|
133
|
+
return retryFetcher(...args);
|
|
134
|
+
}
|
|
135
|
+
if (code && details && status) {
|
|
136
|
+
throw new ScryfallError(code, details, status, type, warnings);
|
|
137
|
+
}
|
|
138
|
+
throw new UnknownScryfallError(`Request failed with status ${response.status}`);
|
|
139
|
+
};
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
// src/fetcher/index.ts
|
|
143
|
+
var simpleFetcher = createDebounceFetcher(createRetryFetcher());
|
|
144
|
+
var endpoint = "https://api.scryfall.com";
|
|
145
|
+
var DATE_REGEXP = /^\d{4}-\d{2}-\d{2}?$/;
|
|
146
|
+
var dateParser = (_key, value) => {
|
|
147
|
+
if (typeof value === "string") {
|
|
148
|
+
if (DATE_REGEXP.test(value)) {
|
|
149
|
+
return new Date(value);
|
|
150
|
+
}
|
|
151
|
+
}
|
|
152
|
+
return value;
|
|
153
|
+
};
|
|
154
|
+
async function fetcher(apiPath, params, body) {
|
|
155
|
+
let path = "";
|
|
156
|
+
if (typeof apiPath === "number" || typeof apiPath === "string") {
|
|
157
|
+
path = apiPath;
|
|
158
|
+
} else if (apiPath) {
|
|
159
|
+
path = apiPath.join("/");
|
|
160
|
+
}
|
|
161
|
+
const url = new URL(`${endpoint}/${path}`);
|
|
162
|
+
if (params) {
|
|
163
|
+
Object.entries(params).forEach(([key, value]) => {
|
|
164
|
+
if (value !== void 0) {
|
|
165
|
+
url.searchParams.append(key, `${value}`);
|
|
166
|
+
}
|
|
167
|
+
});
|
|
168
|
+
}
|
|
169
|
+
try {
|
|
170
|
+
const init = {
|
|
171
|
+
method: body ? "POST" : "GET"
|
|
172
|
+
};
|
|
173
|
+
if (body) {
|
|
174
|
+
init.body = JSON.stringify(body);
|
|
175
|
+
init.headers = {
|
|
176
|
+
"Content-Type": "application/json"
|
|
177
|
+
};
|
|
178
|
+
}
|
|
179
|
+
const response = await simpleFetcher(url, init);
|
|
180
|
+
const content = await response.text();
|
|
181
|
+
return JSON.parse(content, dateParser);
|
|
182
|
+
} catch (e) {
|
|
183
|
+
if (e instanceof ScryfallError) {
|
|
184
|
+
if (e.warnings) {
|
|
185
|
+
console.warn(e.warnings);
|
|
186
|
+
}
|
|
187
|
+
if (e.code === "not_found" || e.code === "bad_request") {
|
|
188
|
+
return void 0;
|
|
189
|
+
}
|
|
190
|
+
}
|
|
191
|
+
throw e;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
// src/api/card/card.api.ts
|
|
196
|
+
var CardApi = class {
|
|
197
|
+
/*
|
|
198
|
+
* Returns up to 20 full English card names that could be autocompletions of the given string parameter.
|
|
199
|
+
* @param {string} name
|
|
200
|
+
* The string to search for
|
|
201
|
+
* @returns {Promise<string[]>}
|
|
202
|
+
* A list of up to 20 full English card names.
|
|
203
|
+
*/
|
|
204
|
+
async autoCompleteName(name) {
|
|
205
|
+
const result = await fetcher("cards/autocomplete", {
|
|
206
|
+
q: name
|
|
207
|
+
});
|
|
208
|
+
return result?.data ?? [];
|
|
209
|
+
}
|
|
210
|
+
/*
|
|
211
|
+
* Returns a single card with the given Magic: The Gathering Arena ID.
|
|
212
|
+
* @param {number} id
|
|
213
|
+
* The Magic: The Gathering Arena ID of the card to retrieve.
|
|
214
|
+
* @returns {Promise<Card | undefined>}
|
|
215
|
+
* Returns a single card or undefined if no card is found.
|
|
216
|
+
*/
|
|
217
|
+
async byArenaId(id) {
|
|
218
|
+
return fetcher(["cards/arena", id]);
|
|
219
|
+
}
|
|
220
|
+
/*
|
|
221
|
+
* Returns a single card with the given Scryfall ID.
|
|
222
|
+
* @param {number} id
|
|
223
|
+
* The Scryfall ID.
|
|
224
|
+
* @returns {Promise<Card | undefined>}
|
|
225
|
+
* Returns a single card or undefined if no card is found.
|
|
226
|
+
*/
|
|
227
|
+
async byId(id) {
|
|
228
|
+
return fetcher(["cards", id]);
|
|
229
|
+
}
|
|
230
|
+
async byMtgoId(id) {
|
|
231
|
+
return fetcher(["cards/mtgo", id]);
|
|
232
|
+
}
|
|
233
|
+
async byMultiverseId(id) {
|
|
234
|
+
return fetcher(["cards/multiverse", id]);
|
|
235
|
+
}
|
|
236
|
+
async byName(name, set2, fuzzy = false) {
|
|
237
|
+
let f = fuzzy;
|
|
238
|
+
let s = set2;
|
|
239
|
+
if (typeof set2 === "boolean") {
|
|
240
|
+
f = set2;
|
|
241
|
+
s = void 0;
|
|
242
|
+
}
|
|
243
|
+
return fetcher("cards/named", {
|
|
244
|
+
[f ? "fuzzy" : "exact"]: name,
|
|
245
|
+
set: s
|
|
246
|
+
});
|
|
247
|
+
}
|
|
248
|
+
async bySet(setCode, collectorNumber, lang) {
|
|
249
|
+
const path = ["cards", setCode, collectorNumber];
|
|
250
|
+
if (lang) {
|
|
251
|
+
path.push(lang);
|
|
252
|
+
}
|
|
253
|
+
return fetcher(path);
|
|
254
|
+
}
|
|
255
|
+
async byTcgPlayerId(id) {
|
|
256
|
+
return fetcher(["cards/tcgplayer", id]);
|
|
257
|
+
}
|
|
258
|
+
async collection(...identifiers) {
|
|
259
|
+
const cards2 = [];
|
|
260
|
+
for (let i = 0; i < identifiers.length; i += 75) {
|
|
261
|
+
const collectionSection = { identifiers: identifiers.slice(i, i + 75) };
|
|
262
|
+
const result = await fetcher(
|
|
263
|
+
"cards/collection",
|
|
264
|
+
void 0,
|
|
265
|
+
collectionSection
|
|
266
|
+
);
|
|
267
|
+
cards2.push(...result?.data ?? []);
|
|
268
|
+
}
|
|
269
|
+
return cards2;
|
|
270
|
+
}
|
|
271
|
+
async random() {
|
|
272
|
+
return fetcher("cards/random");
|
|
273
|
+
}
|
|
274
|
+
search(query, options) {
|
|
275
|
+
return new MagicPageResult("cards/search", {
|
|
276
|
+
q: query,
|
|
277
|
+
...typeof options === "number" ? { page: options } : { ...options, page: options?.page ?? 1 }
|
|
278
|
+
});
|
|
279
|
+
}
|
|
280
|
+
};
|
|
281
|
+
var cards = new CardApi();
|
|
282
|
+
var card_api_default = cards;
|
|
283
|
+
|
|
284
|
+
// src/api/card/index.ts
|
|
285
|
+
var card_default = card_api_default;
|
|
286
|
+
|
|
287
|
+
// src/api/card-identifier/card-identifier.api.ts
|
|
288
|
+
var CardIdentifierApi = class {
|
|
289
|
+
static byId(id) {
|
|
290
|
+
return { id };
|
|
291
|
+
}
|
|
292
|
+
static byIllustrationId(id) {
|
|
293
|
+
return { illustration_id: id };
|
|
294
|
+
}
|
|
295
|
+
static byMtgoId(id) {
|
|
296
|
+
return { mtgo_id: id };
|
|
297
|
+
}
|
|
298
|
+
static byMultiverseId(id) {
|
|
299
|
+
return { multiverse_id: id };
|
|
300
|
+
}
|
|
301
|
+
static byName(name, set2) {
|
|
302
|
+
if (set2) {
|
|
303
|
+
return { name, set: set2 };
|
|
304
|
+
}
|
|
305
|
+
return { name };
|
|
306
|
+
}
|
|
307
|
+
static byOracleId(id) {
|
|
308
|
+
return { oracle_id: id };
|
|
309
|
+
}
|
|
310
|
+
static bySet(set2, collectorNumber) {
|
|
311
|
+
return { collector_number: `${collectorNumber}`, set: set2 };
|
|
312
|
+
}
|
|
313
|
+
};
|
|
314
|
+
|
|
315
|
+
// src/api/card-identifier/index.ts
|
|
316
|
+
var card_identifier_default = CardIdentifierApi;
|
|
317
|
+
|
|
318
|
+
// src/api/catalog/catalog.api.ts
|
|
319
|
+
var CatalogApi = class {
|
|
320
|
+
async artifactTypes() {
|
|
321
|
+
return (await fetcher("catalog/artifact-types"))?.data ?? [];
|
|
322
|
+
}
|
|
323
|
+
async artistNames() {
|
|
324
|
+
return (await fetcher("catalog/artist-names"))?.data ?? [];
|
|
325
|
+
}
|
|
326
|
+
async cardNames() {
|
|
327
|
+
return (await fetcher("catalog/card-names"))?.data ?? [];
|
|
328
|
+
}
|
|
329
|
+
async creatureTypes() {
|
|
330
|
+
return (await fetcher("catalog/creature-types"))?.data ?? [];
|
|
331
|
+
}
|
|
332
|
+
async enchantmentTypes() {
|
|
333
|
+
return (await fetcher("catalog/enchantment-types"))?.data ?? [];
|
|
334
|
+
}
|
|
335
|
+
async landTypes() {
|
|
336
|
+
return (await fetcher("catalog/land-types"))?.data ?? [];
|
|
337
|
+
}
|
|
338
|
+
async loyalties() {
|
|
339
|
+
return (await fetcher("catalog/loyalties"))?.data ?? [];
|
|
340
|
+
}
|
|
341
|
+
async planeswalkerTypes() {
|
|
342
|
+
return (await fetcher("catalog/planeswalker-types"))?.data ?? [];
|
|
343
|
+
}
|
|
344
|
+
async powers() {
|
|
345
|
+
return (await fetcher("catalog/powers"))?.data ?? [];
|
|
346
|
+
}
|
|
347
|
+
async spellTypes() {
|
|
348
|
+
return (await fetcher("catalog/spell-types"))?.data ?? [];
|
|
349
|
+
}
|
|
350
|
+
async toughnesses() {
|
|
351
|
+
return (await fetcher("catalog/toughnesses"))?.data ?? [];
|
|
352
|
+
}
|
|
353
|
+
async watermarks() {
|
|
354
|
+
return (await fetcher("catalog/watermarks"))?.data ?? [];
|
|
355
|
+
}
|
|
356
|
+
async wordBank() {
|
|
357
|
+
return (await fetcher("catalog/word-bank"))?.data ?? [];
|
|
358
|
+
}
|
|
359
|
+
};
|
|
360
|
+
var catalog = new CatalogApi();
|
|
361
|
+
var catalog_api_default = catalog;
|
|
362
|
+
|
|
363
|
+
// src/api/catalog/index.ts
|
|
364
|
+
var catalog_default = catalog_api_default;
|
|
365
|
+
|
|
366
|
+
// src/api/ruling/ruling.api.ts
|
|
367
|
+
var RulingApi = class {
|
|
368
|
+
async byArenaId(id) {
|
|
369
|
+
return (await fetcher(["cards/arena", id, "rulings"]))?.data ?? [];
|
|
370
|
+
}
|
|
371
|
+
async byId(id) {
|
|
372
|
+
return (await fetcher(["cards", id, "rulings"]))?.data ?? [];
|
|
373
|
+
}
|
|
374
|
+
async byMtgoId(id) {
|
|
375
|
+
return (await fetcher(["cards/mtgo", id, "rulings"]))?.data ?? [];
|
|
376
|
+
}
|
|
377
|
+
async byMultiverseId(id) {
|
|
378
|
+
return (await fetcher(["cards/multiverse", id, "rulings"]))?.data ?? [];
|
|
379
|
+
}
|
|
380
|
+
async bySet(setCode, collectorNumber) {
|
|
381
|
+
return (await fetcher(["cards", setCode, `${collectorNumber}`, "rulings"]))?.data ?? [];
|
|
382
|
+
}
|
|
383
|
+
};
|
|
384
|
+
var rulings = new RulingApi();
|
|
385
|
+
var ruling_api_default = rulings;
|
|
386
|
+
|
|
387
|
+
// src/api/ruling/index.ts
|
|
388
|
+
var ruling_default = ruling_api_default;
|
|
389
|
+
|
|
390
|
+
// src/api/set/set.api.ts
|
|
391
|
+
var SetApi = class {
|
|
392
|
+
async all() {
|
|
393
|
+
const result = await fetcher("sets");
|
|
394
|
+
return result?.data ?? [];
|
|
395
|
+
}
|
|
396
|
+
async byCode(code) {
|
|
397
|
+
return await fetcher(["sets", code]);
|
|
398
|
+
}
|
|
399
|
+
async byId(id) {
|
|
400
|
+
return fetcher(["sets", id]);
|
|
401
|
+
}
|
|
402
|
+
async byTcgPlayerId(id) {
|
|
403
|
+
return fetcher(["sets/tcgplayer", id]);
|
|
404
|
+
}
|
|
405
|
+
};
|
|
406
|
+
var set = new SetApi();
|
|
407
|
+
var set_api_default = set;
|
|
408
|
+
|
|
409
|
+
// src/api/set/index.ts
|
|
410
|
+
var set_default = set_api_default;
|
|
411
|
+
|
|
412
|
+
// src/api/symbology/symbology.api.ts
|
|
413
|
+
var SymbologyApi = class {
|
|
414
|
+
async all() {
|
|
415
|
+
const list = await fetcher("symbology");
|
|
416
|
+
return list?.data ?? [];
|
|
417
|
+
}
|
|
418
|
+
async parseMana(shorthand) {
|
|
419
|
+
if (!shorthand || typeof shorthand !== "string") {
|
|
420
|
+
throw new InvalidScryfallArgumentError("shorthand must be a string");
|
|
421
|
+
}
|
|
422
|
+
const cost = await fetcher("symbology/parse-mana", {
|
|
423
|
+
cost: shorthand
|
|
424
|
+
});
|
|
425
|
+
return cost ?? {
|
|
426
|
+
cost: "",
|
|
427
|
+
colors: [],
|
|
428
|
+
cmc: 0,
|
|
429
|
+
colorless: false,
|
|
430
|
+
monocolored: false,
|
|
431
|
+
multicolored: false,
|
|
432
|
+
object: "mana_cost"
|
|
433
|
+
};
|
|
434
|
+
}
|
|
435
|
+
};
|
|
436
|
+
var symbology = new SymbologyApi();
|
|
437
|
+
var symbology_api_default = symbology;
|
|
438
|
+
|
|
439
|
+
// src/api/symbology/index.ts
|
|
440
|
+
var symbology_default = symbology_api_default;
|
|
441
|
+
export {
|
|
442
|
+
card_identifier_default as CardIdentifierBuilder,
|
|
443
|
+
card_default as Cards,
|
|
444
|
+
catalog_default as Catalogs,
|
|
445
|
+
InvalidScryfallArgumentError,
|
|
446
|
+
MagicPageResult,
|
|
447
|
+
ruling_default as Rulings,
|
|
448
|
+
ScryfallError,
|
|
449
|
+
set_default as Sets,
|
|
450
|
+
symbology_default as SymbologyApi,
|
|
451
|
+
UnknownScryfallError
|
|
452
|
+
};
|
|
@@ -0,0 +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});
|
|
@@ -0,0 +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};
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "scryfall-api",
|
|
3
|
-
"version": "4.0.0-beta.
|
|
3
|
+
"version": "4.0.0-beta.2",
|
|
4
4
|
"description": "A Javascript library for https://scryfall.com/docs/api written in Typescript.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"magic",
|
|
@@ -42,6 +42,7 @@
|
|
|
42
42
|
"build": "tsup",
|
|
43
43
|
"lint": "eslint .",
|
|
44
44
|
"lint:fix": "eslint --fix .",
|
|
45
|
+
"prepublishOnly": "tsup",
|
|
45
46
|
"test": "bun test",
|
|
46
47
|
"typecheck": "tsc --noEmit"
|
|
47
48
|
},
|
|
@@ -49,9 +50,9 @@
|
|
|
49
50
|
"@changesets/cli": "2.27.1",
|
|
50
51
|
"@hexatool/eslint-config": "2.3.0",
|
|
51
52
|
"@hexatool/tsconfig": "20.0.1",
|
|
52
|
-
"@types/bun": "1.
|
|
53
|
+
"@types/bun": "1.1.2",
|
|
53
54
|
"eslint": "8.57.0",
|
|
54
55
|
"tsup": "8.0.2",
|
|
55
|
-
"typescript": "5.
|
|
56
|
+
"typescript": "5.4.5"
|
|
56
57
|
}
|
|
57
58
|
}
|