@pfdev/api-types 3.0.17 → 3.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pfdev/api-types",
-  "version": "3.0.17",
+  "version": "3.0.19",
   "description": "TypeScript types for PF API V3",
   "main": "index.ts",
   "types": "index.ts",
@@ -9,7 +9,7 @@
     "v3.ts"
   ],
   "scripts": {
-    "watch": "chokidar '../pfapi-fs/src/routes/v3/*/schemas.ts' -c 'npm run generate'",
+    "watch": "chokidar '../pfapi-fs/src/routes/v3/**/schemas.ts' -c 'npm run generate'",
     "verify": "tsc --noEmit v3.ts",
     "generate": "bash generate-types.sh",
     "preversion": "npm run generate && git add v3.ts",

package/v3.ts

@@ -10,6 +10,8 @@ import { Static, Type } from '@sinclair/typebox';
 export const PriceStatsSchema = Type.Object(
   {
     current_price: Type.Optional(Type.Number({ description: 'Current price' })),
+    price_date: Type.Optional(Type.String({ description: 'Date (YYYY-MM-DD) this price was last updated' })),
+    change_1d_value: Type.Optional(Type.Number({ description: '1-day price change in dollars' })),
     change_1d: Type.Optional(Type.Number({ description: '1-day price change as a percentage' })),
     change_7d: Type.Optional(Type.Number({ description: '7-day price change as a percentage' })),
     change_1m: Type.Optional(Type.Number({ description: '30-day price change as a percentage' })),
@@ -28,6 +30,38 @@ const CardImagesSchema = Type.Object(
   { title: 'CardImages' }
 );
 
+const GradedVariantPricesSchema = Type.Record(
+  Type.String(),
+  Type.Record(Type.String(), PriceStatsSchema),
+  { description: 'Graded prices and period changes keyed by variant then grade' }
+);
+
+// Fields on every card used for filtering and for web URLs
+const CardFilterFields = {
+  supertype: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Supertype (Pokémon, Trainer, Energy)' })),
+  subtypes: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Null()], { description: 'Card subtypes' })),
+  types: Type.Optional(Type.Union([Type.Array(Type.String()), Type.Null()], { description: 'Card types' })),
+  nationalPokedexNumbers: Type.Optional(Type.Union([Type.Array(Type.Number()), Type.Null()], { description: 'National Pokédex numbers' })),
+  regulationMark: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Regulation mark' })),
+  set_release_date: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Release date of the set' })),
+  series: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'Series the set belongs to' })),
+  slug: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'URL slug for the card' })),
+  set_slug: Type.Optional(Type.Union([Type.String(), Type.Null()], { description: 'URL slug for the set' }))
+};
+
+const PriceVariantSchema = Type.Optional(Type.Union([Type.String(), Type.Null()], {
+  description: 'Variant that price, change_1d and change_1d_value come from (the lowest-priced variant)'
+}));
+
+const PriceDateSchema = Type.Optional(Type.Union([Type.String(), Type.Null()], {
+  description: 'Date (YYYY-MM-DD) the price was last updated, for the variant in price_variant'
+}));
+
+const CardIncludeSchema = Type.Optional(Type.String({
+  pattern: '^(variant_prices|graded_variants_prices)(,(variant_prices|graded_variants_prices))*$',
+  description: 'Comma-separated extras to include on each card: variant_prices (per-variant prices and period changes), graded_variants_prices (graded prices keyed by variant then grade)'
+}));
+
 export const CardSchema = Type.Object(
   {
     cardid: Type.String({ description: 'Unique card identifier' }),
@@ -38,15 +72,22 @@ export const CardSchema = Type.Object(
     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' })),
     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: PriceVariantSchema,
+    price_date: PriceDateSchema,
     variants: Type.Optional(Type.Array(Type.String(), { description: 'Available variants for this card' })),
     variant_prices: Type.Optional(
       Type.Record(Type.String(), PriceStatsSchema, {
         description: 'Prices and period changes keyed by variant name. Only present when requested via include=variant_prices. Variants without price data map to an empty object.'
       })
-    )
+    ),
+    graded_variants_prices: Type.Optional({
+      ...GradedVariantPricesSchema,
+      description: 'Graded prices and period changes keyed by variant then grade. Only present when requested via include=graded_variants_prices; empty when the card has no graded prices.'
+    })
   },
   {
     title: 'Card',
@@ -88,7 +129,7 @@ export const CardListQuerySchema = Type.Object(
     setid: Type.Optional(Type.String({ description: 'Filter by set ID' })),
     search: Type.Optional(Type.String({ minLength: 1, description: 'Search by card name and/or number. Tokens with digits match card number; other tokens match card name.' })),
     sort: Type.Optional(CardListSortSchema),
-    include: Type.Optional(Type.Literal('variant_prices', { description: 'Include per-variant prices and period changes on each card' })),
+    include: CardIncludeSchema,
     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' }))
   },
@@ -102,7 +143,7 @@ export const CardBatchQuerySchema = Type.Object({
     minLength: 1,
     description: 'Comma-separated list of card IDs (e.g. "xy1-2,base1-4"). Duplicates are deduped. Max 200 IDs per request.'
   }),
-  include: Type.Optional(Type.Literal('variant_prices', { description: 'Include per-variant prices and period changes on each card' }))
+  include: CardIncludeSchema
 });
 
 export type CardBatchQuery = Static<typeof CardBatchQuerySchema>;
