feat(types): add inference for embeded joins by functions

[avallete]

What kind of change does this PR introduce?

Once supabase/postgres-meta#915 is merged

This introduce automatic types inferences for "joins based on functions" to postgrest-js.

Along with the type generation in pg-meta it should allows queries such as:

postgrest
        .from('organizations')
        .select('subscription_id, custom_function_returning_setof_other_table(customer_id)')

To work out of the box.

It also introduce a way to "force cast" an object relation as being not nullable at the database override level in case some DB layer app logic enforce it.

This should not be a breaking change since everything has be scoped in an additional type.

Fixes: CLIBS-79

Related: supabase/supabase-js#1259

Edit: Tested the full pipeline (typegen + inference) over our infra repo, was able to get rid of all types override for the billing_subscriptions (see: https://github.com/supabase/infrastructure/compare/develop...chore/upgrade-supabase-js)

[avallete]

note

This part should fix: supabase/supabase-js#1366

Now that we're able to detect embed from function within select, we can also use the same types to do the opposite and make:

.rpc('function_that_return_setof_table_A', {}).select('field_from_table_A')

And infer the right result.

[avallete]

note

This should fix: supabase/supabase-js#1365

[avallete]

note

This will be the api to make any row returning function globally "non nullable" if desired by the user, to avoid having to use the ! operator everytime.