chore: add UserDescriptor to branches.list

[timc1]

While working on Abstract Home's My Active Branches, I needed to grab all the branches from a specific user.

This PR adds a UserDescriptor as an option to the branches.list descriptor, so we can pass userId to the query params and get all branches for that user.

[amccloud]

Coming together 👍

Thanks for updating test. You'll also want to update docs

[amccloud]

Looking good 👍

Make sure you update the docs and typescript interface to reflect these changes

[amccloud]

I get the intention here and it'll work until you're using types

list({ projectId, userId }) is not currently allowed so userId can't be present in the condition below. So query is only shared in the else branch but not for the projects branch

If we want to allow filtering branches for a user in a project you'll also want:

descriptor?: ProjectDescriptor | ProjectMembershipDescriptor | UserDescriptor

where type ProjectMembershipDescriptor = {| projectId: string, userId: string |}

It looks like that type exist but might be mislabeled and mixed with OrganizationProjectDescriptor which doesn't appear to be used

[timc1]

@amccloud thanks for the thorough review! I went ahead and updated the type definition, docs, as well as the descriptor mismatch.

[tommoor]

This is fine and I'm just nit'ing but you could avoid running stringify twice and neaten this up a little by just adding userId to the queryOptions inside of this block and then run querystring.stringify afterwards?

[timc1]

Ty 7c445f0