Shops

Query stock data for every shop and vendor in Stardew Valley using a consistent, chainable query builder API.

Shared Query Pattern

Every shop module exports a factory function that returns a typed query builder. The query builder follows an immutable, chainable pattern -- each filter or sort method returns a new query instance, and a terminal method extracts the results.

import { pierre } from 'stardew-valley-data'

const items = pierre() // create a query for all Pierre items
  .bySeason('spring') // filter (returns new query)
  .sortByPrice('asc') // sort (returns new query)
  .get() // terminal -- returns PierreItem[]

Every factory function also accepts an optional pre-filtered array so you can wrap existing data in a new query:

const myItems = pierre().seeds().get()
const sorted = pierre(myItems).sortByName().get()

Terminal Methods

All query builders extend QueryBase and inherit these five terminal methods:

Common Filter Methods

Many shops share similar filter methods. The exact set varies per shop, but common ones include:

Common Sort Methods

Some shops have additional sort methods specific to their data (e.g., sortByMineLevel, sortByFishingLevel, sortByTradeAmount).

All Shops