@pfdev/api-types 3.0.13 → 3.0.15

package/package.json

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

package/v3.ts

@@ -37,10 +37,15 @@ export const CardSchema = Type.Object(
     images: CardImagesSchema,
     setid: Type.String({ description: 'Set this card belongs to' }),
     setname: Type.String({ description: 'Name of the set' }),
-    price: Type.Optional(Type.Number({ description: 'Lowest price across all variants' })),
+    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' })),
-    variants: Type.Optional(Type.Array(Type.String(), { description: 'Available variants for this card' }))
+    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.'
+      })
+    )
   },
   {
     title: 'Card',
@@ -68,6 +73,7 @@ export const CardListQuerySchema = Type.Object(
   {
     setid: Type.Optional(Type.String({ description: 'Filter by set ID' })),
     name: Type.Optional(Type.String({ description: 'Search by card name' })),
+    include: Type.Optional(Type.Literal('variant_prices', { description: 'Include per-variant prices and period changes on each card' })),
     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' }))
   },
@@ -103,6 +109,15 @@ export const CardSearchQuerySchema = Type.Object({
 
 export type CardSearchQuery = Static<typeof CardSearchQuerySchema>;
 
+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.'
+  })
+});
+
+export type CardBatchQuery = Static<typeof CardBatchQuerySchema>;
+
 export const CardDetailSchema = Type.Object(
   {
     cardid: Type.String({ description: 'Unique card identifier' }),
@@ -131,7 +146,7 @@ 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' })),
-    price: Type.Optional(Type.Number({ description: 'Lowest price across all variants' })),
+    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' })),
     variants: Type.Optional(Type.Array(Type.String(), { description: 'Available variants for this card' })),
@@ -559,6 +574,142 @@ export type DexCollectionItem = Static<typeof DexCollectionItemSchema>;
 
 export const DexCollectionResponseSchema = Type.Array(DexCollectionItemSchema);
 
+export const InventorySummaryItemSchema = Type.Object(
+  {
+    uuid: Type.String({ description: 'Unique ID of this inventory row' }),
+    cardid: Type.String({ description: 'Card ID this inventory row belongs to' }),
+    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.'
+    })
+  },
+  { title: 'InventorySummaryItem' }
+);
+
+export type InventorySummaryItem = Static<typeof InventorySummaryItemSchema>;
+
+export const InventorySummaryResponseSchema = Type.Array(InventorySummaryItemSchema, {
+  title: 'InventorySummaryResponse',
+  description: 'Lightweight ownership rows for the authenticated user. One entry per physical card owned. Suitable for a global client store.'
+});
+
+export type InventorySummaryResponse = Static<typeof InventorySummaryResponseSchema>;
+
+export const InventoryAddRequestSchema = Type.Object(
+  {
+    cardid: Type.String({ minLength: 1, description: 'Card ID to add to inventory' }),
+    variant: Type.String({ minLength: 1, description: 'Card variant (e.g. Normal, Holofoil, Reverse Holofoil)' })
+  },
+  { title: 'InventoryAddRequest' }
+);
+
+export type InventoryAddRequest = Static<typeof InventoryAddRequestSchema>;
+
+export const InventoryDeleteParamSchema = Type.Object({
+  uuid: Type.String({ format: 'uuid', description: 'UUID of the inventory row to delete' })
+});
+
+export type InventoryDeleteParam = Static<typeof InventoryDeleteParamSchema>;
+
+export const InventoryTransactionSchema = Type.Object(
+  {
+    tx_uuid: Type.String({ format: 'uuid' }),
+    transaction_type: Type.Number({ description: '100-199 = cost, 200-299 = income' }),
+    transaction_date: Type.String({ description: 'ISO date string' }),
+    amount: Type.Number(),
+    currency: Type.String(),
+    amount_usd: Type.Union([Type.Number(), Type.Null()]),
+    rate: Type.Union([Type.Number(), Type.Null()]),
+    description: Type.Union([Type.String(), Type.Null()]),
+    source_platform: Type.Union([Type.String(), Type.Null()])
+  },
+  { title: 'InventoryTransaction' }
+);
+
+export type InventoryTransaction = Static<typeof InventoryTransactionSchema>;
+
+export const InventoryItemDetailSchema = Type.Object(
+  {
+    uuid: Type.String({ format: 'uuid' }),
+    cardid: Type.String(),
+    variant: Type.String(),
+    status: Type.Union([Type.Number(), Type.Null()]),
+    grade: Type.Union([Type.String(), Type.Null()]),
+    acquired: Type.Union([Type.String(), Type.Null()]),
+    sold_date: Type.Union([Type.String(), Type.Null()]),
+    notes: Type.Union([Type.String(), Type.Null()]),
+    total_cost_usd: Type.Number(),
+    total_income_usd: Type.Number(),
+    profit_loss_usd: Type.Number(),
+    transactions: Type.Array(InventoryTransactionSchema)
+  },
+  {
+    title: 'InventoryItemDetail',
+    description: 'Full detail of a single inventory row, including transactions and aggregated totals.'
+  }
+);
+
+export type InventoryItemDetail = Static<typeof InventoryItemDetailSchema>;
+
+export const InventoryItemsResponseSchema = Type.Array(InventoryItemDetailSchema, {
+  title: 'InventoryItemsResponse',
+  description: 'Full-detail inventory items for a specific cardid.'
+});
+
+export type InventoryItemsResponse = Static<typeof InventoryItemsResponseSchema>;
+
+export const InventoryItemsQuerySchema = Type.Object({
+  cardid: Type.String({ minLength: 1, description: 'Card ID to fetch inventory items for' })
+});
+
+export type InventoryItemsQuery = Static<typeof InventoryItemsQuerySchema>;
+
+export const InventoryItemParamSchema = Type.Object({
+  uuid: Type.String({ format: 'uuid', description: 'UUID of the inventory row' })
+});
+
+export type InventoryItemParam = Static<typeof InventoryItemParamSchema>;
+
+export const InventoryPatchTransactionSchema = Type.Object(
+  {
+    tx_uuid: Type.Optional(Type.String({ format: 'uuid', description: 'Present for updates, omitted for new transactions' })),
+    transaction_type: Type.Number(),
+    transaction_date: Type.String({ description: 'ISO date (YYYY-MM-DD)' }),
+    amount: Type.Number(),
+    currency: Type.Optional(Type.String({ minLength: 3, maxLength: 3, default: 'USD' })),
+    description: Type.Optional(Type.String()),
+    source_platform: Type.Optional(Type.String())
+  },
+  { title: 'InventoryPatchTransaction' }
+);
+
+export type InventoryPatchTransaction = Static<typeof InventoryPatchTransactionSchema>;
+
+export const InventoryPatchParamSchema = Type.Object({
+  uuid: Type.String({ format: 'uuid', description: 'UUID of the inventory row to update' })
+});
+
+export type InventoryPatchParam = Static<typeof InventoryPatchParamSchema>;
+
+export const InventoryPatchRequestSchema = Type.Object(
+  {
+    grade: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+    status: Type.Optional(Type.Union([Type.Number(), Type.Null()])),
+    notes: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+    acquired: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+    sold_date: Type.Optional(Type.Union([Type.String(), Type.Null()])),
+    transactions: Type.Optional(Type.Array(InventoryPatchTransactionSchema, {
+      description: 'Authoritative — any existing transaction not in this list is deleted.'
+    }))
+  },
+  {
+    title: 'InventoryPatchRequest',
+    description: 'Fields omitted from the body are left unchanged. Fields set to null are cleared.'
+  }
+);
+
+export type InventoryPatchRequest = Static<typeof InventoryPatchRequestSchema>;
+
 // ============= VISION =============
 
 
@@ -590,7 +741,8 @@ const DetectedCardSchema = Type.Object(
 
 const MatchedCardSchema = Type.Intersect(
   [
-    CardSchema,
+    // Vision returns variant_prices as an array, not CardSchema's map
+    Type.Omit(CardSchema, ['variant_prices']),
     Type.Object({
       score: Type.Number({ description: 'Fuzzy match score — higher is a better match' }),
       variant_prices: Type.Array(VariantPriceSchema, { description: 'Per-variant prices with extended period changes' })