Add $args symbol support for field arguments in selections

[shardulbee]

Introduces a $args symbol key for passing GraphQL field arguments within field selections.

Changes:

• Added $args symbol and FieldArgs type to FieldSelection interface
• Updated InnerSelect type to exclude $args from selection results
• Added type tests to verify $args is properly excluded from selected types

Example usage:

{
  comments: {
    [$args]: { after: "cursor", first: 10 },
    body: true
  }
}

PR Checklist

• Important or complicated code is tested
• Any user facing changes are documented in the Gadget-side changelog
• Any immediate changes are slated for release in Gadget via a generated package dependency bump
• Versions within this monorepo are matching and there's a valid upgrade path

[shardulbee]

@infiton I think I remember you and @airhorns saying that you wanted to make the $args symbol available as part of api ?

[infiton]

hmm I think we don't need this on the AnyClient type; I don't think we'd want the key to be the symbol anyways

I think we'll either re-export this symbol from the generated client package or add it as a string property so you could do

await api.myVec.findFirst({select: {
  vecL2DistanceTo: {
    [api.$args]: { vector: [1,2,3] }
  }
}});

or something like that

[shardulbee]

isn't that what this line enables?

[infiton]

not quite as the property key would be the symbol so to access it you'd need to so

api[Symbol.for("gadget/fieldArgs")]

you could do

export interface AnyClient {
  $args: symbol
}

[shardulbee]

oh yeah this was a dumb mistake, sorry nice catch. will fix

[infiton]

this looks good; before merging though let me show you how you can get some confidence it'll work nice in the monorepo