fix(cli): generate non-TypeScript types from project refs by avallete · Pull Request #5622 · supabase/cli

avallete · 2026-06-18T15:50:09Z

What changed

Lets legacy supabase gen types --project-id generate Go, Swift, and Python types by resolving a temporary database connection and running pg-meta.
Keeps TypeScript project-ref generation on the Management API typegen endpoint, while non-TypeScript project-ref flows use the project database host plus a temporary login role.
Updates side-effect docs and integration coverage for project-ref type generation across TypeScript, Go, Swift, and Python.
Adds e2e coverage for tokenless local typegen and an env-gated live remote project matrix across all supported typegen languages.

Why

Python type generation with --project-id failed before it could reach pg-meta, and the first fix used the preview-branch config endpoint. Production project refs return 404 Preview branch not found from that endpoint because /v1/branches/{ref} is branch-only.

Non-TypeScript type generation is still pg-meta-based, so project-ref flows need to construct a live database connection instead of calling the TypeScript-only typegen endpoint or asking the user to provide --db-url.

Reviewer context

Non-TypeScript project-ref generation still requires Docker because it continues to use pg-meta. The change is limited to how the CLI resolves the database connection for project refs: it fetches the project database host and creates a temporary login role rather than reading or storing the project's database password.

The live remote e2e matrix is skipped unless SUPABASE_TYPEGEN_E2E_REMOTE=1, SUPABASE_TEST_PROJECT_REF, and SUPABASE_ACCESS_TOKEN are set. The local e2e matrix runs without a token and points the API profile at an unreachable local URL to catch accidental Management API usage on the --local path.

Closes CLI-1812

…with-project-id-fails-and-db-url

github-actions · 2026-06-19T10:15:30Z

Supabase CLI preview

npx --yes https://pkg.pr.new/supabase/cli/supabase@534aa1650ea4b35964a2149b3687f52c82c345e2

Preview package for commit 534aa16.

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:6314b35001

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:864fdd786b

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…with-project-id-fails-and-db-url

Non-TypeScript project-ref typegen probed GET /v1/projects/{ref} and only fell back to the branch config endpoint when the 404 body contained the literal "Preview branch not found". The Management API's 404 wording is not guaranteed, so a differently-worded body would fail instead of falling back. Match the link handler, which treats any 404 from that endpoint as the preview-branch case. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017iEY7hzWEw2bGaURyXJmAm

Non-TypeScript `gen types --project-id <ref>` resolved the database connection through the linked DB resolver with the linked-workdir contract, which imported two assumptions that do not hold for an explicit, possibly-unrelated ref: - it read the ambient SUPABASE_DB_PASSWORD (shell / .env*) and, when the direct host was reachable, handed pg-meta that password instead of minting a temporary login role — sending an unrelated workdir password to a remote project; and - on an IPv4-only network it only consulted the saved .temp/pooler-url (which belongs to the linked workdir) and otherwise failed with the IPv6 "run supabase link" suggestion, even though the command already holds a Management API token. Add an `adHocProjectRef` resolver flag, set only for the explicit `--project-id` path (not `--linked`). In that mode the resolver ignores the ambient password (always minting a temp role) and, when the direct host is unreachable, fetches the primary pooler config for the ref from the Management API while ignoring the workdir's saved pooler URL. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017iEY7hzWEw2bGaURyXJmAm

…with-project-id-fails-and-db-url Resolve conflicts in functions/deploy realpath handling: adopt develop's `realpathIfExists` helper (deploy.ts) and `expectedDockerBind` test helper, which subsume this branch's equivalent `realpath`/`dockerBindSpec` changes. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_017iEY7hzWEw2bGaURyXJmAm

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:d23fac674e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

# Conflicts: # apps/cli/src/legacy/commands/gen/types/types.integration.test.ts # apps/cli/src/legacy/shared/legacy-db-config.layer.ts

…with-project-id-fails-and-db-url

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:56f9b60d56

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:43144279a2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:507ff5a94f

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:8c39065f76

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:087931a4bb

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:a8b60d4fa2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…with-project-id-fails-and-db-url

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:00a8ad6435

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

## What kind of change does this PR introduce? Bug fix / follow-up to PR #5622. ## What is the current behavior? Non-TypeScript `gen types` project-ref generation has a few edge cases around IPv6 fallback handling: - TLS probe failures can miss the IPv6 pooler fallback path. - Fallback can run for already-pooler-shaped connections. - Retry classification can trigger more than once. - Preview branch pooler URLs are parsed without the same tenant/domain validation used elsewhere. - Some integration tests depend on fixed local probe ports. ## What is the new behavior? This hardens the shared IPv6 pooler fallback flow and applies it consistently across `gen types`, `db dump`, and `db pull`. Notable changes: - Adds cause-aware IPv6 error classification for Node/system errors. - Adds a shared pooler fallback helper with direct-host gating and single retry semantics. - Reuses the existing pg-delta SSL probe service for `gen types`. - Hoists validated pooler connection parsing and uses it for preview branch fallback. - Keeps strict Swift/query-timeout validation behavior, except bare implicit TypeScript generation now warns and continues when `--query-timeout` is ignored. - Updates docs for the intentional Go parity divergences. ## Additional context This addresses the review findings on PR #5622 while preserving the existing behavior where retry outcomes replace the original attempt and fallback resolution failures preserve the original error.

