neon 3.0.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/README.md +54 -0
  2. package/dist/_shared/auth_selection.js +76 -79
  3. package/dist/_shared/credentials.js +166 -187
  4. package/dist/_shared/env-core/env.js +354 -517
  5. package/dist/_shared/env-core/reuse-secrets.js +159 -203
  6. package/dist/_shared/paths.js +129 -126
  7. package/dist/_shared/profiles.js +192 -242
  8. package/dist/_shared/secure_file.js +36 -38
  9. package/dist/_virtual/_rolldown/runtime.js +13 -0
  10. package/dist/analytics.js +163 -207
  11. package/dist/api.js +815 -758
  12. package/dist/auth.js +121 -141
  13. package/dist/auth_context.js +39 -53
  14. package/dist/cli.js +4 -7
  15. package/dist/commands/api.js +220 -250
  16. package/dist/commands/api_keys.js +251 -314
  17. package/dist/commands/auth.js +283 -328
  18. package/dist/commands/bootstrap.js +372 -437
  19. package/dist/commands/branches.js +304 -455
  20. package/dist/commands/bucket.js +374 -514
  21. package/dist/commands/checkout.js +213 -298
  22. package/dist/commands/config.js +573 -690
  23. package/dist/commands/connection_string.js +137 -165
  24. package/dist/commands/data_api.js +238 -260
  25. package/dist/commands/databases.js +67 -76
  26. package/dist/commands/deploy.js +31 -25
  27. package/dist/commands/dev.js +639 -719
  28. package/dist/commands/diff.js +156 -200
  29. package/dist/commands/env.js +243 -303
  30. package/dist/commands/functions.js +275 -355
  31. package/dist/commands/index.js +70 -65
  32. package/dist/commands/init.js +84 -119
  33. package/dist/commands/inspect.js +55 -55
  34. package/dist/commands/ip_allow.js +88 -120
  35. package/dist/commands/link.js +874 -1019
  36. package/dist/commands/logs.js +291 -0
  37. package/dist/commands/neon_auth.js +725 -933
  38. package/dist/commands/operations.js +34 -25
  39. package/dist/commands/orgs.js +28 -18
  40. package/dist/commands/profile.js +614 -845
  41. package/dist/commands/projects.js +313 -373
  42. package/dist/commands/psql.js +60 -58
  43. package/dist/commands/roles.js +55 -58
  44. package/dist/commands/schema_diff.js +87 -131
  45. package/dist/commands/set_context.js +34 -26
  46. package/dist/commands/snapshots.js +288 -413
  47. package/dist/commands/status.js +41 -37
  48. package/dist/commands/user.js +21 -10
  49. package/dist/commands/vpc_endpoints.js +85 -113
  50. package/dist/config.js +7 -6
  51. package/dist/config_format.js +50 -66
  52. package/dist/config_template.js +128 -157
  53. package/dist/context.js +183 -235
  54. package/dist/current_branch_fast_path.js +40 -49
  55. package/dist/dev/env.js +313 -394
  56. package/dist/dev/functions.js +54 -68
  57. package/dist/dev/inputs.js +46 -58
  58. package/dist/dev/runtime.js +135 -164
  59. package/dist/dev/websocket.js +766 -959
  60. package/dist/env.js +27 -33
  61. package/dist/env_file.js +118 -132
  62. package/dist/env_services.js +36 -38
  63. package/dist/errors.js +57 -68
  64. package/dist/functions_api.js +45 -43
  65. package/dist/help.js +189 -140
  66. package/dist/index.js +182 -257
  67. package/dist/init/agents.js +137 -118
  68. package/dist/init/auth.js +58 -68
  69. package/dist/init/bootstrap.js +325 -396
  70. package/dist/init/build_config.js +4 -2
  71. package/dist/init/detect_agent.js +56 -101
  72. package/dist/init/editors.js +35 -52
  73. package/dist/init/enrich_output.js +51 -66
  74. package/dist/init/extension.js +134 -171
  75. package/dist/init/inspect.js +179 -266
  76. package/dist/init/interactive.js +510 -622
  77. package/dist/init/neonctl.js +117 -168
  78. package/dist/init/orchestrate.js +157 -173
  79. package/dist/init/phases/auth.js +188 -202
  80. package/dist/init/phases/cleanup.js +23 -23
  81. package/dist/init/phases/db.js +251 -277
  82. package/dist/init/phases/getting_started.js +213 -223
  83. package/dist/init/phases/mcp.js +174 -224
  84. package/dist/init/phases/migrations.js +247 -248
  85. package/dist/init/phases/neon_auth.js +114 -133
  86. package/dist/init/phases/setup.js +546 -703
  87. package/dist/init/phases/skills.js +75 -86
  88. package/dist/init/phases/status.js +72 -67
  89. package/dist/init/resolve_context.js +102 -99
  90. package/dist/init/route_command.js +91 -98
  91. package/dist/init/skills.js +174 -218
  92. package/dist/init/vsix.js +77 -99
  93. package/dist/log.js +17 -16
  94. package/dist/neon_services.js +104 -129
  95. package/dist/parameters.gen.js +481 -471
  96. package/dist/pkg.js +17 -19
  97. package/dist/profile_keys.js +44 -47
  98. package/dist/psql/cli.js +44 -47
  99. package/dist/psql/command/cmd_cond.js +231 -406
  100. package/dist/psql/command/cmd_connect.js +557 -764
  101. package/dist/psql/command/cmd_copy.js +727 -983
  102. package/dist/psql/command/cmd_describe.js +1499 -1688
  103. package/dist/psql/command/cmd_format.js +733 -905
  104. package/dist/psql/command/cmd_io.js +1293 -2082
  105. package/dist/psql/command/cmd_lo.js +297 -359
  106. package/dist/psql/command/cmd_meta.js +727 -878
  107. package/dist/psql/command/cmd_misc.js +138 -172
  108. package/dist/psql/command/cmd_pipeline.js +547 -1099
  109. package/dist/psql/command/cmd_restrict.js +119 -155
  110. package/dist/psql/command/cmd_show.js +529 -688
  111. package/dist/psql/command/dispatch.js +261 -325
  112. package/dist/psql/command/inputQueue.js +35 -33
  113. package/dist/psql/command/shared.js +49 -63
  114. package/dist/psql/complete/filenames.js +90 -133
  115. package/dist/psql/complete/index.js +59 -97
  116. package/dist/psql/complete/matcher.js +236 -300
  117. package/dist/psql/complete/psqlVars.js +218 -223
  118. package/dist/psql/complete/queries.js +159 -177
  119. package/dist/psql/complete/rules.js +1493 -2299
  120. package/dist/psql/core/common.js +762 -1180
  121. package/dist/psql/core/help.js +456 -546
  122. package/dist/psql/core/mainloop.js +692 -1302
  123. package/dist/psql/core/prompt.js +391 -408
  124. package/dist/psql/core/settings.js +429 -644
  125. package/dist/psql/core/sqlHelp.js +480 -554
  126. package/dist/psql/core/startup.js +626 -815
  127. package/dist/psql/core/syncVars.js +67 -110
  128. package/dist/psql/core/variables.js +156 -278
  129. package/dist/psql/describe/formatters.js +884 -1285
  130. package/dist/psql/describe/processNamePattern.js +173 -260
  131. package/dist/psql/describe/queries.js +1368 -2403
  132. package/dist/psql/describe/versionGate.js +32 -41
  133. package/dist/psql/index.js +1414 -1927
  134. package/dist/psql/io/history.js +232 -271
  135. package/dist/psql/io/input.js +103 -108
  136. package/dist/psql/io/lineEditor/buffer.js +238 -319
  137. package/dist/psql/io/lineEditor/complete.js +135 -213
  138. package/dist/psql/io/lineEditor/filename.js +139 -148
  139. package/dist/psql/io/lineEditor/index.js +653 -870
  140. package/dist/psql/io/lineEditor/keymap.js +544 -702
  141. package/dist/psql/io/lineEditor/vt100.js +294 -341
  142. package/dist/psql/io/pgpass.js +158 -187
  143. package/dist/psql/io/pgservice.js +146 -183
  144. package/dist/psql/io/psqlrc.js +328 -403
  145. package/dist/psql/print/aligned.js +1020 -1683
  146. package/dist/psql/print/asciidoc.js +180 -214
  147. package/dist/psql/print/crosstab.js +281 -442
  148. package/dist/psql/print/csv.js +48 -70
  149. package/dist/psql/print/html.js +195 -226
  150. package/dist/psql/print/json.js +75 -88
  151. package/dist/psql/print/latex.js +291 -364
  152. package/dist/psql/print/pager.js +171 -242
  153. package/dist/psql/print/troff.js +194 -226
  154. package/dist/psql/print/unaligned.js +69 -95
  155. package/dist/psql/print/units.js +167 -169
  156. package/dist/psql/scanner/slash.js +428 -483
  157. package/dist/psql/scanner/sql.js +445 -889
  158. package/dist/psql/scanner/stringutils.js +309 -379
  159. package/dist/psql/types/index.js +2 -7
  160. package/dist/psql/types/scanner.js +25 -22
  161. package/dist/psql/wire/connection.js +2042 -2803
  162. package/dist/psql/wire/copy.js +84 -100
  163. package/dist/psql/wire/notify.js +39 -59
  164. package/dist/psql/wire/pipeline.js +305 -518
  165. package/dist/psql/wire/protocol.js +349 -417
  166. package/dist/psql/wire/sasl.js +180 -265
  167. package/dist/psql/wire/tls.js +400 -561
  168. package/dist/storage_api.js +115 -129
  169. package/dist/test_utils/fixtures.js +94 -113
  170. package/dist/test_utils/oauth_server.js +10 -7
  171. package/dist/test_utils/project_dir.js +33 -0
  172. package/dist/utils/ai_gateway_notice.js +131 -162
  173. package/dist/utils/api_enums.js +21 -28
  174. package/dist/utils/auth.js +10 -4
  175. package/dist/utils/branch_notice.js +20 -19
  176. package/dist/utils/branch_picker.js +83 -89
  177. package/dist/utils/cli_name.js +15 -12
  178. package/dist/utils/compute_units.js +20 -27
  179. package/dist/utils/config_diff.js +127 -158
  180. package/dist/utils/enrichers.js +95 -148
  181. package/dist/utils/esbuild.js +130 -189
  182. package/dist/utils/flags.js +35 -47
  183. package/dist/utils/formats.js +8 -15
  184. package/dist/utils/git_diff.js +69 -80
  185. package/dist/utils/inspect_db.js +101 -143
  186. package/dist/utils/inspect_queries.js +179 -142
  187. package/dist/utils/middlewares.js +37 -44
  188. package/dist/utils/openapi.js +87 -99
  189. package/dist/utils/package_manager.js +312 -110
  190. package/dist/utils/point_in_time.js +49 -53
  191. package/dist/utils/psql.js +89 -106
  192. package/dist/utils/service_picker.js +55 -58
  193. package/dist/utils/string.js +5 -5
  194. package/dist/utils/ui.js +38 -55
  195. package/dist/utils/write_sync.js +26 -35
  196. package/dist/utils/zip.js +4 -3
  197. package/dist/writer.js +67 -87
  198. package/package.json +7 -5
