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
package/dist/pkg.js CHANGED
@@ -1,25 +1,23 @@
1
1
  import { readFileSync } from "node:fs";
2
2
  import { dirname, join } from "node:path";
3
3
  import { fileURLToPath } from "node:url";
4
+ //#region src/pkg.ts
4
5
  /**
5
- * Load the CLI's package.json for version metadata. In the built CLI it sits right next to
6
- * this module (the build copies it into `dist`); when running from source (tests, `tsx`) it
7
- * does not, so we walk up to the nearest `package.json`. Both layouts resolve to the same
8
- * file, keeping `pkg.version` correct everywhere without a test-only shim.
9
- */
6
+ * Load the CLI's package.json for version metadata. In the built CLI it sits right next to
7
+ * this module (the build copies it into `dist`); when running from source (tests, `tsx`) it
8
+ * does not, so we walk up to the nearest `package.json`. Both layouts resolve to the same
9
+ * file, keeping `pkg.version` correct everywhere without a test-only shim.
10
+ */
10
11
  const loadPkg = () => {
11
- let dir = dirname(fileURLToPath(import.meta.url));
12
- for (;;) {
13
- try {
14
- return JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
15
- }
16
- catch {
17
- const parent = dirname(dir);
18
- if (parent === dir) {
19
- throw new Error("Could not locate package.json for version detection.");
20
- }
21
- dir = parent;
22
- }
23
- }
12
+ let dir = dirname(fileURLToPath(import.meta.url));
13
+ for (;;) try {
14
+ return JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
15
+ } catch {
16
+ const parent = dirname(dir);
17
+ if (parent === dir) throw new Error("Could not locate package.json for version detection.");
18
+ dir = parent;
19
+ }
24
20
  };
25
- export default loadPkg();
21
+ var pkg_default = loadPkg();
22
+ //#endregion
23
+ export { pkg_default as default };
@@ -1,55 +1,52 @@
1
- /**
2
- * Helpers for the API-key half of a profile: naming a minted key, reading one off disk, and
3
- * turning what the API says about a key into something displayable.
4
- *
5
- * Kept apart from `./commands/profile.ts` because these are the decisions worth testing
6
- * directly — the command around them is prompts, an API client, and output.
7
- */
8
1
  import { randomBytes } from "node:crypto";
2
+ //#region src/profile_keys.ts
3
+ /**
4
+ * Helpers for the API-key half of a profile: naming a minted key, reading one off disk, and
5
+ * turning what the API says about a key into something displayable.
6
+ *
7
+ * Kept apart from `./commands/profile.ts` because these are the decisions worth testing
8
+ * directly — the command around them is prompts, an API client, and output.
9
+ */
9
10
  /** Auth methods that are an API key. Anything else is not a key and must not be stored as one. */
10
11
  const API_KEY_METHODS = ["api_key_user", "api_key_org"];