…with-project-id-fails-and-db-url

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit:f2e2a775f5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…with-project-id-fails-and-db-url

avallete added 4 commits June 18, 2026 16:07

fix(cli): generate python types from project ref
7a633ed

fix(cli): use login role for project python typegen
de3b703

test(cli): cover project typegen languages
c08200b

fix: support project-ref type generation for non-TS langs
075020d

avallete changed the title ~~Fix project-ref type generation for non-TypeScript languages in CLI-1812~~fix(cli): generate non-TypeScript types from project refsJun 18, 2026

avalleteand others added 3 commits June 18, 2026 18:54

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
03bb11d
…with-project-id-fails-and-db-url

test(cli): cover local and remote typegen e2e
e8f27f8

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
6314b35
…with-project-id-fails-and-db-url

avallete marked this pull request as ready for review June 19, 2026 10:10

avallete requested a review from a team as a code owner June 19, 2026 10:10

chatgpt-codex-connectorBot reviewed Jun 19, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts Outdated
Comment threadsupabase/.temp/linked-project.json Outdated
Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts Outdated
Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts

avallete marked this pull request as draft June 20, 2026 06:33

avallete added 2 commits June 20, 2026 11:32

test(cli): stabilize typegen e2e coverage
cfc7143

fix(cli): route remote typegen through db resolver
864fdd7

avallete marked this pull request as ready for review June 20, 2026 12:20

chatgpt-codex-connectorBot reviewed Jun 20, 2026
View reviewed changes

avalleteand others added 4 commits June 22, 2026 13:30

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
3b18ec6
…with-project-id-fails-and-db-url

chatgpt-codex-connectorBot reviewed Jun 22, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts

jgoux added 3 commits June 29, 2026 15:28

Merge remote-tracking branch 'origin/develop' into pr-5622-review
bd9c93c
# Conflicts: # apps/cli/src/legacy/commands/gen/types/types.integration.test.ts # apps/cli/src/legacy/shared/legacy-db-config.layer.ts

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
8c46850
…with-project-id-fails-and-db-url

test(cli): seed access token in db config resolver test
56f9b60

chatgpt-codex-connectorBot reviewed Jun 29, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts

fix(cli): retry typegen pg-meta via pooler
4314427

chatgpt-codex-connectorBot reviewed Jun 30, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/shared/legacy-db-config.layer.ts
Comment threadapps/cli/src/legacy/commands/gen/types/types.e2e.test.ts
Comment threadapps/cli/src/legacy/commands/gen/types/types.e2e.test.ts

fix(cli): isolate typegen pooler fallback
507ff5a

chatgpt-codex-connectorBot reviewed Jul 1, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts
Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts Outdated

fix(cli): retry branch typegen via pooler
8c39065

chatgpt-codex-connectorBot reviewed Jul 1, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.e2e.test.ts
Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts

fix(cli): load linked typegen remote schemas
087931a

chatgpt-codex-connectorBot reviewed Jul 1, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts Outdated

fix(cli): retry typegen after probe fallback
a8b60d4

chatgpt-codex-connectorBot reviewed Jul 1, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts Outdated

jgouxand others added 3 commits July 2, 2026 00:08

fix(cli): use direct port for branch pooler retry
88f4115

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
a1e74cd
…with-project-id-fails-and-db-url

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
00a8ad6
…with-project-id-fails-and-db-url

chatgpt-codex-connectorBot reviewed Jul 3, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts Outdated

avallete mentioned this pull request Jul 3, 2026
fix(cli): harden gen types pooler fallback #5777
Merged

avallete added 2 commits July 3, 2026 15:00

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
f2e2a77
…with-project-id-fails-and-db-url

chatgpt-codex-connectorBot reviewed Jul 3, 2026
View reviewed changes

Comment threadapps/cli/src/legacy/commands/gen/types/types.handler.ts
Comment threadapps/cli/src/legacy/shared/legacy-pgdelta-ssl-probe.layer.ts
Comment threadapps/cli/src/legacy/shared/legacy-db-config.layer.ts

fix(cli): harden pg-meta pooler fallbacks
9280986

jgoux approved these changes Jul 3, 2026
View reviewed changes

Merge branch 'develop' into avallete/cli-1812-python-type-generation-…
2a1aff7
…with-project-id-fails-and-db-url

avallete enabled auto-merge July 4, 2026 07:56

avallete added this pull request to the merge queue Jul 4, 2026

github-merge-queueBot removed this pull request from the merge queue due to failed status checks Jul 4, 2026

fix(tests): e2e flawky gentypes tests
534aa16

avallete added this pull request to the merge queue Jul 4, 2026

Merged via the queue into develop with commit 31d6fb9Jul 4, 2026
13 checks passed

avallete deleted the avallete/cli-1812-python-type-generation-with-project-id-fails-and-db-url branch July 4, 2026 14:18

supabase-cli-releaserBot mentioned this pull request Jul 7, 2026
chore: production deploy #5812
Merged

chatgpt-codex-connectorBot mentioned this pull request Jul 7, 2026
docs(release): notes for v2.109.1 #5817
Closed

Uh oh!

Conversation

avallete commented Jun 18, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What changed

Why

Reviewer context

Uh oh!

github-actionsBot commented Jun 19, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Supabase CLI preview

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

chatgpt-codex-connectorBot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

avallete commented Jun 18, 2026•
edited
Loading

github-actionsBot commented Jun 19, 2026•
edited
Loading