neon 2.1.1 → 2.29.0

package/dist/parameters.gen.js

@@ -0,0 +1,480 @@
+// FILE IS GENERATED, DO NOT EDIT
+export const projectCreateRequest = {
+    'project.settings.quota.active_time_seconds': {
+        type: "number",
+        description: "The total amount of wall-clock time allowed to be spent by the project's compute endpoints.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.compute_time_seconds': {
+        type: "number",
+        description: "The total amount of CPU seconds allowed to be spent by the project's compute endpoints.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.written_data_bytes': {
+        type: "number",
+        description: "Total amount of data written to all of a project's branches.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.data_transfer_bytes': {
+        type: "number",
+        description: "Total amount of data transferred from all of a project's branches using the proxy.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.logical_size_bytes': {
+        type: "number",
+        description: "Limit on the logical size of every project's branch.\n\nIf a branch exceeds its `logical_size_bytes` quota, computes can still be started,\nbut write operations will fail—allowing data to be deleted to free up space.\nComputes on other branches are not affected.\n\nSetting `logical_size_bytes` overrides any lower value set by the `neon.max_cluster_size` Postgres setting.\n",
+        demandOption: false,
+    },
+    'project.settings.allowed_ips.ips': {
+        type: "array",
+        description: "A list of IP addresses that are allowed to connect to the endpoint.",
+        demandOption: false,
+    },
+    'project.settings.allowed_ips.protected_branches_only': {
+        type: "boolean",
+        description: "If true, the list will be applied only to protected branches.",
+        demandOption: false,
+    },
+    'project.settings.enable_logical_replication': {
+        type: "boolean",
+        description: "Sets wal_level=logical for all compute endpoints in this project.\nAll active endpoints will be suspended.\nOnce enabled, logical replication cannot be disabled.\n",
+        demandOption: false,
+    },
+    'project.settings.maintenance_window.weekdays': {
+        type: "array",
+        description: "A list of weekdays when the maintenance window is active.\nEncoded as ints, where 1 - Monday, and 7 - Sunday.\n",
+        demandOption: true,
+    },
+    'project.settings.maintenance_window.start_time': {
+        type: "string",
+        description: "Start time of the maintenance window, in the format of \"HH:MM\". Uses UTC.\n",
+        demandOption: true,
+    },
+    'project.settings.maintenance_window.end_time': {
+        type: "string",
+        description: "End time of the maintenance window, in the format of \"HH:MM\". Uses UTC.\n",
+        demandOption: true,
+    },
+    'project.settings.block_public_connections': {
+        type: "boolean",
+        description: "When set, connections from the public internet\nare disallowed. This supersedes the AllowedIPs list.\nThis parameter is under active development and its semantics may change in the future.\n",
+        demandOption: false,
+    },
+    'project.settings.block_vpc_connections': {
+        type: "boolean",
+        description: "When set, connections using VPC endpoints are disallowed.\nThis parameter is under active development and its semantics may change in the future.\n",
+        demandOption: false,
+    },
+    'project.settings.audit_log_level': {
+        type: "string",
+        description: undefined,
+        demandOption: false,
+        choices: ["base", "extended", "full"],
+    },
+    'project.settings.hipaa': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'project.settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'project.settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
+    'project.name': {
+        type: "string",
+        description: "The project name. If not specified, the name will be identical to the generated project ID",
+        demandOption: false,
+    },
+    'project.branch.name': {
+        type: "string",
+        description: "The default branch name. If not specified, the default branch name, `main`, will be used.\n",
+        demandOption: false,
+    },
+    'project.branch.role_name': {
+        type: "string",
+        description: "The role name. If not specified, the default role name, `{database_name}_owner`, will be used.\n",
+        demandOption: false,
+    },
+    'project.branch.database_name': {
+        type: "string",
+        description: "The database name. If not specified, the default database name, `neondb`, will be used.\n",
+        demandOption: false,
+    },
+    'project.provisioner': {
+        type: "string",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        demandOption: false,
+    },
+    'project.region_id': {
+        type: "string",
+        description: "The region identifier. Refer to our [Regions](https://neon.com/docs/introduction/regions) documentation for supported regions. Values are specified in this format: `aws-us-east-1`\n",
+        demandOption: false,
+    },
+    'project.default_endpoint_settings.suspend_timeout_seconds': {
+        type: "number",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        demandOption: false,
+    },
+    'project.pg_version': {
+        type: "number",
+        description: "The major Postgres version number. Currently supported versions are `14`, `15`, `16`, `17`, and `18`.",
+        demandOption: false,
+    },
+    'project.store_passwords': {
+        type: "boolean",
+        description: "Whether or not passwords are stored for roles in the Neon project. Storing passwords facilitates access to Neon features that require authorization.\n",
+        demandOption: false,
+    },
+    'project.history_retention_seconds': {
+        type: "number",
+        description: "The number of seconds to retain the shared history for all branches in this project.\nThe default is 1 day (86400 seconds).\n",
+        demandOption: false,
+    },
+    'project.org_id': {
+        type: "string",
+        description: "Organization id in case the project created belongs to an organization.\nIf not present, project is owned by a user and not by org.\n",
+        demandOption: false,
+    },
+};
+export const projectUpdateRequest = {
+    'project.settings.quota.active_time_seconds': {
+        type: "number",
+        description: "The total amount of wall-clock time allowed to be spent by the project's compute endpoints.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.compute_time_seconds': {
+        type: "number",
+        description: "The total amount of CPU seconds allowed to be spent by the project's compute endpoints.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.written_data_bytes': {
+        type: "number",
+        description: "Total amount of data written to all of a project's branches.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.data_transfer_bytes': {
+        type: "number",
+        description: "Total amount of data transferred from all of a project's branches using the proxy.\n",
+        demandOption: false,
+    },
+    'project.settings.quota.logical_size_bytes': {
+        type: "number",
+        description: "Limit on the logical size of every project's branch.\n\nIf a branch exceeds its `logical_size_bytes` quota, computes can still be started,\nbut write operations will fail—allowing data to be deleted to free up space.\nComputes on other branches are not affected.\n\nSetting `logical_size_bytes` overrides any lower value set by the `neon.max_cluster_size` Postgres setting.\n",
+        demandOption: false,
+    },
+    'project.settings.allowed_ips.ips': {
+        type: "array",
+        description: "A list of IP addresses that are allowed to connect to the endpoint.",
+        demandOption: false,
+    },
+    'project.settings.allowed_ips.protected_branches_only': {
+        type: "boolean",
+        description: "If true, the list will be applied only to protected branches.",
+        demandOption: false,
+    },
+    'project.settings.enable_logical_replication': {
+        type: "boolean",
+        description: "Sets wal_level=logical for all compute endpoints in this project.\nAll active endpoints will be suspended.\nOnce enabled, logical replication cannot be disabled.\n",
+        demandOption: false,
+    },
+    'project.settings.maintenance_window.weekdays': {
+        type: "array",
+        description: "A list of weekdays when the maintenance window is active.\nEncoded as ints, where 1 - Monday, and 7 - Sunday.\n",
+        demandOption: true,
+    },
+    'project.settings.maintenance_window.start_time': {
+        type: "string",
+        description: "Start time of the maintenance window, in the format of \"HH:MM\". Uses UTC.\n",
+        demandOption: true,
+    },
+    'project.settings.maintenance_window.end_time': {
+        type: "string",
+        description: "End time of the maintenance window, in the format of \"HH:MM\". Uses UTC.\n",
+        demandOption: true,
+    },
+    'project.settings.block_public_connections': {
+        type: "boolean",
+        description: "When set, connections from the public internet\nare disallowed. This supersedes the AllowedIPs list.\nThis parameter is under active development and its semantics may change in the future.\n",
+        demandOption: false,
+    },
+    'project.settings.block_vpc_connections': {
+        type: "boolean",
+        description: "When set, connections using VPC endpoints are disallowed.\nThis parameter is under active development and its semantics may change in the future.\n",
+        demandOption: false,
+    },
+    'project.settings.audit_log_level': {
+        type: "string",
+        description: undefined,
+        demandOption: false,
+        choices: ["base", "extended", "full"],
+    },
+    'project.settings.hipaa': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'project.settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'project.settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
+    'project.name': {
+        type: "string",
+        description: "The project name",
+        demandOption: false,
+    },
+    'project.default_endpoint_settings.suspend_timeout_seconds': {
+        type: "number",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        demandOption: false,
+    },
+    'project.history_retention_seconds': {
+        type: "number",
+        description: "The number of seconds to retain the shared history for all branches in this project.\nThe default is 1 day (604800 seconds).\n",
+        demandOption: false,
+    },
+};
+export const branchCreateRequest = {
+    'endpoints': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
+    'branch.parent_id': {
+        type: "string",
+        description: "The `branch_id` of the parent branch. If omitted or empty, the branch will be created from the project's default branch.\n",
+        demandOption: false,
+    },
+    'branch.name': {
+        type: "string",
+        description: "The branch name\n",
+        demandOption: false,
+    },
+    'branch.parent_lsn': {
+        type: "string",
+        description: "A Log Sequence Number (LSN) on the parent branch. The branch will be created with data from this LSN.\n",
+        demandOption: false,
+    },
+    'branch.parent_timestamp': {
+        type: "string",
+        description: "A timestamp identifying a point in time on the parent branch. The branch will be created with data starting from this point in time.\nThe timestamp must be provided in ISO 8601 format; for example: `2024-02-26T12:00:00Z`.\n",
+        demandOption: false,
+    },
+    'branch.protected': {
+        type: "boolean",
+        description: "Whether the branch is protected\n",
+        demandOption: false,
+    },
+    'branch.archived': {
+        type: "boolean",
+        description: "Whether to create the branch as archived\n",
+        demandOption: false,
+    },
+    'branch.init_source': {
+        type: "string",
+        description: "The source of initialization for the branch. Valid values are `schema-only` and `parent-data` (default).\n  * `schema-only` - creates a new root branch containing only the schema. Use `parent_id` to specify the source branch. Optionally, you can provide `parent_lsn` or `parent_timestamp` to branch from a specific point in time or LSN. These fields define which branch to copy the schema from and at what point—they do not establish a parent-child relationship between the `parent_id` branch and the new schema-only branch.\n  * `parent-data` - creates the branch with both schema and data from the parent.\n",
+        demandOption: false,
+    },
+    'branch.expires_at': {
+        type: "string",
+        description: "The timestamp when the branch is scheduled to expire and be automatically deleted. Must be set by the client following the [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6) format with precision up to seconds (such as 2025-06-09T18:02:16Z). Deletion is performed by a background job and may not occur exactly at the specified time.\n\nAccess to this feature is currently limited to participants in the Early Access Program.\n",
+        demandOption: false,
+    },
+};
+export const branchCreateRequestEndpointOptions = {
+    'type': {
+        type: "string",
+        description: "The compute endpoint type. Either `read_write` or `read_only`.\n",
+        demandOption: true,
+        choices: ["read_only", "read_write"],
+    },
+    'settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
+    'provisioner': {
+        type: "string",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        demandOption: false,
+    },
+    'suspend_timeout_seconds': {
+        type: "number",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        demandOption: false,
+    },
+};
+export const branchUpdateRequest = {
+    'branch.name': {
+        type: "string",
+        description: undefined,
+        demandOption: false,
+    },
+    'branch.protected': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'branch.expires_at': {
+        type: "string",
+        description: "The timestamp when the branch is scheduled to expire and be automatically deleted. Must be set by the client following the [RFC 3339, section 5.6](https://tools.ietf.org/html/rfc3339#section-5.6) format with precision up to seconds (such as 2025-06-09T18:02:16Z). Deletion is performed by a background job and may not occur exactly at the specified time. If this field is set to null, the expiration timestamp is removed.\n\nAccess to this feature is currently limited to participants in the Early Access Program.\n",
+        demandOption: false,
+    },
+};
+export const endpointCreateRequest = {
+    'endpoint.branch_id': {
+        type: "string",
+        description: "The ID of the branch the compute endpoint will be associated with\n",
+        demandOption: true,
+    },
+    'endpoint.region_id': {
+        type: "string",
+        description: "The region where the compute endpoint will be created. Only the project's `region_id` is permitted.\n",
+        demandOption: false,
+    },
+    'endpoint.type': {
+        type: "string",
+        description: "The compute endpoint type. Either `read_write` or `read_only`.\n",
+        demandOption: true,
+        choices: ["read_only", "read_write"],
+    },
+    'endpoint.settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'endpoint.settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
+    'endpoint.provisioner': {
+        type: "string",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        demandOption: false,
+    },
+    'endpoint.pooler_enabled': {
+        type: "boolean",
+        description: "DEPRECATED. Whether to enable connection pooling for the compute endpoint.\nThe recommended way to enable connection pooling is to append `-pooler` to the endpoint ID in the connection string.\nSee [How to use connection pooling](https://neon.com/docs/connect/connection-pooling#how-to-use-connection-pooling)\n",
+        demandOption: false,
+    },
+    'endpoint.pooler_mode': {
+        type: "string",
+        description: "DEPRECATED. The connection pooler mode. This field is deprecated and will be removed after 2026-06-20.\n",
+        demandOption: false,
+        choices: ["transaction"],
+    },
+    'endpoint.disabled': {
+        type: "boolean",
+        description: "Whether to restrict connections to the compute endpoint.\nEnabling this option schedules a suspend compute operation.\nA disabled compute endpoint cannot be enabled by a connection or\nconsole action. However, the compute endpoint is periodically\nenabled by check_availability operations.\n",
+        demandOption: false,
+    },
+    'endpoint.passwordless_access': {
+        type: "boolean",
+        description: "NOT YET IMPLEMENTED. Whether to permit passwordless access to the compute endpoint.\n",
+        demandOption: false,
+    },
+    'endpoint.suspend_timeout_seconds': {
+        type: "number",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        demandOption: false,
+    },
+    'endpoint.name': {
+        type: "string",
+        description: "Optional name of the compute endpoint\n",
+        demandOption: false,
+    },
+};
+export const endpointUpdateRequest = {
+    'endpoint.branch_id': {
+        type: "string",
+        description: "DEPRECATED: This field will be removed in a future release.\nThe destination branch ID. The destination branch must not have an existing read-write endpoint.\n",
+        demandOption: false,
+    },
+    'endpoint.provisioner': {
+        type: "string",
+        description: "The Neon compute provisioner.\nSpecify the `k8s-neonvm` provisioner to create a compute endpoint that supports Autoscaling.\n\nProvisioner can be one of the following values:\n* k8s-pod\n* k8s-neonvm\n* serverless-platform\n\nClients must expect, that any string value that is not documented in the description above should be treated as a error. UNKNOWN value if safe to treat as an error too.\n",
+        demandOption: false,
+    },
+    'endpoint.settings.preload_libraries.use_defaults': {
+        type: "boolean",
+        description: undefined,
+        demandOption: false,
+    },
+    'endpoint.settings.preload_libraries.enabled_libraries': {
+        type: "array",
+        description: undefined,
+        demandOption: false,
+    },
+    'endpoint.pooler_enabled': {
+        type: "boolean",
+        description: "DEPRECATED. Whether to enable connection pooling for the compute endpoint.\nThe recommended way to enable connection pooling is to append `-pooler` to the endpoint ID in the connection string.\nSee [How to use connection pooling](https://neon.com/docs/connect/connection-pooling#how-to-use-connection-pooling)\n",
+        demandOption: false,
+    },
+    'endpoint.pooler_mode': {
+        type: "string",
+        description: "DEPRECATED. The connection pooler mode. This field is deprecated and will be removed after 2026-06-20.\n",
+        demandOption: false,
+        choices: ["transaction"],
+    },
+    'endpoint.disabled': {
+        type: "boolean",
+        description: "Whether to restrict connections to the compute endpoint.\nEnabling this option schedules a suspend compute operation.\nA disabled compute endpoint cannot be enabled by a connection or\nconsole action. However, the compute endpoint is periodically\nenabled by check_availability operations.\n",
+        demandOption: false,
+    },
+    'endpoint.passwordless_access': {
+        type: "boolean",
+        description: "NOT YET IMPLEMENTED. Whether to permit passwordless access to the compute endpoint.\n",
+        demandOption: false,
+    },
+    'endpoint.suspend_timeout_seconds': {
+        type: "number",
+        description: "Duration of inactivity in seconds after which the compute endpoint is\nautomatically suspended. The value `0` means use the default value.\nThe value `-1` means never suspend. The default value is `300` seconds (5 minutes).\nThe minimum value is `60` seconds (1 minute).\nThe maximum value is `604800` seconds (1 week). For more information, see\n[Scale to zero configuration](https://neon.com/docs/manage/endpoints#scale-to-zero-configuration).\n",
+        demandOption: false,
+    },
+    'endpoint.name': {
+        type: "string",
+        description: "Optional name of the compute endpoint\n",
+        demandOption: false,
+    },
+};
+export const databaseCreateRequest = {
+    'database.name': {
+        type: "string",
+        description: "The name of the database\n",
+        demandOption: true,
+    },
+    'database.owner_name': {
+        type: "string",
+        description: "The name of the role that owns the database\n",
+        demandOption: true,
+    },
+};
+export const roleCreateRequest = {
+    'role.name': {
+        type: "string",
+        description: "The role name. Cannot exceed 63 bytes in length.\n",
+        demandOption: true,
+    },
+    'role.no_login': {
+        type: "boolean",
+        description: "Whether to create a role that cannot login.\n",
+        demandOption: false,
+    },
+};