@@ -135,6 +176,12 @@ export const CardDetailSchema = Type.Object(
     nationalPokedexNumbers: Type.Optional(Type.Array(Type.Number(), { description: 'National Pokédex numbers' })),
     legalities: Type.Optional(Type.Any({ description: 'Format legalities' })),
     regulationMark: Type.Optional(Type.String({ description: 'Regulation mark' })),
+    set_release_date: CardFilterFields.set_release_date,
+    series: CardFilterFields.series,
+    slug: CardFilterFields.slug,
+    set_slug: CardFilterFields.set_slug,
+    price_variant: PriceVariantSchema,
+    price_date: PriceDateSchema,
     price: Type.Optional(Type.Number({ description: 'Price of the lowest-priced 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' })),
@@ -142,13 +189,7 @@ export const CardDetailSchema = Type.Object(
     variant_prices: Type.Optional(
       Type.Record(Type.String(), PriceStatsSchema, { description: 'Prices and period changes keyed by variant name' })
     ),
-    graded_variants_prices: Type.Optional(
-      Type.Record(
-        Type.String(),
-        Type.Record(Type.String(), PriceStatsSchema),
-        { description: 'Graded prices and period changes keyed by variant then grade' }
-      )
-    )
+    graded_variants_prices: Type.Optional(GradedVariantPricesSchema)
   },
   {
     title: 'CardDetail',
@@ -506,6 +547,99 @@ export const SetDetailParamSchema = Type.Object({
 
 export type SetDetailParam = Static<typeof SetDetailParamSchema>;
 
+// ============= LISTS =============
+
+
+export const ListTypeSchema = Type.Union(
+  [Type.Literal('static'), Type.Literal('dynamic'), Type.Literal('binder')],
+  { description: 'static = duplicates allowed, dynamic = one entry per card variant, binder = slot-based layout' }
+);
+
+export type ListType = Static<typeof ListTypeSchema>;
+
+export const ListCoverCardSchema = Type.Object(
+  {
+    cardid: Type.String(),
+    variant: Type.String(),
+    image: Type.Union([Type.String(), Type.Null()], { description: 'Small card image URL' })
+  },
+  { title: 'ListCoverCard' }
+);
+
+export type ListCoverCard = Static<typeof ListCoverCardSchema>;
+
+export const ListSchema = Type.Object(
+  {
+    uuid: Type.String({ format: 'uuid' }),
+    name: Type.String(),
+    description: Type.Union([Type.String(), Type.Null()]),
+    icon: Type.Union([Type.String(), Type.Null()]),
+    color: Type.Union([Type.String(), Type.Null()]),
+    is_private: Type.Boolean(),
+    type: Type.Union([ListTypeSchema, Type.Null()]),
+    binder_config: Type.Union([Type.Number(), Type.Null()], {
+      description: 'Binder layout preset. Only set for binders.'
+    }),
+    card_count: Type.Integer({ description: 'Total entries, including duplicates' }),
+    unique_count: Type.Integer({ description: 'Distinct cardids' }),
+    total_value: Type.Number({ description: 'Sum of current USD prices of every entry' }),
+    cover: Type.Array(ListCoverCardSchema, {
+      maxItems: 3,
+      description: 'Up to 3 cards for the list tile: the most recently added entries, or the first slots for binders. Empty when the list has no cards.'
+    })
+  },
+  { title: 'List' }
+);
+
+export type List = Static<typeof ListSchema>;
+
+export const ListsResponseSchema = Type.Array(ListSchema, {
+  title: 'ListsResponse',
+  description: 'All lists and binders owned by the authenticated user, oldest first.'
+});
+
+export const ListParamSchema = Type.Object({
+  uuid: Type.String({ format: 'uuid', description: 'UUID of the list' })
+});
+
+export type ListParam = Static<typeof ListParamSchema>;
+
+const NameSchema = Type.String({ minLength: 1, maxLength: 100 });
+const DescriptionSchema = Type.String({ maxLength: 1000 });
+
+export const ListCreateRequestSchema = Type.Object(
+  {
+    name: NameSchema,
+    description: Type.Optional(DescriptionSchema),
+    icon: Type.String({ minLength: 1 }),
+    color: Type.String({ minLength: 1 }),
+    is_private: Type.Optional(Type.Boolean({ default: false })),
+    type: Type.Optional(ListTypeSchema),
+    binder_config: Type.Optional(Type.Number({ description: 'Required when type is binder; rejected otherwise' }))
+  },
+  { title: 'ListCreateRequest', additionalProperties: false }
+);
+
+export type ListCreateRequest = Static<typeof ListCreateRequestSchema>;
+
+export const ListPatchRequestSchema = Type.Object(
+  {
+    name: Type.Optional(NameSchema),
+    description: Type.Optional(DescriptionSchema),
+    icon: Type.Optional(Type.String({ minLength: 1 })),
+    color: Type.Optional(Type.String({ minLength: 1 })),
+    is_private: Type.Optional(Type.Boolean())
+  },
+  {
+    title: 'ListPatchRequest',
+    description: 'Fields omitted from the body are left unchanged. type and binder_config cannot be changed.',
+    additionalProperties: false,
+    minProperties: 1
+  }
+);
+
+export type ListPatchRequest = Static<typeof ListPatchRequestSchema>;
+
 // ============= USERS =============
 
 
@@ -765,3 +899,22 @@ export const VisionResponseSchema = Type.Object(
 );
 
 export type VisionResponse = Static<typeof VisionResponseSchema>;
+
+// ============= CLERK =============
+
+
+export const WebhookAckSchema = Type.Object(
+  {
+    received: Type.Boolean()
+  },
+  { title: 'WebhookAck' }
+);
+
+export type WebhookAck = Static<typeof WebhookAckSchema>;
+
+export const WebhookErrorSchema = Type.Object({
+  error: Type.String(),
+  message: Type.String()
+});
+
+export type WebhookError = Static<typeof WebhookErrorSchema>;