Feature: Simplified APIs

[scottrippey]

We removed irrelevant methods from the root q object, and from query chains.
This improves auto-complete and API discoverability, and reduces confusion.

• The root q object no longer exposes irrelevant chaining methods.
  • E.g. we removed: q.filter(...), q.deref(), q.field(...), etc.
• Query chains no longer expose irrelevant top-level utilities.
  • E.g. we removed (chain).star, (chain).conditional(...), (chain).select(...), (chain).value(...), etc.
• The subquery in a projection no longer exposes irrelevant chaining methods.
  • E.g. with .project(sub => ({ ... })) we removed: sub.filter(...), sub.order(...), etc.

Backwards compatibility: we only removed methods that created invalid GROQ queries,
so this change should be backwards compatible.

Testing

This is fully covered by unit tests.

[changeset-bot]

🦋 Changeset detected

Latest commit: 7d2419f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
groqd	Minor
website	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
groqd	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Feb 15, 2025 7:21am