Filtering

import { filter, and, or, eq, gte, lte, inValues } from '@commerce-blocks/sdk'

await collection.execute({
  filters: filter(and(eq('options.color', 'Red'), eq('options.size', 'Medium'))),
})

// Price range
filter(and(gte('price', 50), lte('price', 200)))

// Multiple values
filter(or(eq('vendor', 'Nike'), eq('vendor', 'Adidas')))

import type { FilterGroup, FilterExpression } from '@commerce-blocks/sdk'

interface FilterExpression {
  property: string
  operator: FilterOperator
  values: (string | number | boolean)[]
}

interface FilterGroup {
  conditional: 'AND' | 'OR'
  expressions: (FilterExpression | FilterGroup)[]
}

// Single expression (wrapped in AND group automatically)
filter(eq('vendor', 'Nike'))

// Explicit group
filter(and(eq('vendor', 'Nike'), gte('price', 50)))

// Nested groups
filter(and(
  eq('options.color', 'Red'),
  or(eq('vendor', 'Nike'), eq('vendor', 'Adidas'))
))

import { createClient } from '@commerce-blocks/sdk'

const { data: client } = createClient({
  // ...config
  filterAliases: {
    color: 'options.color',
    size: 'options.size',
    brand: { property: 'vendor', values: { nike: 'Nike', adidas: 'Adidas' } },
  },
})

// Aliases resolve automatically
await collection.execute({ filters: { color: 'Red', brand: 'nike' } })

type FilterAlias =
  | string // Simple: 'color' maps to 'options.color'
  | { property: string; values?: Record<string, string> } // With value mapping

type FilterAliases = Record<string, FilterAlias>