@pfdev/api-types 3.0.16 → 3.0.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pfdev/api-types",
-  "version": "3.0.16",
+  "version": "3.0.18",
   "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

@@ -76,8 +76,10 @@ export const CardListSortSchema = Type.Union([
   Type.Literal('name_asc'),
   Type.Literal('name_desc'),
   Type.Literal('price_asc'),
-  Type.Literal('price_desc')
-], { default: 'number_asc', description: 'Sort order. Defaults to number_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.' });
 
 export type CardListSort = Static<typeof CardListSortSchema>;
 
@@ -99,7 +101,8 @@ export const CardBatchQuerySchema = Type.Object({
   ids: Type.String({
     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' }))
 });
 
 export type CardBatchQuery = Static<typeof CardBatchQuerySchema>;
@@ -503,6 +506,84 @@ 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 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' })
+  },
+  { 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 =============
 
 
@@ -567,7 +648,11 @@ export const InventorySummaryItemSchema = Type.Object(
     variant: Type.String({ description: 'Card variant (e.g. Normal, Holofoil, Reverse Holofoil)' }),
     status: Type.Union([Type.Number(), Type.Null()], {
       description: 'Numeric status code. <100 = active, >=100 = sold/past. Null when no details row exists yet.'
-    })
+    }),
+    acquired: Type.Union([Type.String(), Type.Null()], {
+      description: 'User-entered acquired date. Null when not set or no details row exists yet.'
+    }),
+    created_at: Type.String({ description: 'When this inventory row was created' })
   },
   { title: 'InventorySummaryItem' }
 );
@@ -758,3 +843,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>;