spindb 0.1.0 → 0.2.1

package/README.md

@@ -10,6 +10,9 @@ Spin up local PostgreSQL databases without Docker. A lightweight alternative to
 - **Auto port management** - Automatically finds available ports
 - **Clone containers** - Duplicate databases with all data
 - **Backup restore** - Restore pg_dump backups (requires system PostgreSQL client tools)
+- **Custom database names** - Specify database name separate from container name
+- **Engine management** - View installed PostgreSQL versions and free up disk space
+- **Dynamic version selection** - Fetches all available versions from Maven Central
 
 ## Installation
 
@@ -109,10 +112,15 @@ spindb config set pg_restore /path/to/pg_restore
 
 ## Examples
 
-### Create a database with specific version
+### Create a database with specific version and name
 
 ```bash
+# Specify PostgreSQL version and port
 spindb create mydb --pg-version 15 --port 5433
+
+# Specify a custom database name (different from container name)
+spindb create mydb --database my_app_db
+# Connection string: postgresql://postgres@localhost:5432/my_app_db
 ```
 
 ### Restore a backup
@@ -145,7 +153,21 @@ spindb start test-branch
 spindb connect mydb
 
 # Or use the connection string directly
-psql postgresql://postgres@localhost:5432/postgres
+psql postgresql://postgres@localhost:5432/mydb
+```
+
+### Manage installed engines
+
+The Engines menu (accessible from the main menu) shows all installed PostgreSQL versions with their disk usage. You can delete unused versions to free up space.
+
+```
+ENGINE      VERSION     PLATFORM            SIZE
+────────────────────────────────────────────────────────
+postgresql  17          darwin-arm64        45.2 MB
+postgresql  16.9.0      darwin-arm64        44.8 MB
+postgresql  16          darwin-arm64        44.8 MB
+────────────────────────────────────────────────────────
+3 version(s)                                134.8 MB
 ```
 
 ## Configuration
@@ -201,4 +223,3 @@ rm -rf ~/.spindb
 ## License
 
 MIT
-# spindb

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spindb",
-  "version": "0.1.0",
+  "version": "0.2.01",
   "description": "Spin up local database containers without Docker. A DBngin-like CLI for PostgreSQL.",
   "type": "module",
   "bin": {
@@ -48,5 +48,13 @@
     "prettier": "^3.6.2",
     "typescript": "^5.3.0",
     "typescript-eslint": "^8.48.0"
-  }
+  },
+  "tsx": {
+    "tsconfig": "./tsconfig.json"
+  },
+  "files": [
+    "bin/**/*",
+    "src/**/*",
+    "tsconfig.json"
+  ]
 }

package/src/cli/commands/create.ts

@@ -17,6 +17,7 @@ export const createCommand = new Command('create')
     'PostgreSQL version',
     defaults.postgresVersion,
   )
+  .option('-d, --database <database>', 'Database name')
   .option('-p, --port <port>', 'Port number')
   .option('--no-start', 'Do not start the container after creation')
   .action(
@@ -25,6 +26,7 @@ export const createCommand = new Command('create')
       options: {
         engine: string
         pgVersion: string
+        database?: string
         port?: string
         start: boolean
       },
@@ -33,6 +35,7 @@ export const createCommand = new Command('create')
         let containerName = name
         let engine = options.engine
         let version = options.pgVersion
+        let database = options.database
 
         // Interactive mode if no name provided
         if (!containerName) {
@@ -40,8 +43,12 @@ export const createCommand = new Command('create')
           containerName = answers.name
           engine = answers.engine
           version = answers.version
+          database = answers.database
         }
 
+        // Default database name to container name if not specified
+        database = database ?? containerName
+
         console.log(header('Creating Database Container'))
         console.log()
 
@@ -97,19 +104,20 @@ export const createCommand = new Command('create')
           engine: dbEngine.name,
           version,
           port,
+          database,
         })
 
         createSpinnerInstance.succeed('Container created')
 
-        // Initialize database
-        const initSpinner = createSpinner('Initializing database...')
+        // Initialize database cluster
+        const initSpinner = createSpinner('Initializing database cluster...')
         initSpinner.start()
 
         await dbEngine.initDataDir(containerName, version, {
           superuser: defaults.superuser,
         })
 
-        initSpinner.succeed('Database initialized')
+        initSpinner.succeed('Database cluster initialized')
 
         // Start container if requested
         if (options.start !== false) {
@@ -125,6 +133,18 @@ export const createCommand = new Command('create')
           }
 
           startSpinner.succeed('PostgreSQL started')
+
+          // Create the user's database (if different from 'postgres')
+          if (config && database !== 'postgres') {
+            const dbSpinner = createSpinner(
+              `Creating database "${database}"...`,
+            )
+            dbSpinner.start()
+
+            await dbEngine.createDatabase(config, database)
+
+            dbSpinner.succeed(`Database "${database}" created`)
+          }
         }
 
         // Show success message