11
- export const isApiKeyMethod = (method) => API_KEY_METHODS.includes(method);
12
+ const isApiKeyMethod = (method) => API_KEY_METHODS.includes(method);
12
13
  /**
13
- * A unique name for a key we mint, carrying the profile it belongs to, a UTC timestamp, and a
14
- * random suffix.
15
- *
16
- * Neither part is decoration. Key names are unique per account and the key being replaced still
17
- * holds its name while the replacement is minted, so a stable name fails the rotation outright
18
- * with `choose another unique name for api key`.
19
- *
20
- * The random suffix is there because a timestamp alone is not enough: at second precision two
21
- * rotations in the same second collide, which is easy to hit from a script and was hit while
22
- * testing this. Going to milliseconds only narrows the window, so the name carries four random
23
- * hex characters and the class of failure is gone rather than made less likely.
24
- */
25
- export const mintedKeyName = (profile, now = new Date(), suffix = randomBytes(2).toString("hex")) => {
26
- const stamp = now
27
- .toISOString()
28
- .replace(/[-:]/g, "")
29
- .replace(/\.\d+Z$/, "Z");
30
- return `neon-cli-${profile}-${stamp}-${suffix}`;
14
+ * A unique name for a key we mint, carrying the profile it belongs to, a UTC timestamp, and a
15
+ * random suffix.
16
+ *
17
+ * Neither part is decoration. Key names are unique per account and the key being replaced still
18
+ * holds its name while the replacement is minted, so a stable name fails the rotation outright
19
+ * with `choose another unique name for api key`.
20
+ *
21
+ * The random suffix is there because a timestamp alone is not enough: at second precision two
22
+ * rotations in the same second collide, which is easy to hit from a script and was hit while
23
+ * testing this. Going to milliseconds only narrows the window, so the name carries four random
24
+ * hex characters and the class of failure is gone rather than made less likely.
25
+ */
26
+ const mintedKeyName = (profile, now = /* @__PURE__ */ new Date(), suffix = randomBytes(2).toString("hex")) => {
27
+ return `neon-cli-${profile}-${now.toISOString().replace(/[-:]/g, "").replace(/\.\d+Z$/, "Z")}-${suffix}`;
31
28
  };
32
29
  /**
33
- * What to record about a validated key.
34
- *
35
- * An organization-scoped key has no user, and `GET /users/me` answers `404 not allowed for
36
- * organization API keys` — so the account id is the only identity available, and asking for an
37
- * email would turn a perfectly good key into a failed `profile create`. The id is returned bare
38
- * rather than as "organization <id>": it already announces what it is through its `org-` prefix,
39
- * and `list` shows the scope in the next column.
40
- */
41
- export const identityFromAuthDetails = (details, email) => {
42
- if (details.auth_method === "api_key_org") {
43
- return { label: details.account_id };
44
- }
45
- return {
46
- ...(email ? { label: email } : { label: details.account_id }),
47
- ...(details.account_id ? { userId: details.account_id } : {}),
48
- };
30
+ * What to record about a validated key.
31
+ *
32
+ * An organization-scoped key has no user, and `GET /users/me` answers `404 not allowed for
33
+ * organization API keys` — so the account id is the only identity available, and asking for an
34
+ * email would turn a perfectly good key into a failed `profile create`. The id is returned bare
35
+ * rather than as "organization <id>": it already announces what it is through its `org-` prefix,
36
+ * and `list` shows the scope in the next column.
37
+ */
38
+ const identityFromAuthDetails = (details, email) => {
39
+ if (details.auth_method === "api_key_org") return { label: details.account_id };
40
+ return {
41
+ ...email ? { label: email } : { label: details.account_id },
42
+ ...details.account_id ? { userId: details.account_id } : {}
43
+ };
49
44
  };
50
45
  /**
51
- * The message for a credential that authenticates but is not an API key — an OAuth access
52
- * token pasted in by mistake, most likely. It would work until it expired, then fail with no
53
- * way to refresh it, so it is refused at the point where the mistake is still obvious.
54
- */
55
- export const notAnApiKeyMessage = (method) => `That credential authenticates as "${method}", not an API key. Create a key with \`neon api-keys create --name <name>\`, or have one minted with \`neon profile create <name> --mint\`.`;
46
+ * The message for a credential that authenticates but is not an API key — an OAuth access
47
+ * token pasted in by mistake, most likely. It would work until it expired, then fail with no
48
+ * way to refresh it, so it is refused at the point where the mistake is still obvious.
49
+ */
50
+ const notAnApiKeyMessage = (method) => `That credential authenticates as "${method}", not an API key. Create a key with \`neon api-keys create --name <name>\`, or have one minted with \`neon profile create <name> --mint\`.`;
51
+ //#endregion
52
+ export { identityFromAuthDetails, isApiKeyMethod, mintedKeyName, notAnApiKeyMessage };
package/dist/psql/cli.js CHANGED
@@ -1,53 +1,50 @@
1
1
  #!/usr/bin/env node
2
- /**
3
- * Standalone psql shim.
4
- *
5
- * Thin wrapper around `runPsql` that lets the conformance harness — and any
6
- * caller that wants a psql-compatible CLI — invoke our embedded TypeScript
7
- * psql directly via `node dist/psql/cli.js`, without going through the
8
- * neonctl yargs entrypoint.
9
- *
10
- * Why this exists: `dist/cli.js` is the neonctl entrypoint; yargs eats
11
- * libpq-style flags (e.g. `-v ON_ERROR_STOP=0` collides with yargs'
12
- * built-in `--version`). The conformance suite needs to spawn a binary
13
- * that accepts the upstream psql flag grammar (`-h`/`-p`/`-U`/`-d`/`-X`/
14
- * `-v VAR=VALUE`/`--no-psqlrc`/`--echo-all`/`--quiet`/etc.) and reads SQL
15
- * from stdin. This shim wires `process.argv.slice(2)` straight into
16
- * `runPsql`, which already speaks that grammar via `parseStartupArgs`.
17
- *
18
- * Argv shape:
19
- * - If the first positional looks like a connection URI / conninfo
20
- * (per `looksLikeConnectionString`), it stays at argv[0] — same shape
21
- * as the legacy native-psql call site in `src/utils/psql.ts` and the
22
- * existing `runPsql` API.
23
- * - Otherwise (the regress harness case: bare libpq flags), we prepend
24
- * an empty placeholder URI so `runPsql([''] + flags)` falls through to
25
- * `parseStartupArgs` and resolves the connection from `-h`/`-p`/`-U`/
26
- * `-d` plus PG* env / pgpass / service via the layered resolver.
27
- *
28
- * Exit code: forwarded straight from `runPsql` (matches upstream psql's
29
- * EXIT_SUCCESS / EXIT_FAILURE / EXIT_USER / EXIT_BADCONN values; see
30
- * `core/mainloop.ts`).
31
- */
32
2
  import { looksLikeConnectionString, runPsql } from "./index.js";
3
+ //#region src/psql/cli.ts
4
+ /**
5
+ * Standalone psql shim.
6
+ *
7
+ * Thin wrapper around `runPsql` that lets the conformance harness — and any
8
+ * caller that wants a psql-compatible CLI — invoke our embedded TypeScript
9
+ * psql directly via `node dist/psql/cli.js`, without going through the
10
+ * neonctl yargs entrypoint.
11
+ *
12
+ * Why this exists: `dist/cli.js` is the neonctl entrypoint; yargs eats
13
+ * libpq-style flags (e.g. `-v ON_ERROR_STOP=0` collides with yargs'
14
+ * built-in `--version`). The conformance suite needs to spawn a binary
15
+ * that accepts the upstream psql flag grammar (`-h`/`-p`/`-U`/`-d`/`-X`/
16
+ * `-v VAR=VALUE`/`--no-psqlrc`/`--echo-all`/`--quiet`/etc.) and reads SQL
17
+ * from stdin. This shim wires `process.argv.slice(2)` straight into
18
+ * `runPsql`, which already speaks that grammar via `parseStartupArgs`.
19
+ *
20
+ * Argv shape:
21
+ * - If the first positional looks like a connection URI / conninfo
22
+ * (per `looksLikeConnectionString`), it stays at argv[0] — same shape
23
+ * as the legacy native-psql call site in `src/utils/psql.ts` and the
24
+ * existing `runPsql` API.
25
+ * - Otherwise (the regress harness case: bare libpq flags), we prepend
26
+ * an empty placeholder URI so `runPsql([''] + flags)` falls through to
27
+ * `parseStartupArgs` and resolves the connection from `-h`/`-p`/`-U`/
28
+ * `-d` plus PG* env / pgpass / service via the layered resolver.
29
+ *
30
+ * Exit code: forwarded straight from `runPsql` (matches upstream psql's
31
+ * EXIT_SUCCESS / EXIT_FAILURE / EXIT_USER / EXIT_BADCONN values; see
32
+ * `core/mainloop.ts`).
33
+ */
33
34
  const main = async () => {
34
- const raw = process.argv.slice(2);
35
- // Detect whether the first arg is a connection URI/conninfo string.
36
- // libpq's `recognized_connection_string()` covers both `postgres[ql]://…`
37
- // URIs and bare `key=value` conninfo strings — `looksLikeConnectionString`
38
- // mirrors that test.
39
- const argv = raw.length > 0 && looksLikeConnectionString(raw[0])
40
- ? raw
41
- : ["", ...raw];
42
- const code = await runPsql(argv, {
43
- stdin: process.stdin,
44
- stdout: process.stdout,
45
- stderr: process.stderr,
46
- });
47
- process.exit(code);
35
+ const raw = process.argv.slice(2);
36
+ const argv = raw.length > 0 && looksLikeConnectionString(raw[0]) ? raw : ["", ...raw];
37
+ const code = await runPsql(argv, {
38
+ stdin: process.stdin,
39
+ stdout: process.stdout,
40
+ stderr: process.stderr
41
+ });
42
+ process.exit(code);
48
43
  };
49
44
  main().catch((err) => {
50
- const msg = err instanceof Error ? err.message : String(err);
51
- process.stderr.write(`psql: fatal: ${msg}\n`);
52
- process.exit(1);
45
+ const msg = err instanceof Error ? err.message : String(err);
46
+ process.stderr.write(`psql: fatal: ${msg}\n`);
47
+ process.exit(1);
53
48
  });
49
+ //#endregion
50
+ export {};