chore: Update table path param to be a query param

[KyleAMathews]

Partially addresses #1771

[netlify]

✅ Deploy Preview for electric-next ready!

Name	Link
🔨 Latest commit	77d10ba
🔍 Latest deploy log	https://app.netlify.com/sites/electric-next/deploys/671934e04ebaab000939fad5
😎 Deploy Preview	https://deploy-preview-1798--electric-next.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[msfstef]

Looks good!

@KyleAMathews I've fixed up all the elixir, integration, and TS tests and any type issues in the examples - I haven't run all the examples to make sure they work though.

I've also updated the OpenAPI spec and some docs to reflect the API change and added "breaking" changesets.

I've noticed that we're using "root table" as a term in some places in the docs with respect to the API, and although the term makes sense for the shape definition I'm worried about it becoming confusing. I've made it so that 400 errors return with "table": ["table not found"] rather than "root_table" cause I feel that 400s should return errors matching the problematic parameters, but just noting this occasional discrepancy.

[KyleAMathews]

Great thanks! I'll give this a through go over later & double-check docs, examples, etc. and then merge it in

[KyleAMathews]

Yeah root_table is useful in Elixir to be really clear about what table it is but since only one table is allowed in a shape request, just calling it "table" everywhere else is cleaner.

[KyleAMathews]

Ok, this is ready to go — all examples are tested & gave another look over docs.

Per #1796 (review) we'll just either need to decide on the order of merging.

[KyleAMathews]

Not sure where those typescript errors are from — not reproducing locally.

[thruflo]

So everywhere we have table in the URL we need to switch to table as a param? Can you shout when this is merged so we can update parallel PRs like deployment docs and Elixir client.

[KyleAMathews]

The docs are already updated as part of this PR — we can just release it right away when we merge.