nexusql 0.8.1 → 0.9.1

package/dist/index.d.ts

@@ -258,4 +258,9 @@ interface InitOptions {
  */
 declare function init(options?: InitOptions): Promise<void>;
 
-export { Database, type DbUrlParts, MigrationRunner, type NexusqlConfig, buildDbUrl, createMigrationFile, dbmlToSql, filterSchemaMigrations, gen, generateConfigTemplate, getDatabaseUrl, getMostRecentMigration, init, listMigrations, loadConfig, markApplied, migrate, parseAndEncodeDbUrl, parseMigrationFile, runMigra, status, up, updateMigrationFile };
+/**
+ * Test database connection.
+ */
+declare function testConnection(): Promise<void>;
+
+export { Database, type DbUrlParts, MigrationRunner, type NexusqlConfig, buildDbUrl, createMigrationFile, dbmlToSql, filterSchemaMigrations, gen, generateConfigTemplate, getDatabaseUrl, getMostRecentMigration, init, listMigrations, loadConfig, markApplied, migrate, parseAndEncodeDbUrl, parseMigrationFile, runMigra, status, testConnection, up, updateMigrationFile };

package/dist/index.js

@@ -1855,7 +1855,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`
+        );
       }
     }
   }
@@ -3992,6 +3998,40 @@ async function init(options = {}) {
   console.log('  3. Run "nexusql gen" to generate migration SQL');
   console.log('  4. Run "nexusql migrate" to create and apply migrations\n');
 }
+
+// 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);
+  }
+}
 export {
   Database,
   MigrationRunner,
@@ -4012,6 +4052,7 @@ export {
   parseMigrationFile,
   runMigra,
   status,
+  testConnection,
   up,
   updateMigrationFile
 };