How to filter articles by category slug when categories is an array of references?

I can help you fix this GROQ query issue! The problem is with how you're trying to use the references() function. The syntax you have isn't valid GROQ.

The references() function is actually much simpler than what you're attempting. It takes a document ID and checks if any reference field in the document points to it. You don't specify field paths or slugs - it just checks all reference fields automatically.

Here's the corrected query:

const query = groq`*[_type == "article" && references($categoryId)] {
    ...,
    categories[]-> {
      title,
      slug
    }  
}`

The key changes:

1. Pass the category document ID, not the slug. The references() function checks against _id values, not slug fields.
2. Use a parameter ($categoryId) instead of string interpolation for safety and proper typing.

In your code, you'll need to:

1. First fetch the category document to get its _id:

const categoryDoc = await client.fetch(
  `*[_type == "category" && slug.current == $slug][0]`,
  { slug }
)

2. Then use that ID in your articles query:

const articles = await client.fetch(query, { categoryId: categoryDoc._id })

Alternative: If you must filter by slug directly, you can use this approach instead:

*[_type == "article" && $slug in categories[]->slug.current] {
    ...,
    categories[]-> {
      title,
      slug
    }  
}

This dereferences all categories in the array and checks if your slug exists in any of them. However, this can be less performant than using references() with the document ID, because it has to dereference every category reference to check the slugs.

The references() function is specifically designed for checking if a document references another document by ID, which is why it's the recommended and most efficient approach when working with reference fields.