nexusql 0.8.1 → 0.9.1

package/README.md

@@ -63,6 +63,7 @@ nexusql migrate
 | Command                          | Description                                 |
 | -------------------------------- | ------------------------------------------- |
 | `nexusql init`                   | Initialize configuration and directories    |
+| `nexusql test-connection`        | Test database connection                    |
 | `nexusql gen`                    | Generate migration SQL from DBML schema     |
 | `nexusql migrate`                | Interactive: generate → create file → apply |
 | `nexusql up`                     | Apply all pending migrations                |
@@ -71,6 +72,42 @@ nexusql migrate
 | `nexusql types`                  | Generate TypeScript definitions             |
 | `nexusql mark-applied <version>` | Mark migration as applied without running   |
 
+### `nexusql test-connection`
+
+Test your database connection and verify credentials:
+
+```bash
+nexusql test-connection
+```
+
+This command will:
+- Parse and validate your `DATABASE_URL`
+- Display connection details (protocol, user, host, port, database)
+- Attempt to connect to the database
+- Show server information if successful
+
+**Note:** If your password contains special characters like `@`, `#`, `:`, etc., keep them unencoded in your `.env` file. The tool will handle URL encoding automatically.
+
+Example output:
+```
+Testing database connection...
+
+Connection details:
+  Protocol: postgresql
+  User: myuser
+  Host: localhost
+  Port: 5432
+  Database: mydb
+  Password: ***@123
+
+✓ Connection successful!
+
+Server info:
+  Current user: myuser
+  Current database: mydb
+  PostgreSQL version: PostgreSQL 15.3
+```
+
 ### `nexusql gen`
 
 Generate migration SQL by diffing your current database against the DBML schema.

package/dist/cli.js

@@ -3217,7 +3217,13 @@ var Database = class _Database {
     for (const ext of extensions) {
       try {
         await this.exec(`CREATE EXTENSION IF NOT EXISTS "${ext}";`);
-      } catch {
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(
+          `Failed to install extension "${ext}": ${message}
+Make sure the extension is installed on your PostgreSQL server.
+For pgvector: https://github.com/pgvector/pgvector#installation`
+        );
       }
     }
   }
@@ -4147,6 +4153,40 @@ async function types(options = {}) {
   }
 }
 
+// src/commands/test-connection.ts
+async function testConnection() {
+  console.log(source_default.bold("Testing database connection...\n"));
+  try {
+    const config = await loadConfig();
+    const rawUrl = getDatabaseUrl(config);
+    const parsed = parseAndEncodeDbUrl(rawUrl);
+    console.log(source_default.cyan("Connection details:"));
+    console.log(source_default.dim("  Protocol:"), parsed.protocol);
+    console.log(source_default.dim("  User:"), parsed.user);
+    console.log(source_default.dim("  Host:"), parsed.host);
+    console.log(source_default.dim("  Port:"), parsed.port);
+    console.log(source_default.dim("  Database:"), parsed.database);
+    console.log(source_default.dim("  Password:"), "***" + decodeURIComponent(parsed.password).slice(-4));
+    console.log();
+    const db = new Database(rawUrl);
+    const result = await db.query("SELECT current_user, current_database(), version()");
+    console.log(source_default.green("\u2713 Connection successful!\n"));
+    console.log(source_default.cyan("Server info:"));
+    console.log(source_default.dim("  Current user:"), result.rows[0].current_user);
+    console.log(source_default.dim("  Current database:"), result.rows[0].current_database);
+    console.log(source_default.dim("  PostgreSQL version:"), result.rows[0].version.split(",")[0]);
+  } catch (error) {
+    console.log(source_default.red("\u2717 Connection failed!\n"));
+    console.error(source_default.red("Error:"), error.message);
+    console.log(source_default.yellow("\nTroubleshooting tips:"));
+    console.log("  \u2022 Check DATABASE_URL in your .env file");
+    console.log("  \u2022 Ensure special characters in password are NOT URL-encoded");
+    console.log("  \u2022 Verify the database server is running");
+    console.log("  \u2022 Check host, port, username, and database name");
+    process.exit(1);
+  }
+}
+
 // src/cli.ts
 var __filename = fileURLToPath(import.meta.url);
 var __dirname = dirname(__filename);
@@ -4228,5 +4268,13 @@ program.command("types").description("Generate TypeScript definitions from DBML"
     process.exit(1);
   }
 });
+program.command("test-connection").description("Test database connection").action(async () => {
+  try {
+    await testConnection();
+  } catch (error) {
+    console.error("Error:", error.message);
+    process.exit(1);
+  }
+});
 program.parse();
 //# sourceMappingURL=cli.js.map