package/dist/pkg.js

@@ -0,0 +1,25 @@
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Load the CLI's package.json for version metadata. In the built CLI it sits right next to
+ * this module (the build copies it into `dist`); when running from source (tests, `tsx`) it
+ * does not, so we walk up to the nearest `package.json`. Both layouts resolve to the same
+ * file, keeping `pkg.version` correct everywhere without a test-only shim.
+ */
+const loadPkg = () => {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (;;) {
+        try {
+            return JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+        }
+        catch {
+            const parent = dirname(dir);
+            if (parent === dir) {
+                throw new Error("Could not locate package.json for version detection.");
+            }
+            dir = parent;
+        }
+    }
+};
+export default loadPkg();

package/dist/psql/cli.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+/**
+ * Standalone psql shim.
+ *
+ * Thin wrapper around `runPsql` that lets the conformance harness — and any
+ * caller that wants a psql-compatible CLI — invoke our embedded TypeScript
+ * psql directly via `node dist/psql/cli.js`, without going through the
+ * neonctl yargs entrypoint.
+ *
+ * Why this exists: `dist/cli.js` is the neonctl entrypoint; yargs eats
+ * libpq-style flags (e.g. `-v ON_ERROR_STOP=0` collides with yargs'
+ * built-in `--version`). The conformance suite needs to spawn a binary
+ * that accepts the upstream psql flag grammar (`-h`/`-p`/`-U`/`-d`/`-X`/
+ * `-v VAR=VALUE`/`--no-psqlrc`/`--echo-all`/`--quiet`/etc.) and reads SQL
+ * from stdin. This shim wires `process.argv.slice(2)` straight into
+ * `runPsql`, which already speaks that grammar via `parseStartupArgs`.
+ *
+ * Argv shape:
+ *   - If the first positional looks like a connection URI / conninfo
+ *     (per `looksLikeConnectionString`), it stays at argv[0] — same shape
+ *     as the legacy native-psql call site in `src/utils/psql.ts` and the
+ *     existing `runPsql` API.
+ *   - Otherwise (the regress harness case: bare libpq flags), we prepend
+ *     an empty placeholder URI so `runPsql([''] + flags)` falls through to
+ *     `parseStartupArgs` and resolves the connection from `-h`/`-p`/`-U`/
+ *     `-d` plus PG* env / pgpass / service via the layered resolver.
+ *
+ * Exit code: forwarded straight from `runPsql` (matches upstream psql's
+ * EXIT_SUCCESS / EXIT_FAILURE / EXIT_USER / EXIT_BADCONN values; see
+ * `core/mainloop.ts`).
+ */
+import { looksLikeConnectionString, runPsql } from "./index.js";
+const main = async () => {
+    const raw = process.argv.slice(2);
+    // Detect whether the first arg is a connection URI/conninfo string.
+    // libpq's `recognized_connection_string()` covers both `postgres[ql]://…`
+    // URIs and bare `key=value` conninfo strings — `looksLikeConnectionString`
+    // mirrors that test.
+    const argv = raw.length > 0 && looksLikeConnectionString(raw[0])
+        ? raw
+        : ["", ...raw];
+    const code = await runPsql(argv, {
+        stdin: process.stdin,
+        stdout: process.stdout,
+        stderr: process.stderr,
+    });
+    process.exit(code);
+};
+main().catch((err) => {
+    const msg = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`psql: fatal: ${msg}\n`);
+    process.exit(1);
+});