Adds explain() and geojson() transforms

[steve-chavez]

Adds support for:

• explain: Add media type for explain PostgREST/postgrest#2368
• geojson: Add PostGIS GeoJSON support PostgREST/postgrest#1564

misclick

[soedirgo]

Can you give some background on what .geojson() does? .explain() is simple enough, but how does .geojson() change the response? Does it change only geo columns, leaving all other columns the same? Does it only return geo columns?

Also, does .explain() always return stuff in the same format? Looks like Settings is missing if options= isn't specified?

[steve-chavez]

Can you give some background on what .geojson() does?
but how does .geojson() change the response?

It runs st_asgeojson(postgis func) over the whole row making it follow the structure on https://geojson.org/.

Does it change only geo columns, leaving all other columns the same? Does it only return geo columns?

Changes the geocolumns and all the other columns are stored into the properties key as per the spec. If more than one geometry column exists on the relation, st_asgeojson will only put the first one on the geometry key and the other ones will be put on the properties key(can be later enhaced to put all into a multipolygon geometry). This behavior can be changed with select as one would expect.

Also, does .explain() always return stuff in the same format? Looks like Settings is missing if options= isn't specified?

Depends on the options specified, more options add more json keys. These follow the same format as doing an EXPLAIN (FORMAT JSON). (Note: the format varies across pg versions)

[soedirgo]

Gotcha, I guess for now the return type can be:

• .explain(): PromiseLike<PostgrestResponse<Record<string, unknown>>>
• .geojson(): PromiseLike<PostgrestSingleResponse<Record<string, unknown>>>

[steve-chavez]

@soedirgo Done. Could we make a new release to add these methods to supabase-js v2?

[soedirgo]

Will do! v2 isn't released yet (it's on the next branch) but I'll add the features there as well

[github-actions]

🎉 This PR is included in version 0.38.0 🎉

The release is available on:

• GitHub release
• npm package (@latest dist-tag)

Your semantic-release bot 📦🚀

[dshukertjr]

Wow, this seems like a very awesome feature!