@@ -1,227 +1,177 @@
1
1
  import { resolveAddMcpAgentId } from "../agents.js";
2
2
  import { isAuthenticated } from "../auth.js";
3
- export async function handleMcpPhase(options) {
4
- const agentArgs = options.agent
5
- ? ["--agent", options.agent, "--json"]
6
- : ["--json"];
7
- // --status: just report what we know
8
- if (options.status) {
9
- return {
10
- phase: "tooling",
11
- status: "status",
12
- nextAction: {
13
- type: "agent_check",
14
- checks: [
15
- {
16
- id: "mcp_server",
17
- description: "Check if the Neon MCP server is already configured in your MCP server list",
18
- lookFor: [
19
- "An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'",
20
- ],
21
- },
22
- ],
23
- reportBack: {
24
- type: "run_neon_init",
25
- args: [
26
- "mcp",
27
- "--json",
28
- ...(options.agent ? ["--agent", options.agent] : []),
29
- "--mcp-configured",
30
- "<true|false>",
31
- ],
32
- },
33
- },
34
- };
35
- }
36
- // --install: proceed with installation
37
- if (options.install) {
38
- const authed = await isAuthenticated();
39
- if (!authed) {
40
- return {
41
- phase: "tooling",
42
- status: "auth_required",
43
- nextAction: {
44
- type: "run_neon_init",
45
- args: ["auth", "--json"],
46
- },
47
- };
48
- }
49
- // Build the add-mcp command
50
- const scope = options.scope ?? "global";
51
- const mcpAgentId = resolveAddMcpAgentId(options.agent ?? "claude-code");
52
- const isCursor = mcpAgentId === "cursor" ||
53
- options.agent?.toLowerCase() === "cursor";
54
- const isClaudeCode = mcpAgentId === "claude-code" ||
55
- options.agent?.toLowerCase() === "claude-code";
56
- const installCmd = [
57
- "npx -y add-mcp https://mcp.neon.tech/mcp",
58
- scope === "global" ? "-g" : "",
59
- "-n Neon",
60
- "-y",
61
- `-a ${mcpAgentId}`,
62
- ]
63
- .filter(Boolean)
64
- .join(" ");
65
- let enableNote = "";
66
- if (isCursor && scope === "project") {
67
- enableNote =
68
- ' Note: Cursor disables project-level MCP servers by default — after installation, open Cursor Settings > MCP and toggle the "Neon" server on.';
69
- }
70
- else if (isClaudeCode) {
71
- enableNote =
72
- ' Note: Claude Code requires approval for newly added MCP servers. When prompted, approve the "Neon" server to enable it.';
73
- }
74
- return {
75
- phase: "tooling",
76
- status: "installing",
77
- nextAction: {
78
- type: "run_command",
79
- command: installCmd,
80
- description: `Installing Neon MCP server (${scope} scope) for ${mcpAgentId}.${enableNote}`,
81
- timeout: 60000,
82
- onSuccess: {
83
- type: "run_neon_init",
84
- args: [
85
- "skills",
86
- "--json",
87
- ...(options.agent ? ["--agent", options.agent] : []),
88
- "--install",
89
- ],
90
- },
91
- onFailure: {
92
- other: {
93
- type: "ask_user",
94
- question: "Failed to install the Neon MCP server automatically. Would you like to try again or configure it manually?",
95
- options: [
96
- { value: "retry", label: "Try again" },
97
- {
98
- value: "manual",
99
- label: "I'll configure it manually",
100
- },
101
- ],
102
- responseMapping: {
103
- retry: {
104
- args: [
105
- "mcp",
106
- "--json",
107
- ...(options.agent
108
- ? ["--agent", options.agent]
109
- : []),
110
- "--install",
111
- ],
112
- },
113
- manual: {
114
- args: agentArgs,
115
- },
116
- },
117
- },
118
- },
119
- },
120
- };
121
- }
122
- // Agent reported detection result via --mcp-configured
123
- if (options.mcpConfigured === true) {
124
- // MCP is done — chain to skills installation (not back to orchestrator,
125
- // which would re-check MCP and loop since skills aren't installed yet).
126
- return {
127
- phase: "tooling",
128
- status: "mcp_configured",
129
- nextAction: {
130
- type: "run_neon_init",
131
- args: [
132
- "skills",
133
- "--json",
134
- ...(options.agent ? ["--agent", options.agent] : []),
135
- "--install",
136
- ],
137
- },
138
- };
139
- }
140
- if (options.mcpConfigured === false) {
141
- return {
142
- phase: "tooling",
143
- status: "install_needed",
144
- nextAction: {
145
- type: "ask_user",
146
- question: "The Neon MCP server is not yet configured. Would you like to install it?",
147
- options: [
148
- {
149
- value: "defaults",
150
- label: "Yes, install with default settings",
151
- },
152
- {
153
- value: "project_scope",
154
- label: "Yes, install for this project only",
155
- },
156
- { value: "skip", label: "Skip for now" },
157
- ],
158
- context: "The Neon MCP server gives your AI assistant direct access to Neon database operations like creating projects, running queries, and managing branches." +
159
- (options.agent?.toLowerCase() === "cursor" ||
160
- options.editor?.toLowerCase() === "cursor"
161
- ? " Note: Cursor disables project-level MCP servers by default. If you choose project scope, you will need to manually enable the Neon server in Cursor Settings > MCP. Global scope is recommended for Cursor."
162
- : ""),
163
- responseMapping: {
164
- defaults: {
165
- args: [
166
- "mcp",
167
- "--json",
168
- ...(options.agent
169
- ? ["--agent", options.agent]
170
- : []),
171
- "--install",
172
- ],
173
- },
174
- project_scope: {
175
- args: [
176
- "mcp",
177
- "--json",
178
- ...(options.agent
179
- ? ["--agent", options.agent]
180
- : []),
181
- "--install",
182
- "--scope",
183
- "project",
184
- ],
185
- },
186
- skip: {
187
- args: [
188
- "skills",
189
- "--json",
190
- ...(options.agent
191
- ? ["--agent", options.agent]
192
- : []),
193
- "--install",
194
- ],
195
- },
196
- },
197
- },
198
- };
199
- }
200
- // Default: ask the agent to check
201
- return {
202
- phase: "tooling",
203
- status: "detection_needed",
204
- nextAction: {
205
- type: "agent_check",
206
- checks: [
207
- {
208
- id: "mcp_server",
209
- description: "Check if the Neon MCP server is already configured in your MCP server list",
210
- lookFor: [
211
- "An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'",
212
- ],
213
- },
214
- ],
215
- reportBack: {
216
- type: "run_neon_init",
217
- args: [
218
- "mcp",
219
- "--json",
220
- ...(options.agent ? ["--agent", options.agent] : []),
221
- "--mcp-configured",
222
- "<true|false>",
223
- ],
224
- },
225
- },
226
- };
3
+ //#region src/init/phases/mcp.ts
4
+ async function handleMcpPhase(options) {
5
+ const agentArgs = options.agent ? [
6
+ "--agent",
7
+ options.agent,
8
+ "--json"
9
+ ] : ["--json"];
10
+ if (options.status) return {
11
+ phase: "tooling",
12
+ status: "status",
13
+ nextAction: {
14
+ type: "agent_check",
15
+ checks: [{
16
+ id: "mcp_server",
17
+ description: "Check if the Neon MCP server is already configured in your MCP server list",
18
+ lookFor: ["An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'"]
19
+ }],
20
+ reportBack: {
21
+ type: "run_neon_init",
22
+ args: [
23
+ "mcp",
24
+ "--json",
25
+ ...options.agent ? ["--agent", options.agent] : [],
26
+ "--mcp-configured",
27
+ "<true|false>"
28
+ ]
29
+ }
30
+ }
31
+ };
32
+ if (options.install) {
33
+ if (!await isAuthenticated()) return {
34
+ phase: "tooling",
35
+ status: "auth_required",
36
+ nextAction: {
37
+ type: "run_neon_init",
38
+ args: ["auth", "--json"]
39
+ }
40
+ };
41
+ const scope = options.scope ?? "global";
42
+ const mcpAgentId = resolveAddMcpAgentId(options.agent ?? "claude-code");
43
+ const isCursor = mcpAgentId === "cursor" || options.agent?.toLowerCase() === "cursor";
44
+ const isClaudeCode = mcpAgentId === "claude-code" || options.agent?.toLowerCase() === "claude-code";
45
+ const installCmd = [
46
+ "npx -y add-mcp https://mcp.neon.tech/mcp",
47
+ scope === "global" ? "-g" : "",
48
+ "-n Neon",
49
+ "-y",
50
+ `-a ${mcpAgentId}`
51
+ ].filter(Boolean).join(" ");
52
+ let enableNote = "";
53
+ if (isCursor && scope === "project") enableNote = " Note: Cursor disables project-level MCP servers by default — after installation, open Cursor Settings > MCP and toggle the \"Neon\" server on.";
54
+ else if (isClaudeCode) enableNote = " Note: Claude Code requires approval for newly added MCP servers. When prompted, approve the \"Neon\" server to enable it.";
55
+ return {
56
+ phase: "tooling",
57
+ status: "installing",
58
+ nextAction: {
59
+ type: "run_command",
60
+ command: installCmd,
61
+ description: `Installing Neon MCP server (${scope} scope) for ${mcpAgentId}.${enableNote}`,
62
+ timeout: 6e4,
63
+ onSuccess: {
64
+ type: "run_neon_init",
65
+ args: [
66
+ "skills",
67
+ "--json",
68
+ ...options.agent ? ["--agent", options.agent] : [],
69
+ "--install"
70
+ ]
71
+ },
72
+ onFailure: { other: {
73
+ type: "ask_user",
74
+ question: "Failed to install the Neon MCP server automatically. Would you like to try again or configure it manually?",
75
+ options: [{
76
+ value: "retry",
77
+ label: "Try again"
78
+ }, {
79
+ value: "manual",
80
+ label: "I'll configure it manually"
81
+ }],
82
+ responseMapping: {
83
+ retry: { args: [
84
+ "mcp",
85
+ "--json",
86
+ ...options.agent ? ["--agent", options.agent] : [],
87
+ "--install"
88
+ ] },
89
+ manual: { args: agentArgs }
90
+ }
91
+ } }
92
+ }
93
+ };
94
+ }
95
+ if (options.mcpConfigured === true) return {
96
+ phase: "tooling",
97
+ status: "mcp_configured",
98
+ nextAction: {
99
+ type: "run_neon_init",
100
+ args: [
101
+ "skills",
102
+ "--json",
103
+ ...options.agent ? ["--agent", options.agent] : [],
104
+ "--install"
105
+ ]
106
+ }
107
+ };
108
+ if (options.mcpConfigured === false) return {
109
+ phase: "tooling",
110
+ status: "install_needed",
111
+ nextAction: {
112
+ type: "ask_user",
113
+ question: "The Neon MCP server is not yet configured. Would you like to install it?",
114
+ options: [
115
+ {
116
+ value: "defaults",
117
+ label: "Yes, install with default settings"
118
+ },
119
+ {
120
+ value: "project_scope",
121
+ label: "Yes, install for this project only"
122
+ },
123
+ {
124
+ value: "skip",
125
+ label: "Skip for now"
126
+ }
127
+ ],
128
+ context: "The Neon MCP server gives your AI assistant direct access to Neon database operations like creating projects, running queries, and managing branches." + (options.agent?.toLowerCase() === "cursor" || options.editor?.toLowerCase() === "cursor" ? " Note: Cursor disables project-level MCP servers by default. If you choose project scope, you will need to manually enable the Neon server in Cursor Settings > MCP. Global scope is recommended for Cursor." : ""),
129
+ responseMapping: {
130
+ defaults: { args: [
131
+ "mcp",
132
+ "--json",
133
+ ...options.agent ? ["--agent", options.agent] : [],
134
+ "--install"
135
+ ] },
136
+ project_scope: { args: [
137
+ "mcp",
138
+ "--json",
139
+ ...options.agent ? ["--agent", options.agent] : [],
140
+ "--install",
141
+ "--scope",
142
+ "project"
143
+ ] },
144
+ skip: { args: [
145
+ "skills",
146
+ "--json",
147
+ ...options.agent ? ["--agent", options.agent] : [],
148
+ "--install"
149
+ ] }
150
+ }
151
+ }
152
+ };
153
+ return {
154
+ phase: "tooling",
155
+ status: "detection_needed",
156
+ nextAction: {
157
+ type: "agent_check",
158
+ checks: [{
159
+ id: "mcp_server",
160
+ description: "Check if the Neon MCP server is already configured in your MCP server list",
161
+ lookFor: ["An MCP server entry named 'Neon' or with URL containing 'mcp.neon.tech'"]
162
+ }],
163
+ reportBack: {
164
+ type: "run_neon_init",
165
+ args: [
166
+ "mcp",
167
+ "--json",
168
+ ...options.agent ? ["--agent", options.agent] : [],
169
+ "--mcp-configured",
170
+ "<true|false>"
171
+ ]
172
+ }
173
+ }
174
+ };
227
175
  }
176
+ //#endregion
177
+ export { handleMcpPhase };