tcgpriser 1.0.0 → 1.1.0

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/index.d.cts CHANGED
@@ -141,7 +141,8 @@ interface components {
141
141
  /** @example pokemon */
142
142
  technicalName: string;
143
143
  /**
144
- * @description Absolute asset URL, or undefined when absent.
144
+ * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
145
+ * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
145
146
  */
146
147
  imageUrl: string | undefined;
147
148
  /**
@@ -303,6 +304,7 @@ interface components {
303
304
  shortName: string;
304
305
  /** @example jpn-mega-evolution-30th-celebration */
305
306
  technicalName: string;
307
+ brand: components["schemas"]["Brand"];
306
308
  /**
307
309
  * @description Printing language of the item
308
310
  * @example JPN
@@ -315,6 +317,19 @@ interface components {
315
317
  cardCode: string | undefined;
316
318
  /** @example Mega Evolution */
317
319
  seriesName: string | undefined;
320
+ /** @example The Lord of the Rings: Tales of Middle-earth */
321
+ releaseGroupName: string | undefined;
322
+ releaseGroup: {
323
+ /**
324
+ * @description Resource identifier
325
+ * @example 6a577711abc1ce71383d3e10
326
+ */
327
+ id: string;
328
+ /** @example The Lord of the Rings: Tales of Middle-earth */
329
+ name: string;
330
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
331
+ technicalName: string;
332
+ } | undefined;
318
333
  /**
319
334
  * Format: date-time
320
335
  * @example 2026-07-15T12:03:29.322Z
@@ -336,7 +351,6 @@ interface components {
336
351
  */
337
352
  imageUrl: string | undefined;
338
353
  year: number | undefined;
339
- brand: components["schemas"]["Brand"];
340
354
  alternativeNames: components["schemas"]["AlternativeName"][];
341
355
  /** @description Sealed products in this expansion */
342
356
  sealedCount: number;
@@ -373,9 +387,6 @@ interface components {
373
387
  shortName: string;
374
388
  /** @example jpn-mega-evolution-30th-celebration */
375
389
  technicalName: string;
376
- /**
377
- * @description The expansion's owning brand. Undefined only for legacy diagnostic responses that cannot populate it.
378
- */
379
390
  brand: components["schemas"]["Brand"] | undefined;
380
391
  /**
381
392
  * @description Printing language of the item
@@ -389,6 +400,19 @@ interface components {
389
400
  cardCode: string | undefined;
390
401
  /** @example Mega Evolution */
391
402
  seriesName: string | undefined;
403
+ /** @example The Lord of the Rings: Tales of Middle-earth */
404
+ releaseGroupName: string | undefined;
405
+ releaseGroup: {
406
+ /**
407
+ * @description Resource identifier
408
+ * @example 6a577711abc1ce71383d3e10
409
+ */
410
+ id: string;
411
+ /** @example The Lord of the Rings: Tales of Middle-earth */
412
+ name: string;
413
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
414
+ technicalName: string;
415
+ } | undefined;
392
416
  /**
393
417
  * Format: date-time
394
418
  * @example 2026-07-15T12:03:29.322Z
@@ -410,6 +434,10 @@ interface components {
410
434
  */
411
435
  imageUrl: string | undefined;
412
436
  };
437
+ ExpansionReleaseGroup: {
438
+ releaseGroupName: string | undefined;
439
+ expansions: components["schemas"]["Expansion"][];
440
+ };
413
441
  ItemDailyStats: {
414
442
  item: components["schemas"]["CatalogItemRef"];
415
443
  dailyStats: components["schemas"]["DailyPricePoint"][];
@@ -687,11 +715,11 @@ interface components {
687
715
  };
688
716
  ReferencePriceSeries: {
689
717
  /** @enum {string} */
690
- source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
718
+ source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker" | "scryfall";
691
719
  /** @enum {string} */
692
720
  provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
693
721
  /** @enum {string|null} */
694
- variant: "normal" | "holo" | "reverse" | undefined;
722
+ variant: "normal" | "holo" | "reverse" | "foil" | undefined;
695
723
  /** @enum {string|null} */
696
724
  cardType: "loose" | "graded" | undefined;
697
725
  /** @enum {string|null} */
@@ -1351,7 +1379,8 @@ type BrandRef = {
1351
1379
  /** @example pokemon */
1352
1380
  technicalName: string;
1353
1381
  /**
1354
- * @description Absolute asset URL, or undefined when absent.
1382
+ * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
1383
+ * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
1355
1384
  */
1356
1385
  imageUrl: string | undefined;
1357
1386
  /**
@@ -1391,9 +1420,6 @@ type ExpansionRef = {
1391
1420
  shortName: string;
1392
1421
  /** @example jpn-mega-evolution-30th-celebration */
1393
1422
  technicalName: string;
1394
- /**
1395
- * @description The expansion's owning brand. Undefined only for legacy diagnostic responses that cannot populate it.
1396
- */
1397
1423
  brand: BrandRef | undefined;
1398
1424
  /**
1399
1425
  * @description Printing language of the item
@@ -1407,6 +1433,19 @@ type ExpansionRef = {
1407
1433
  cardCode: string | undefined;
1408
1434
  /** @example Mega Evolution */
1409
1435
  seriesName: string | undefined;
1436
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1437
+ releaseGroupName: string | undefined;
1438
+ releaseGroup: {
1439
+ /**
1440
+ * @description Resource identifier
1441
+ * @example 6a577711abc1ce71383d3e10
1442
+ */
1443
+ id: string;
1444
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1445
+ name: string;
1446
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
1447
+ technicalName: string;
1448
+ } | undefined;
1410
1449
  /**
1411
1450
  * Format: date-time
1412
1451
  * @example 2026-07-15T12:03:29.322Z
@@ -1486,7 +1525,8 @@ type Brand = {
1486
1525
  /** @example pokemon */
1487
1526
  technicalName: string;
1488
1527
  /**
1489
- * @description Absolute asset URL, or undefined when absent.
1528
+ * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
1529
+ * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
1490
1530
  */
1491
1531
  imageUrl: string | undefined;
1492
1532
  /**
@@ -1756,6 +1796,7 @@ type Expansion = {
1756
1796
  shortName: string;
1757
1797
  /** @example jpn-mega-evolution-30th-celebration */
1758
1798
  technicalName: string;
1799
+ brand: BrandRef;
1759
1800
  /**
1760
1801
  * @description Printing language of the item
1761
1802
  * @example JPN
@@ -1768,6 +1809,19 @@ type Expansion = {
1768
1809
  cardCode: string | undefined;
1769
1810
  /** @example Mega Evolution */
1770
1811
  seriesName: string | undefined;
1812
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1813
+ releaseGroupName: string | undefined;
1814
+ releaseGroup: {
1815
+ /**
1816
+ * @description Resource identifier
1817
+ * @example 6a577711abc1ce71383d3e10
1818
+ */
1819
+ id: string;
1820
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1821
+ name: string;
1822
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
1823
+ technicalName: string;
1824
+ } | undefined;
1771
1825
  /**
1772
1826
  * Format: date-time
1773
1827
  * @example 2026-07-15T12:03:29.322Z
@@ -1789,7 +1843,6 @@ type Expansion = {
1789
1843
  */
1790
1844
  imageUrl: string | undefined;
1791
1845
  year: number | undefined;
1792
- brand: BrandRef;
1793
1846
  alternativeNames: AlternativeName[];
1794
1847
  /** @description Sealed products in this expansion */
1795
1848
  sealedCount: number;
@@ -1808,6 +1861,13 @@ type Expansion = {
1808
1861
  */
1809
1862
  updatedAt: string;
1810
1863
  };
1864
+ /** `client.expansions.releaseGroup()`: the other expansions in a release group (e.g. a core set's
1865
+ * variant drops), excluding the requested expansion itself. Empty `expansions` and undefined
1866
+ * `releaseGroupName` when the expansion isn't part of a release group. */
1867
+ type ExpansionReleaseGroup = {
1868
+ releaseGroupName: string | undefined;
1869
+ expansions: Expansion[];
1870
+ };
1811
1871
  type ShopMatchWithItemSchema = {
1812
1872
  /**
1813
1873
  * @description Resource identifier
@@ -2179,11 +2239,11 @@ type PlatformStats = {
2179
2239
  */
2180
2240
  type ReferencePriceSeries = {
2181
2241
  /** @enum {string} */
2182
- source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
2242
+ source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker" | "scryfall";
2183
2243
  /** @enum {string} */
2184
2244
  provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
2185
2245
  /** @enum {string|null} */
2186
- variant: "normal" | "holo" | "reverse" | undefined;
2246
+ variant: "normal" | "holo" | "reverse" | "foil" | undefined;
2187
2247
  /** @enum {string|null} */
2188
2248
  cardType: "loose" | "graded" | undefined;
2189
2249
  /** @enum {string|null} */
@@ -2201,8 +2261,8 @@ type ReferencePriceSeriesPoint = {
2201
2261
  snapshotDate: string;
2202
2262
  price: number;
2203
2263
  };
2204
- type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi" | "pokemonpricetracker";
2205
- type ReferencePriceCardVariant = "reverse" | "normal" | "holo";
2264
+ type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi" | "pokemonpricetracker" | "scryfall";
2265
+ type ReferencePriceCardVariant = "reverse" | "normal" | "holo" | "foil";
2206
2266
  type ReferencePriceMetric = "price" | "low" | "mid" | "high" | "avg" | "avg1" | "avg7" | "avg30" | "directLow";
2207
2267
  type ReferencePriceCurrencyMode = "native" | "sek";
2208
2268
  /** Response of `client.cards.referencePrices()` / `client.products.referencePrices()`.
@@ -2867,6 +2927,9 @@ declare class ExpansionsResource {
2867
2927
  * pricing too. Sealed products are a separate call — see `sealedProducts()` — never merged into
2868
2928
  * this one. */
2869
2929
  cards(technicalName: string, options?: RequestOptions): Promise<ListResponse<Card>>;
2930
+ /** `GET /expansions/{technicalName}/release-group`: the other expansions in this expansion's
2931
+ * release group (e.g. a core set's variant drops), excluding the requested expansion itself. */
2932
+ releaseGroup(technicalName: string, options?: RequestOptions): Promise<ExpansionReleaseGroup>;
2870
2933
  /** `GET /expansions/{technicalName}/products`: every sealed product in this expansion. Content
2871
2934
  * only, no pricing fields — pass the `id`s from the result to `client.products.pricingBatch()`
2872
2935
  * if you need pricing too. Cards are a separate call — see `cards()` — never merged into this
@@ -3361,4 +3424,4 @@ declare class TcgPriserError extends Error {
3361
3424
  creditsRemaining?: number;
3362
3425
  });
3363
3426
  }
3364
- export { type Acknowledgement, type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type Brand, type BrandRef, type Card, type CardDailyStatsParams, type CardEstimatedValuesParams, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CatalogSlug, type CategoryRef, type CompareShopPricesParams, type CreateWebhookParams, type CurrencyCode, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionLivePricing, type ExpansionRef, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyPriceStatsParams, type ProductDailyStatsParams, type ProductEstimatedValuesParams, type ProductFilterParams, type ProductLine, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type RequestOptions, type ResourceId, type SealedProduct, type SearchBargainsParams, type SearchCardsParams, type SearchProductsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, type TcgPriserAdvancedOptions, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type Webhook, type WebhookDeliveryStatus, type WebhookEvent, type WebhookTestResult, type WebhookWithSecret, type components };
3427
+ export { type Acknowledgement, type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type Brand, type BrandRef, type Card, type CardDailyStatsParams, type CardEstimatedValuesParams, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CatalogSlug, type CategoryRef, type CompareShopPricesParams, type CreateWebhookParams, type CurrencyCode, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionLivePricing, type ExpansionRef, type ExpansionReleaseGroup, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyPriceStatsParams, type ProductDailyStatsParams, type ProductEstimatedValuesParams, type ProductFilterParams, type ProductLine, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type RequestOptions, type ResourceId, type SealedProduct, type SearchBargainsParams, type SearchCardsParams, type SearchProductsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, type TcgPriserAdvancedOptions, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type Webhook, type WebhookDeliveryStatus, type WebhookEvent, type WebhookTestResult, type WebhookWithSecret, type components };
package/dist/index.d.ts CHANGED
@@ -141,7 +141,8 @@ interface components {
141
141
  /** @example pokemon */
142
142
  technicalName: string;
143
143
  /**
144
- * @description Absolute asset URL, or undefined when absent.
144
+ * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
145
+ * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
145
146
  */
146
147
  imageUrl: string | undefined;
147
148
  /**
@@ -303,6 +304,7 @@ interface components {
303
304
  shortName: string;
304
305
  /** @example jpn-mega-evolution-30th-celebration */
305
306
  technicalName: string;
307
+ brand: components["schemas"]["Brand"];
306
308
  /**
307
309
  * @description Printing language of the item
308
310
  * @example JPN
@@ -315,6 +317,19 @@ interface components {
315
317
  cardCode: string | undefined;
316
318
  /** @example Mega Evolution */
317
319
  seriesName: string | undefined;
320
+ /** @example The Lord of the Rings: Tales of Middle-earth */
321
+ releaseGroupName: string | undefined;
322
+ releaseGroup: {
323
+ /**
324
+ * @description Resource identifier
325
+ * @example 6a577711abc1ce71383d3e10
326
+ */
327
+ id: string;
328
+ /** @example The Lord of the Rings: Tales of Middle-earth */
329
+ name: string;
330
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
331
+ technicalName: string;
332
+ } | undefined;
318
333
  /**
319
334
  * Format: date-time
320
335
  * @example 2026-07-15T12:03:29.322Z
@@ -336,7 +351,6 @@ interface components {
336
351
  */
337
352
  imageUrl: string | undefined;
338
353
  year: number | undefined;
339
- brand: components["schemas"]["Brand"];
340
354
  alternativeNames: components["schemas"]["AlternativeName"][];
341
355
  /** @description Sealed products in this expansion */
342
356
  sealedCount: number;
@@ -373,9 +387,6 @@ interface components {
373
387
  shortName: string;
374
388
  /** @example jpn-mega-evolution-30th-celebration */
375
389
  technicalName: string;
376
- /**
377
- * @description The expansion's owning brand. Undefined only for legacy diagnostic responses that cannot populate it.
378
- */
379
390
  brand: components["schemas"]["Brand"] | undefined;
380
391
  /**
381
392
  * @description Printing language of the item
@@ -389,6 +400,19 @@ interface components {
389
400
  cardCode: string | undefined;
390
401
  /** @example Mega Evolution */
391
402
  seriesName: string | undefined;
403
+ /** @example The Lord of the Rings: Tales of Middle-earth */
404
+ releaseGroupName: string | undefined;
405
+ releaseGroup: {
406
+ /**
407
+ * @description Resource identifier
408
+ * @example 6a577711abc1ce71383d3e10
409
+ */
410
+ id: string;
411
+ /** @example The Lord of the Rings: Tales of Middle-earth */
412
+ name: string;
413
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
414
+ technicalName: string;
415
+ } | undefined;
392
416
  /**
393
417
  * Format: date-time
394
418
  * @example 2026-07-15T12:03:29.322Z
@@ -410,6 +434,10 @@ interface components {
410
434
  */
411
435
  imageUrl: string | undefined;
412
436
  };
437
+ ExpansionReleaseGroup: {
438
+ releaseGroupName: string | undefined;
439
+ expansions: components["schemas"]["Expansion"][];
440
+ };
413
441
  ItemDailyStats: {
414
442
  item: components["schemas"]["CatalogItemRef"];
415
443
  dailyStats: components["schemas"]["DailyPricePoint"][];
@@ -687,11 +715,11 @@ interface components {
687
715
  };
688
716
  ReferencePriceSeries: {
689
717
  /** @enum {string} */
690
- source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
718
+ source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker" | "scryfall";
691
719
  /** @enum {string} */
692
720
  provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
693
721
  /** @enum {string|null} */
694
- variant: "normal" | "holo" | "reverse" | undefined;
722
+ variant: "normal" | "holo" | "reverse" | "foil" | undefined;
695
723
  /** @enum {string|null} */
696
724
  cardType: "loose" | "graded" | undefined;
697
725
  /** @enum {string|null} */
@@ -1351,7 +1379,8 @@ type BrandRef = {
1351
1379
  /** @example pokemon */
1352
1380
  technicalName: string;
1353
1381
  /**
1354
- * @description Absolute asset URL, or undefined when absent.
1382
+ * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
1383
+ * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
1355
1384
  */
1356
1385
  imageUrl: string | undefined;
1357
1386
  /**
@@ -1391,9 +1420,6 @@ type ExpansionRef = {
1391
1420
  shortName: string;
1392
1421
  /** @example jpn-mega-evolution-30th-celebration */
1393
1422
  technicalName: string;
1394
- /**
1395
- * @description The expansion's owning brand. Undefined only for legacy diagnostic responses that cannot populate it.
1396
- */
1397
1423
  brand: BrandRef | undefined;
1398
1424
  /**
1399
1425
  * @description Printing language of the item
@@ -1407,6 +1433,19 @@ type ExpansionRef = {
1407
1433
  cardCode: string | undefined;
1408
1434
  /** @example Mega Evolution */
1409
1435
  seriesName: string | undefined;
1436
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1437
+ releaseGroupName: string | undefined;
1438
+ releaseGroup: {
1439
+ /**
1440
+ * @description Resource identifier
1441
+ * @example 6a577711abc1ce71383d3e10
1442
+ */
1443
+ id: string;
1444
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1445
+ name: string;
1446
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
1447
+ technicalName: string;
1448
+ } | undefined;
1410
1449
  /**
1411
1450
  * Format: date-time
1412
1451
  * @example 2026-07-15T12:03:29.322Z
@@ -1486,7 +1525,8 @@ type Brand = {
1486
1525
  /** @example pokemon */
1487
1526
  technicalName: string;
1488
1527
  /**
1489
- * @description Absolute asset URL, or undefined when absent.
1528
+ * @description Absolute asset URL, or null when absent. For best performance, please rehost this image on your own storage/CDN and cache it there rather than hotlinking it — see the API description's "Image hosting" section.
1529
+ * @example https://ik.imagekit.io/xgtytqdnv/expansions/example-image.webp
1490
1530
  */
1491
1531
  imageUrl: string | undefined;
1492
1532
  /**
@@ -1756,6 +1796,7 @@ type Expansion = {
1756
1796
  shortName: string;
1757
1797
  /** @example jpn-mega-evolution-30th-celebration */
1758
1798
  technicalName: string;
1799
+ brand: BrandRef;
1759
1800
  /**
1760
1801
  * @description Printing language of the item
1761
1802
  * @example JPN
@@ -1768,6 +1809,19 @@ type Expansion = {
1768
1809
  cardCode: string | undefined;
1769
1810
  /** @example Mega Evolution */
1770
1811
  seriesName: string | undefined;
1812
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1813
+ releaseGroupName: string | undefined;
1814
+ releaseGroup: {
1815
+ /**
1816
+ * @description Resource identifier
1817
+ * @example 6a577711abc1ce71383d3e10
1818
+ */
1819
+ id: string;
1820
+ /** @example The Lord of the Rings: Tales of Middle-earth */
1821
+ name: string;
1822
+ /** @example eng-the-lord-of-the-rings-tales-of-middle-earth */
1823
+ technicalName: string;
1824
+ } | undefined;
1771
1825
  /**
1772
1826
  * Format: date-time
1773
1827
  * @example 2026-07-15T12:03:29.322Z
@@ -1789,7 +1843,6 @@ type Expansion = {
1789
1843
  */
1790
1844
  imageUrl: string | undefined;
1791
1845
  year: number | undefined;
1792
- brand: BrandRef;
1793
1846
  alternativeNames: AlternativeName[];
1794
1847
  /** @description Sealed products in this expansion */
1795
1848
  sealedCount: number;
@@ -1808,6 +1861,13 @@ type Expansion = {
1808
1861
  */
1809
1862
  updatedAt: string;
1810
1863
  };
1864
+ /** `client.expansions.releaseGroup()`: the other expansions in a release group (e.g. a core set's
1865
+ * variant drops), excluding the requested expansion itself. Empty `expansions` and undefined
1866
+ * `releaseGroupName` when the expansion isn't part of a release group. */
1867
+ type ExpansionReleaseGroup = {
1868
+ releaseGroupName: string | undefined;
1869
+ expansions: Expansion[];
1870
+ };
1811
1871
  type ShopMatchWithItemSchema = {
1812
1872
  /**
1813
1873
  * @description Resource identifier
@@ -2179,11 +2239,11 @@ type PlatformStats = {
2179
2239
  */
2180
2240
  type ReferencePriceSeries = {
2181
2241
  /** @enum {string} */
2182
- source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker";
2242
+ source: "tcgdex" | "cmapi" | "tradera" | "pokemonpricetracker" | "scryfall";
2183
2243
  /** @enum {string} */
2184
2244
  provider: "cardmarket" | "tcgplayer" | "ebay" | "tradera";
2185
2245
  /** @enum {string|null} */
2186
- variant: "normal" | "holo" | "reverse" | undefined;
2246
+ variant: "normal" | "holo" | "reverse" | "foil" | undefined;
2187
2247
  /** @enum {string|null} */
2188
2248
  cardType: "loose" | "graded" | undefined;
2189
2249
  /** @enum {string|null} */
@@ -2201,8 +2261,8 @@ type ReferencePriceSeriesPoint = {
2201
2261
  snapshotDate: string;
2202
2262
  price: number;
2203
2263
  };
2204
- type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi" | "pokemonpricetracker";
2205
- type ReferencePriceCardVariant = "reverse" | "normal" | "holo";
2264
+ type ReferencePriceSource = "tradera" | "tcgdex" | "cmapi" | "pokemonpricetracker" | "scryfall";
2265
+ type ReferencePriceCardVariant = "reverse" | "normal" | "holo" | "foil";
2206
2266
  type ReferencePriceMetric = "price" | "low" | "mid" | "high" | "avg" | "avg1" | "avg7" | "avg30" | "directLow";
2207
2267
  type ReferencePriceCurrencyMode = "native" | "sek";
2208
2268
  /** Response of `client.cards.referencePrices()` / `client.products.referencePrices()`.
@@ -2867,6 +2927,9 @@ declare class ExpansionsResource {
2867
2927
  * pricing too. Sealed products are a separate call — see `sealedProducts()` — never merged into
2868
2928
  * this one. */
2869
2929
  cards(technicalName: string, options?: RequestOptions): Promise<ListResponse<Card>>;
2930
+ /** `GET /expansions/{technicalName}/release-group`: the other expansions in this expansion's
2931
+ * release group (e.g. a core set's variant drops), excluding the requested expansion itself. */
2932
+ releaseGroup(technicalName: string, options?: RequestOptions): Promise<ExpansionReleaseGroup>;
2870
2933
  /** `GET /expansions/{technicalName}/products`: every sealed product in this expansion. Content
2871
2934
  * only, no pricing fields — pass the `id`s from the result to `client.products.pricingBatch()`
2872
2935
  * if you need pricing too. Cards are a separate call — see `cards()` — never merged into this
@@ -3361,4 +3424,4 @@ declare class TcgPriserError extends Error {
3361
3424
  creditsRemaining?: number;
3362
3425
  });
3363
3426
  }
3364
- export { type Acknowledgement, type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type Brand, type BrandRef, type Card, type CardDailyStatsParams, type CardEstimatedValuesParams, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CatalogSlug, type CategoryRef, type CompareShopPricesParams, type CreateWebhookParams, type CurrencyCode, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionLivePricing, type ExpansionRef, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyPriceStatsParams, type ProductDailyStatsParams, type ProductEstimatedValuesParams, type ProductFilterParams, type ProductLine, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type RequestOptions, type ResourceId, type SealedProduct, type SearchBargainsParams, type SearchCardsParams, type SearchProductsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, type TcgPriserAdvancedOptions, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type Webhook, type WebhookDeliveryStatus, type WebhookEvent, type WebhookTestResult, type WebhookWithSecret, type components };
3427
+ export { type Acknowledgement, type AlternativeName, type AssignShopUrlProductParams, type Bargain, type BargainInfo, type BargainProductRef, type BargainReferenceSource, type Brand, type BrandRef, type Card, type CardDailyStatsParams, type CardEstimatedValuesParams, type CardMatchesParams, type CardPricesParams, type CardReferencePricesParams, type CardType, type CardVariants, type CatalogItem, type CatalogItemPricing, type CatalogSlug, type CategoryRef, type CompareShopPricesParams, type CreateWebhookParams, type CurrencyCode, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type DailyPricePoint, type DailyPriceStatsParams, type EstimatedValue, type EstimatedValuesParams, type Expansion, type ExpansionLivePricing, type ExpansionRef, type ExpansionReleaseGroup, type GradingCompany, type ItemCondition, type ItemDailyStats, type ItemEstimatedValue, type ItemFullStats, type ItemPriceComparison, type ItemRef, type ItemReferencePrices, type ItemShopMatch, type ItemShopMatches, type ItemShopPriceHistory, type ItemSoldPrices, type ItemStats, type ItemVariantDailyStats, type ItemVariantStats, type ListBargainsParams, type ListCardsParams, type ListProductsParams, type ListResponse, type ListShopMatchesParams, type ListShopsParams, type LivePricingDetail, type LivePricingForItem, type LowestShopOffer, type MatchShop, type MatchedItemRef, type PackRate, type PackRateBucket, type PackSlot, type PageMeta, type PaginationParams, type PlatformStats, type PremiumOptions, type PrintingLanguage, type ProductByVariantParams, type ProductDailyByVariantParams, type ProductDailyPriceStatsParams, type ProductDailyStatsParams, type ProductEstimatedValuesParams, type ProductFilterParams, type ProductLine, type ProductMatchesParams, type ProductPricesParams, type ProductReferencePricesParams, type ReferencePriceCardVariant, type ReferencePriceCurrencyMode, type ReferencePriceMetric, type ReferencePriceProvider, type ReferencePriceSeries, type ReferencePriceSeriesPoint, type ReferencePriceSnapshot, type ReferencePriceSnapshotsByProvider, type ReferencePriceSource, type RequestOptions, type ResourceId, type SealedProduct, type SearchBargainsParams, type SearchCardsParams, type SearchProductsParams, type Shop, type ShopItemPriceHistory, type ShopMatch, type ShopMatchDelivery, type ShopMatchStats, type ShopMatchStatsForProductParams, type ShopMatchStatsForShopParams, type ShopMatchesForShop, type ShopMatchesForShopParams, type ShopPriceComparisonRow, type ShopPriceComparisonStats, type ShopPriceHistory, type ShopPriceHistoryList, type ShopPricePoint, type ShopRef, type ShopSummary, type ShopUrl, type ShopUrlDiscoveredBy, type ShopUrlMutationResult, type ShopUrlStatus, type SoldPrice, type StatsItemRef, type SubmitShopUrlParams, TcgPriser, type TcgPriserAdvancedOptions, TcgPriserError, type TcgPriserErrorCode, type TcgPriserOptions, type Timestamp, type TopItem, type TopProductsParams, type VariantPriceStat, type VariantSelector, type VariantStatsSummary, type Webhook, type WebhookDeliveryStatus, type WebhookEvent, type WebhookTestResult, type WebhookWithSecret, type components };
package/dist/index.js CHANGED
@@ -359,6 +359,11 @@ var ExpansionsResource = class {
359
359
  cards(technicalName, options = {}) {
360
360
  return this.http.get(`/expansions/${encodeURIComponent(technicalName)}/cards`, options);
361
361
  }
362
+ /** `GET /expansions/{technicalName}/release-group`: the other expansions in this expansion's
363
+ * release group (e.g. a core set's variant drops), excluding the requested expansion itself. */
364
+ releaseGroup(technicalName, options = {}) {
365
+ return this.http.get(`/expansions/${encodeURIComponent(technicalName)}/release-group`, options);
366
+ }
362
367
  /** `GET /expansions/{technicalName}/products`: every sealed product in this expansion. Content
363
368
  * only, no pricing fields — pass the `id`s from the result to `client.products.pricingBatch()`
364
369
  * if you need pricing too. Cards are a separate call — see `cards()` — never merged into this