neon 2.47.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 +395 -0
  5. package/dist/_shared/env-core/reuse-secrets.js +179 -0
  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 +575 -658
  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 +642 -681
  28. package/dist/commands/diff.js +156 -200
  29. package/dist/commands/env.js +243 -303
  30. package/dist/commands/functions.js +275 -341
  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 -64
  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 +133 -147
  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 +9 -7
@@ -1,172 +1,144 @@
1
+ import { __exportAll } from "../_virtual/_rolldown/runtime.js";
2
+ import { writer } from "../writer.js";
1
3
  import { EndpointType } from "../utils/api_enums.js";
2
4
  import { branchIdFromProps, fillSingleProject } from "../utils/enrichers.js";
3
5
  import { parsePITBranch } from "../utils/point_in_time.js";
4
6
  import { psql } from "../utils/psql.js";
5
- import { writer } from "../writer.js";
6
- export const SSL_MODES = [
7
- "require",
8
- "verify-ca",
9
- "verify-full",
10
- "omit",
7
+ //#region src/commands/connection_string.ts
8
+ var connection_string_exports = /* @__PURE__ */ __exportAll({
9
+ SSL_MODES: () => SSL_MODES,
10
+ aliases: () => aliases,
11
+ builder: () => builder,
12
+ command: () => command,
13
+ describe: () => describe,
14
+ handler: () => handler
15
+ });
16
+ const SSL_MODES = [
17
+ "require",
18
+ "verify-ca",
19
+ "verify-full",
20
+ "omit"
11
21
  ];
12
- export const command = "connection-string [branch]";
13
- export const aliases = ["cs"];
14
- export const describe = "Get connection string";
15
- export const builder = (argv) => {
16
- return argv
17
- .usage("$0 connection-string [branch] [options]")
18
- .example("$0 cs main", "Get connection string for the main branch")
19
- .example("$0 cs main@2024-01-01T00:00:00Z", "Get connection string for the main branch at a specific point in time")
20
- .example("$0 cs main@0/234235", "Get connection string for the main branch at a specific LSN")
21
- .positional("branch", {
22
- describe: `Branch name or id. Defaults to the default branch if omitted. Can be written in the point-in-time format: "branch@timestamp" or "branch@lsn"`,
23
- type: "string",
24
- })
25
- .options({
26
- "project-id": {
27
- type: "string",
28
- describe: "Project ID",
29
- },
30
- "role-name": {
31
- type: "string",
32
- describe: "Role name",
33
- },
34
- "database-name": {
35
- type: "string",
36
- describe: "Database name",
37
- },
38
- pooled: {
39
- type: "boolean",
40
- describe: "Use pooled connection",
41
- default: false,
42
- },
43
- prisma: {
44
- type: "boolean",
45
- describe: "Use connection string for Prisma setup",
46
- default: false,
47
- },
48
- "endpoint-type": {
49
- type: "string",
50
- choices: Object.values(EndpointType),
51
- describe: "Endpoint type",
52
- },
53
- extended: {
54
- type: "boolean",
55
- describe: "Show extended information",
56
- },
57
- psql: {
58
- type: "boolean",
59
- describe: "Connect to a database via psql using connection string",
60
- default: false,
61
- },
62
- fallback: {
63
- type: "boolean",
64
- describe: "Force the embedded TypeScript psql fallback (for testing)",
65
- default: false,
66
- hidden: true,
67
- },
68
- ssl: {
69
- type: "string",
70
- choices: SSL_MODES,
71
- default: "require",
72
- describe: "SSL mode",
73
- },
74
- })
75
- .middleware(fillSingleProject);
22
+ const command = "connection-string [branch]";
23
+ const aliases = ["cs"];
24
+ const describe = "Get connection string";
25
+ const builder = (argv) => {
26
+ return argv.usage("$0 connection-string [branch] [options]").example("$0 cs main", "Get connection string for the main branch").example("$0 cs main@2024-01-01T00:00:00Z", "Get connection string for the main branch at a specific point in time").example("$0 cs main@0/234235", "Get connection string for the main branch at a specific LSN").positional("branch", {
27
+ describe: `Branch name or id. Defaults to the default branch if omitted. Can be written in the point-in-time format: "branch@timestamp" or "branch@lsn"`,
28
+ type: "string"
29
+ }).options({
30
+ "project-id": {
31
+ type: "string",
32
+ describe: "Project ID"
33
+ },
34
+ "role-name": {
35
+ type: "string",
36
+ describe: "Role name"
37
+ },
38
+ "database-name": {
39
+ type: "string",
40
+ describe: "Database name"
41
+ },
42
+ pooled: {
43
+ type: "boolean",
44
+ describe: "Use pooled connection",
45
+ default: false
46
+ },
47
+ prisma: {
48
+ type: "boolean",
49
+ describe: "Use connection string for Prisma setup",
50
+ default: false
51
+ },
52
+ "endpoint-type": {
53
+ type: "string",
54
+ choices: Object.values(EndpointType),
55
+ describe: "Endpoint type"
56
+ },
57
+ extended: {
58
+ type: "boolean",
59
+ describe: "Show extended information"
60
+ },
61
+ psql: {
62
+ type: "boolean",
63
+ describe: "Connect to a database via psql using connection string",
64
+ default: false
65
+ },
66
+ fallback: {
67
+ type: "boolean",
68
+ describe: "Force the embedded TypeScript psql fallback (for testing)",
69
+ default: false,
70
+ hidden: true
71
+ },
72
+ ssl: {
73
+ type: "string",
74
+ choices: SSL_MODES,
75
+ default: "require",
76
+ describe: "SSL mode"
77
+ }
78
+ }).middleware(fillSingleProject);
76
79
  };
77
- export const handler = async (props) => {
78
- const projectId = props.projectId;
79
- const parsedPIT = props.branch
80
- ? parsePITBranch(props.branch)
81
- : { tag: "head", branch: "" };
82
- if (props.branch) {
83
- props.branch = parsedPIT.branch;
84
- }
85
- const branchId = await branchIdFromProps(props);
86
- const { data: { endpoints }, } = await props.apiClient.listProjectBranchEndpoints(projectId, branchId);
87
- const matchEndpointType = props.endpointType ?? EndpointType.ReadWrite;
88
- let endpoint = endpoints.find((e) => e.type === matchEndpointType);
89
- if (!endpoint && props.endpointType == null) {
90
- endpoint = endpoints[0];
91
- }
92
- if (!endpoint) {
93
- throw new Error(`No ${props.endpointType ?? ""} endpoint found for the branch: ${branchId}`);
94
- }
95
- const role = props.roleName ||
96
- (await props.apiClient
97
- .listProjectBranchRoles(projectId, branchId)
98
- .then(({ data }) => {
99
- if (data.roles.length === 0) {
100
- throw new Error(`No roles found for the branch: ${branchId}`);
101
- }
102
- if (data.roles.length === 1) {
103
- return data.roles[0].name;
104
- }
105
- throw new Error(`Multiple roles found for the branch, please provide one with the --role-name option: ${data.roles
106
- .map((r) => r.name)
107
- .join(", ")}`);
108
- }));
109
- const { data: { databases: branchDatabases }, } = await props.apiClient.listProjectBranchDatabases(projectId, branchId);
110
- const database = props.databaseName ||
111
- (() => {
112
- if (branchDatabases.length === 0) {
113
- throw new Error(`No databases found for the branch: ${branchId}`);
114
- }
115
- if (branchDatabases.length === 1) {
116
- return branchDatabases[0].name;
117
- }
118
- throw new Error(`Multiple databases found for the branch, please provide one with the --database-name option: ${branchDatabases
119
- .map((d) => d.name)
120
- .join(", ")}`);
121
- })();
122
- if (!branchDatabases.find((d) => d.name === database)) {
123
- throw new Error(`Database not found: ${database}`);
124
- }
125
- const { data: { password }, } = await props.apiClient.getProjectBranchRolePassword(props.projectId, endpoint.branch_id, role);
126
- let host = props.pooled
127
- ? endpoint.host.replace(endpoint.id, `${endpoint.id}-pooler`)
128
- : endpoint.host;
129
- if (parsedPIT.tag !== "head") {
130
- host = endpoint.host.replace(endpoint.id, endpoint.branch_id);
131
- }
132
- const connectionString = new URL(`postgresql://${host}`);
133
- connectionString.pathname = database;
134
- connectionString.username = role;
135
- connectionString.password = password;
136
- if (props.prisma) {
137
- connectionString.searchParams.set("connect_timeout", "30");
138
- if (props.pooled) {
139
- connectionString.searchParams.set("pool_timeout", "30");
140
- connectionString.searchParams.set("pgbouncer", "true");
141
- }
142
- }
143
- if (props.ssl !== "omit") {
144
- connectionString.searchParams.set("sslmode", props.ssl);
145
- connectionString.searchParams.set("channel_binding", "require");
146
- }
147
- if (parsedPIT.tag === "lsn") {
148
- connectionString.searchParams.set("options", `neon_lsn:${parsedPIT.lsn}`);
149
- }
150
- else if (parsedPIT.tag === "timestamp") {
151
- connectionString.searchParams.set("options", `neon_timestamp:${parsedPIT.timestamp}`);
152
- }
153
- if (props.psql) {
154
- const psqlArgs = props["--"];
155
- await psql(connectionString.toString(), psqlArgs, {
156
- mode: props.fallback ? "ts" : "auto",
157
- });
158
- }
159
- else if (props.extended) {
160
- writer(props).end({
161
- connection_string: connectionString.toString(),
162
- host,
163
- role,
164
- password,
165
- database,
166
- options: connectionString.searchParams.toString(),
167
- }, { fields: ["host", "role", "password", "database"] });
168
- }
169
- else {
170
- process.stdout.write(connectionString.toString() + "\n");
171
- }
80
+ const handler = async (props) => {
81
+ const projectId = props.projectId;
82
+ const parsedPIT = props.branch ? parsePITBranch(props.branch) : {
83
+ tag: "head",
84
+ branch: ""
85
+ };
86
+ if (props.branch) props.branch = parsedPIT.branch;
87
+ const branchId = await branchIdFromProps(props);
88
+ const { data: { endpoints } } = await props.apiClient.listProjectBranchEndpoints(projectId, branchId);
89
+ const matchEndpointType = props.endpointType ?? EndpointType.ReadWrite;
90
+ let endpoint = endpoints.find((e) => e.type === matchEndpointType);
91
+ if (!endpoint && props.endpointType == null) endpoint = endpoints[0];
92
+ if (!endpoint) throw new Error(`No ${props.endpointType ?? ""} endpoint found for the branch: ${branchId}`);
93
+ const role = props.roleName || await props.apiClient.listProjectBranchRoles(projectId, branchId).then(({ data }) => {
94
+ if (data.roles.length === 0) throw new Error(`No roles found for the branch: ${branchId}`);
95
+ if (data.roles.length === 1) return data.roles[0].name;
96
+ throw new Error(`Multiple roles found for the branch, please provide one with the --role-name option: ${data.roles.map((r) => r.name).join(", ")}`);
97
+ });
98
+ const { data: { databases: branchDatabases } } = await props.apiClient.listProjectBranchDatabases(projectId, branchId);
99
+ const database = props.databaseName || (() => {
100
+ if (branchDatabases.length === 0) throw new Error(`No databases found for the branch: ${branchId}`);
101
+ if (branchDatabases.length === 1) return branchDatabases[0].name;
102
+ throw new Error(`Multiple databases found for the branch, please provide one with the --database-name option: ${branchDatabases.map((d) => d.name).join(", ")}`);
103
+ })();
104
+ if (!branchDatabases.find((d) => d.name === database)) throw new Error(`Database not found: ${database}`);
105
+ const { data: { password } } = await props.apiClient.getProjectBranchRolePassword(props.projectId, endpoint.branch_id, role);
106
+ let host = props.pooled ? endpoint.host.replace(endpoint.id, `${endpoint.id}-pooler`) : endpoint.host;
107
+ if (parsedPIT.tag !== "head") host = endpoint.host.replace(endpoint.id, endpoint.branch_id);
108
+ const connectionString = new URL(`postgresql://${host}`);
109
+ connectionString.pathname = database;
110
+ connectionString.username = role;
111
+ connectionString.password = password;
112
+ if (props.prisma) {
113
+ connectionString.searchParams.set("connect_timeout", "30");
114
+ if (props.pooled) {
115
+ connectionString.searchParams.set("pool_timeout", "30");
116
+ connectionString.searchParams.set("pgbouncer", "true");
117
+ }
118
+ }
119
+ if (props.ssl !== "omit") {
120
+ connectionString.searchParams.set("sslmode", props.ssl);
121
+ connectionString.searchParams.set("channel_binding", "require");
122
+ }
123
+ if (parsedPIT.tag === "lsn") connectionString.searchParams.set("options", `neon_lsn:${parsedPIT.lsn}`);
124
+ else if (parsedPIT.tag === "timestamp") connectionString.searchParams.set("options", `neon_timestamp:${parsedPIT.timestamp}`);
125
+ if (props.psql) {
126
+ const psqlArgs = props["--"];
127
+ await psql(connectionString.toString(), psqlArgs, { mode: props.fallback ? "ts" : "auto" });
128
+ } else if (props.extended) writer(props).end({
129
+ connection_string: connectionString.toString(),
130
+ host,
131
+ role,
132
+ password,
133
+ database,
134
+ options: connectionString.searchParams.toString()
135
+ }, { fields: [
136
+ "host",
137
+ "role",
138
+ "password",
139
+ "database"
140
+ ] });
141
+ else process.stdout.write(connectionString.toString() + "\n");
172
142
  };
143
+ //#endregion
144
+ export { SSL_MODES, aliases, builder, command, connection_string_exports, describe, handler };