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.
- package/README.md +54 -0
- package/dist/_shared/auth_selection.js +76 -79
- package/dist/_shared/credentials.js +166 -187
- package/dist/_shared/env-core/env.js +354 -517
- package/dist/_shared/env-core/reuse-secrets.js +159 -203
- package/dist/_shared/paths.js +129 -126
- package/dist/_shared/profiles.js +192 -242
- package/dist/_shared/secure_file.js +36 -38
- package/dist/_virtual/_rolldown/runtime.js +13 -0
- package/dist/analytics.js +163 -207
- package/dist/api.js +815 -758
- package/dist/auth.js +121 -141
- package/dist/auth_context.js +39 -53
- package/dist/cli.js +4 -7
- package/dist/commands/api.js +220 -250
- package/dist/commands/api_keys.js +251 -314
- package/dist/commands/auth.js +283 -328
- package/dist/commands/bootstrap.js +372 -437
- package/dist/commands/branches.js +304 -455
- package/dist/commands/bucket.js +374 -514
- package/dist/commands/checkout.js +213 -298
- package/dist/commands/config.js +573 -690
- package/dist/commands/connection_string.js +137 -165
- package/dist/commands/data_api.js +238 -260
- package/dist/commands/databases.js +67 -76
- package/dist/commands/deploy.js +31 -25
- package/dist/commands/dev.js +639 -719
- package/dist/commands/diff.js +156 -200
- package/dist/commands/env.js +243 -303
- package/dist/commands/functions.js +275 -355
- package/dist/commands/index.js +70 -65
- package/dist/commands/init.js +84 -119
- package/dist/commands/inspect.js +55 -55
- package/dist/commands/ip_allow.js +88 -120
- package/dist/commands/link.js +874 -1019
- package/dist/commands/logs.js +291 -0
- package/dist/commands/neon_auth.js +725 -933
- package/dist/commands/operations.js +34 -25
- package/dist/commands/orgs.js +28 -18
- package/dist/commands/profile.js +614 -845
- package/dist/commands/projects.js +313 -373
- package/dist/commands/psql.js +60 -58
- package/dist/commands/roles.js +55 -58
- package/dist/commands/schema_diff.js +87 -131
- package/dist/commands/set_context.js +34 -26
- package/dist/commands/snapshots.js +288 -413
- package/dist/commands/status.js +41 -37
- package/dist/commands/user.js +21 -10
- package/dist/commands/vpc_endpoints.js +85 -113
- package/dist/config.js +7 -6
- package/dist/config_format.js +50 -66
- package/dist/config_template.js +128 -157
- package/dist/context.js +183 -235
- package/dist/current_branch_fast_path.js +40 -49
- package/dist/dev/env.js +313 -394
- package/dist/dev/functions.js +54 -68
- package/dist/dev/inputs.js +46 -58
- package/dist/dev/runtime.js +135 -164
- package/dist/dev/websocket.js +766 -959
- package/dist/env.js +27 -33
- package/dist/env_file.js +118 -132
- package/dist/env_services.js +36 -38
- package/dist/errors.js +57 -68
- package/dist/functions_api.js +45 -43
- package/dist/help.js +189 -140
- package/dist/index.js +182 -257
- package/dist/init/agents.js +137 -118
- package/dist/init/auth.js +58 -68
- package/dist/init/bootstrap.js +325 -396
- package/dist/init/build_config.js +4 -2
- package/dist/init/detect_agent.js +56 -101
- package/dist/init/editors.js +35 -52
- package/dist/init/enrich_output.js +51 -66
- package/dist/init/extension.js +134 -171
- package/dist/init/inspect.js +179 -266
- package/dist/init/interactive.js +510 -622
- package/dist/init/neonctl.js +117 -168
- package/dist/init/orchestrate.js +157 -173
- package/dist/init/phases/auth.js +188 -202
- package/dist/init/phases/cleanup.js +23 -23
- package/dist/init/phases/db.js +251 -277
- package/dist/init/phases/getting_started.js +213 -223
- package/dist/init/phases/mcp.js +174 -224
- package/dist/init/phases/migrations.js +247 -248
- package/dist/init/phases/neon_auth.js +114 -133
- package/dist/init/phases/setup.js +546 -703
- package/dist/init/phases/skills.js +75 -86
- package/dist/init/phases/status.js +72 -67
- package/dist/init/resolve_context.js +102 -99
- package/dist/init/route_command.js +91 -98
- package/dist/init/skills.js +174 -218
- package/dist/init/vsix.js +77 -99
- package/dist/log.js +17 -16
- package/dist/neon_services.js +104 -129
- package/dist/parameters.gen.js +481 -471
- package/dist/pkg.js +17 -19
- package/dist/profile_keys.js +44 -47
- package/dist/psql/cli.js +44 -47
- package/dist/psql/command/cmd_cond.js +231 -406
- package/dist/psql/command/cmd_connect.js +557 -764
- package/dist/psql/command/cmd_copy.js +727 -983
- package/dist/psql/command/cmd_describe.js +1499 -1688
- package/dist/psql/command/cmd_format.js +733 -905
- package/dist/psql/command/cmd_io.js +1293 -2082
- package/dist/psql/command/cmd_lo.js +297 -359
- package/dist/psql/command/cmd_meta.js +727 -878
- package/dist/psql/command/cmd_misc.js +138 -172
- package/dist/psql/command/cmd_pipeline.js +547 -1099
- package/dist/psql/command/cmd_restrict.js +119 -155
- package/dist/psql/command/cmd_show.js +529 -688
- package/dist/psql/command/dispatch.js +261 -325
- package/dist/psql/command/inputQueue.js +35 -33
- package/dist/psql/command/shared.js +49 -63
- package/dist/psql/complete/filenames.js +90 -133
- package/dist/psql/complete/index.js +59 -97
- package/dist/psql/complete/matcher.js +236 -300
- package/dist/psql/complete/psqlVars.js +218 -223
- package/dist/psql/complete/queries.js +159 -177
- package/dist/psql/complete/rules.js +1493 -2299
- package/dist/psql/core/common.js +762 -1180
- package/dist/psql/core/help.js +456 -546
- package/dist/psql/core/mainloop.js +692 -1302
- package/dist/psql/core/prompt.js +391 -408
- package/dist/psql/core/settings.js +429 -644
- package/dist/psql/core/sqlHelp.js +480 -554
- package/dist/psql/core/startup.js +626 -815
- package/dist/psql/core/syncVars.js +67 -110
- package/dist/psql/core/variables.js +156 -278
- package/dist/psql/describe/formatters.js +884 -1285
- package/dist/psql/describe/processNamePattern.js +173 -260
- package/dist/psql/describe/queries.js +1368 -2403
- package/dist/psql/describe/versionGate.js +32 -41
- package/dist/psql/index.js +1414 -1927
- package/dist/psql/io/history.js +232 -271
- package/dist/psql/io/input.js +103 -108
- package/dist/psql/io/lineEditor/buffer.js +238 -319
- package/dist/psql/io/lineEditor/complete.js +135 -213
- package/dist/psql/io/lineEditor/filename.js +139 -148
- package/dist/psql/io/lineEditor/index.js +653 -870
- package/dist/psql/io/lineEditor/keymap.js +544 -702
- package/dist/psql/io/lineEditor/vt100.js +294 -341
- package/dist/psql/io/pgpass.js +158 -187
- package/dist/psql/io/pgservice.js +146 -183
- package/dist/psql/io/psqlrc.js +328 -403
- package/dist/psql/print/aligned.js +1020 -1683
- package/dist/psql/print/asciidoc.js +180 -214
- package/dist/psql/print/crosstab.js +281 -442
- package/dist/psql/print/csv.js +48 -70
- package/dist/psql/print/html.js +195 -226
- package/dist/psql/print/json.js +75 -88
- package/dist/psql/print/latex.js +291 -364
- package/dist/psql/print/pager.js +171 -242
- package/dist/psql/print/troff.js +194 -226
- package/dist/psql/print/unaligned.js +69 -95
- package/dist/psql/print/units.js +167 -169
- package/dist/psql/scanner/slash.js +428 -483
- package/dist/psql/scanner/sql.js +445 -889
- package/dist/psql/scanner/stringutils.js +309 -379
- package/dist/psql/types/index.js +2 -7
- package/dist/psql/types/scanner.js +25 -22
- package/dist/psql/wire/connection.js +2042 -2803
- package/dist/psql/wire/copy.js +84 -100
- package/dist/psql/wire/notify.js +39 -59
- package/dist/psql/wire/pipeline.js +305 -518
- package/dist/psql/wire/protocol.js +349 -417
- package/dist/psql/wire/sasl.js +180 -265
- package/dist/psql/wire/tls.js +400 -561
- package/dist/storage_api.js +115 -129
- package/dist/test_utils/fixtures.js +94 -113
- package/dist/test_utils/oauth_server.js +10 -7
- package/dist/test_utils/project_dir.js +33 -0
- package/dist/utils/ai_gateway_notice.js +131 -162
- package/dist/utils/api_enums.js +21 -28
- package/dist/utils/auth.js +10 -4
- package/dist/utils/branch_notice.js +20 -19
- package/dist/utils/branch_picker.js +83 -89
- package/dist/utils/cli_name.js +15 -12
- package/dist/utils/compute_units.js +20 -27
- package/dist/utils/config_diff.js +127 -158
- package/dist/utils/enrichers.js +95 -148
- package/dist/utils/esbuild.js +130 -189
- package/dist/utils/flags.js +35 -47
- package/dist/utils/formats.js +8 -15
- package/dist/utils/git_diff.js +69 -80
- package/dist/utils/inspect_db.js +101 -143
- package/dist/utils/inspect_queries.js +179 -142
- package/dist/utils/middlewares.js +37 -44
- package/dist/utils/openapi.js +87 -99
- package/dist/utils/package_manager.js +312 -110
- package/dist/utils/point_in_time.js +49 -53
- package/dist/utils/psql.js +89 -106
- package/dist/utils/service_picker.js +55 -58
- package/dist/utils/string.js +5 -5
- package/dist/utils/ui.js +38 -55
- package/dist/utils/write_sync.js +26 -35
- package/dist/utils/zip.js +4 -3
- package/dist/writer.js +67 -87
- package/package.json +7 -5
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
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
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
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
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
|
-
|
|
21
|
+
var pkg_default = loadPkg();
|
|
22
|
+
//#endregion
|
|
23
|
+
export { pkg_default as default };
|
package/dist/profile_keys.js
CHANGED
|
@@ -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
|
-
|
|
12
|
+
const isApiKeyMethod = (method) => API_KEY_METHODS.includes(method);
|
|
12
13
|
/**
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
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
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
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
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
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
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
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
|
-
|
|
51
|
-
|
|
52
|
-
|
|
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 {};
|