@pfdev/api-types 3.0.22 → 3.0.24

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pfdev/api-types",
-  "version": "3.0.22",
+  "version": "3.0.24",
   "description": "TypeScript types for PF API V3",
   "main": "index.ts",
   "types": "index.ts",

package/v3.ts

@@ -89,13 +89,15 @@ export const CardSchema = Type.Object(
     cardid: Type.String({ description: 'Unique card identifier' }),
     name: Type.String({ description: 'Card name' }),
     number: Type.String({ description: 'Card number within set' }),
-    rarity: Type.Optional(Type.String({ description: 'Card rarity' })),
+    rarity: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Card rarity, the same for every language (no _JP suffix). None when the card has no rarity; null when not set.' })),
+    language: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Card language code (EN, JP)' })),
     artist: Type.Optional(Type.String({ description: 'Card artist' })),
     images: CardImagesSchema,
     setid: Type.String({ description: 'Set this card belongs to' }),
     setname: Type.String({ description: 'Name of the set' }),
     ...CardFilterFields,
     price: Type.Optional(Type.Number({ description: 'Price of the lowest-priced variant' })),
+    max_price: Type.Optional(Type.Number({ description: 'Price of the highest-priced non-hidden variant' })),
     change_1d: Type.Optional(Type.Number({ description: '1-day price change as a percentage' })),
     change_1d_value: Type.Optional(Type.Number({ description: '1-day price change in dollars' })),
     price_variant_id: PriceVariantIdSchema,
@@ -132,8 +134,14 @@ export const CardListSortSchema = Type.Union([
   Type.Literal('price_asc'),
   Type.Literal('price_desc'),
   Type.Literal('change_asc'),
-  Type.Literal('change_desc')
-], { default: 'number_asc', description: 'Sort order. change_* sorts by 1-day percentage price change. Defaults to number_asc.' });
+  Type.Literal('change_desc'),
+  Type.Literal('release_desc'),
+  Type.Literal('release_asc'),
+  Type.Literal('release_desc_price_desc')
+], {
+  default: 'number_asc',
+  description: 'Sort order. change_* sorts by 1-day percentage price change. release_asc/desc sort by set release date, then card number. release_desc_price_desc sorts by newest set, then max_price descending. Cards from sets with no release date come last in every release sort. Defaults to number_asc.'
+});
 
 export type CardListSort = Static<typeof CardListSortSchema>;
 
@@ -141,7 +149,8 @@ export type CardListSort = Static<typeof CardListSortSchema>;
 // values within one param match with OR, different params combine with AND.
 const CardListFilterFields = {
   setid: Type.Optional(Type.String({ description: 'Comma-separated set IDs (max 500). A single ID behaves as before.' })),
-  rarity: Type.Optional(Type.String({ description: 'Comma-separated rarities (max 50), matched exactly' })),
+  rarity: Type.Optional(Type.String({ description: 'Comma-separated rarities (max 50), matched exactly. A rarity matches cards in every language.' })),
+  language: Type.Optional(Type.String({ description: 'Comma-separated language codes (EN, JP; max 50)' })),
   variant_id: Type.Optional(Type.String({ description: 'Comma-separated variant ids (variants[].id, max 50). Matches non-hidden variants only.' }))
 };
 
@@ -156,7 +165,7 @@ export const CardListQuerySchema = Type.Object(
     limit: Type.Optional(Type.Number({ minimum: 1, maximum: 250, default: 50, description: 'Max results to return' })),
     offset: Type.Optional(Type.Number({ minimum: 0, default: 0, description: 'Pagination offset' }))
   },
-  { description: 'At least one of search, setid, rarity or variant_id must be provided' }
+  { description: 'With no search or filters, lists every card' }
 );
 
 export type CardListQuery = Static<typeof CardListQuerySchema>;
@@ -166,7 +175,7 @@ export const CardFacetsQuerySchema = Type.Object(
     ...CardListFilterFields,
     search: CardSearchField
   },
-  { description: 'Same search and filters as /cards; at least one of them must be provided' }
+  { description: 'Same search and filters as /cards. With none, returns the facets for every card' }
 );
 
 export type CardFacetsQuery = Static<typeof CardFacetsQuerySchema>;
@@ -185,7 +194,7 @@ export const CardFacetOptionSchema = Type.Object(
     label: Type.String({ description: 'Label to show users' }),
     count: Type.Integer({ description: 'Cards this option matches, ignoring this facet\'s own selection' }),
     variant_count: Type.Integer({ description: 'Non-hidden variants on those cards, same counting rule. With variant_id, only the selected variants count.' }),
-    order: Type.Optional(Type.Integer({ description: 'Display order, ascending: variant sort_order; sets by release date, newest first (0 = newest). Omitted for rarity.' })),
+    order: Type.Optional(Type.Integer({ description: 'Display order, ascending: variant sort_order; sets by release date, newest first (0 = newest); languages English first. Omitted for rarity.' })),
     group: Type.Optional(CardFacetGroupSchema)
   },
   { title: 'CardFacetOption' }
@@ -196,8 +205,10 @@ export type CardFacetOption = Static<typeof CardFacetOptionSchema>;
 export const CardFacetsResponseSchema = Type.Object(
   {
     total: Type.Integer({ description: 'Cards matching search and all filters' }),
+    variant_total: Type.Integer({ description: 'Non-hidden variants on those cards, counted like variant_count. With variant_id, only the selected variants count.' }),
     facets: Type.Object({
-      rarity: Type.Array(CardFacetOptionSchema),
+      rarity: Type.Array(CardFacetOptionSchema, { description: 'Cards with no rarity have the value None, labelled "No rarity". Cards with rarity unset are counted in total but have no option.' }),
+      language: Type.Array(CardFacetOptionSchema, { description: 'Value is the language code, label its name (e.g. JP, Japanese)' }),
       variant: Type.Array(CardFacetOptionSchema),
       set: Type.Array(CardFacetOptionSchema, { description: 'Each option carries its series in group, omitted when the set has no series' })
     })
@@ -225,7 +236,8 @@ export const CardDetailSchema = Type.Object(
     cardid: Type.String({ description: 'Unique card identifier' }),
     name: Type.String({ description: 'Card name' }),
     number: Type.String({ description: 'Card number within set' }),
-    rarity: Type.Optional(Type.String({ description: 'Card rarity' })),
+    rarity: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Card rarity, the same for every language (no _JP suffix). None when the card has no rarity; null when not set.' })),
+    language: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Card language code (EN, JP)' })),
     images: CardImagesSchema,
     setid: Type.String({ description: 'Set this card belongs to' }),
     setname: Type.String({ description: 'Name of the set' }),
@@ -255,6 +267,7 @@ export const CardDetailSchema = Type.Object(
     price_variant_id: PriceVariantIdSchema,
     price_date: PriceDateSchema,
     price: Type.Optional(Type.Number({ description: 'Price of the lowest-priced variant' })),
+    max_price: Type.Optional(Type.Number({ description: 'Price of the highest-priced non-hidden variant' })),
     change_1d: Type.Optional(Type.Number({ description: '1-day price change as a percentage' })),
     change_1d_value: Type.Optional(Type.Number({ description: '1-day price change in dollars' })),
     variants: {