pgpm 0.0.1 → 0.1.0

package/LICENSE

@@ -0,0 +1,23 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Dan Lynch <pyramation@gmail.com>
+Copyright (c) 2025 Hyperweb <developers@hyperweb.io>
+Copyright (c) 2020-present, Interweb, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,260 +1,254 @@
-# LaunchQL CLI
+# pgpm
 
-> Build secure, role-aware GraphQL backends powered by PostgreSQL with database-first development
+> PostgreSQL Package Manager - Database migration and package management CLI
 
-LaunchQL CLI is a comprehensive command-line tool that transforms your PostgreSQL database into a powerful GraphQL API. With automated schema generation, sophisticated migration management, and robust deployment capabilities, you can focus on building great applications instead of boilerplate code.
+`pgpm` is a focused command-line tool for PostgreSQL database migrations and package management. It provides the core functionality for managing database schemas, migrations, and module dependencies without the overhead of server or explorer components.
 
 ## ✨ Features
 
-- 🚀 **Database-First Development** - Design your database, get your GraphQL API automatically
-- 🔐 **Built-in Security** - Role-based access control and security policies
 - 📦 **Module System** - Reusable database modules with dependency management
 - 🔄 **Smart Migrations** - Automated migration generation and deployment
-- 🛠️ **Developer Experience** - Hot-reload development server with GraphiQL explorer
 - 🏗️ **Production Ready** - Deployment plans, versioning, and rollback support
+- 🚀 **Database-First Development** - Design your database with SQL migrations
 
 ## 🚀 Quick Start
 
 ### Installation
 
 ```bash
-npm install -g @launchql/cli
+npm install -g pgpm
 ```
 
 ### Create Your First Project
 
 ```bash
 # Initialize a new workspace
-lql init --workspace
+pgpm init --workspace
 cd my-project
 
 # Create your first module
-lql init
+pgpm init
 
 # Deploy to your database
-lql deploy --createdb
-
-# Start the development server
-lql server
+pgpm deploy --createdb
 ```
 
-Visit `http://localhost:5555` to explore your GraphQL API!
-
-## 📖 Core Concepts
-
-### Workspaces and Modules
-
-- **Workspace**: A collection of related database modules
-- **Module**: A self-contained database package with migrations, functions, and types
-- **Dependencies**: Modules can depend on other modules, creating reusable building blocks
-
-### Database-First Workflow
-
-1. **Design** your database schema using SQL migrations
-2. **Deploy** changes with `lql deploy`
-3. **Develop** against the auto-generated GraphQL API
-4. **Version** and **package** your modules for distribution
-
 ## 🛠️ Commands
 
 ### Getting Started
 
-#### `lql init`
+- `pgpm init` - Initialize a new workspace or module
+- `pgpm init --workspace` - Initialize a new workspace
 
-Initialize a new LaunchQL workspace or module.
+### Database Operations
 
-```bash
-# Create a new workspace
-lql init --workspace
+- `pgpm deploy` - Deploy database changes and migrations
+- `pgpm verify` - Verify database state matches expected migrations
+- `pgpm revert` - Safely revert database changes
 
-# Create a new module (run inside workspace)
-lql init
+### Migration Management
 
-# Use templates from GitHub repository
-lql init --workspace --repo owner/repo
-lql init --repo owner/repo --from-branch develop
+- `pgpm migrate` - Comprehensive migration management
+- `pgpm migrate init` - Initialize migration tracking
+- `pgpm migrate status` - Check migration status
+- `pgpm migrate list` - List all changes
+- `pgpm migrate deps` - Show change dependencies
 
-# Use templates from local path
-lql init --workspace --template-path ./custom-templates
-lql init --template-path ./custom-templates/module
-```
+### Module Management
+
+- `pgpm install` - Install database modules as dependencies
+- `pgpm extension` - Interactively manage module dependencies
+- `pgpm tag` - Version your changes with tags
+
+### Packaging and Distribution
 
-**Options:**
+- `pgpm plan` - Generate deployment plans for your modules
+- `pgpm package` - Package your module for distribution
 
-- `--workspace` - Initialize workspace instead of module
-- `--repo <repo>` - Use templates from GitHub repository (e.g., `owner/repo`)
-- `--template-path <path>` - Use templates from local path
-- `--from-branch <branch>` - Specify branch when using `--repo` (default: `main`)
+### Utilities
 
-### Development
+- `pgpm add` - Add a new database change
+- `pgpm remove` - Remove a database change
+- `pgpm export` - Export migrations from existing databases
+- `pgpm clear` - Clear database state
+- `pgpm kill` - Clean up database connections
+- `pgpm analyze` - Analyze database structure
+- `pgpm rename` - Rename database changes
+- `pgpm admin-users` - Manage admin users
 
-#### `lql server`
+## 💡 Common Workflows
 
-Start the GraphQL development server with hot-reload.
+### Starting a New Project
 
 ```bash
-# Start with defaults (port 5555)
-lql server
+# 1. Create workspace
+pgpm init --workspace
+cd my-app
 
-# Custom port and options
-lql server --port 8080 --no-postgis
-```
+# 2. Create your first module
+pgpm init
 
-#### `lql explorer`
+# 3. Add some SQL migrations to sql/ directory
+# 4. Deploy to database
+pgpm deploy --createdb
+```
 
-Launch GraphiQL explorer for your API.
+### Working with Existing Projects
 
 ```bash
-# Launch explorer
-lql explorer
+# 1. Clone and enter project
+git clone <repo> && cd <project>
 
-# With custom CORS origin
-lql explorer --origin http://localhost:3000
+# 2. Install dependencies
+pgpm install
+
+# 3. Deploy to local database
+pgpm deploy --createdb
 ```
 
 ### Database Operations
 
-#### `lql deploy`
+#### `pgpm deploy`
 
 Deploy your database changes and migrations.
 
 ```bash
 # Deploy to selected database
-lql deploy
+pgpm deploy
 
 # Create database if it doesn't exist
-lql deploy --createdb
+pgpm deploy --createdb
 
 # Deploy specific package to a tag
-lql deploy --package mypackage --to @v1.0.0
+pgpm deploy --package mypackage --to @v1.0.0
 
 # Fast deployment without transactions
-lql deploy --fast --no-tx
+pgpm deploy --fast --no-tx
 ```
 
-#### `lql verify`
+#### `pgpm verify`
 
 Verify your database state matches expected migrations.
 
 ```bash
 # Verify current state
-lql verify
+pgpm verify
 
 # Verify specific package
-lql verify --package mypackage
+pgpm verify --package mypackage
 ```
 
-#### `lql revert`
+#### `pgpm revert`
 
 Safely revert database changes.
 
 ```bash
 # Revert latest changes
-lql revert
+pgpm revert
 
 # Revert to specific tag
-lql revert --to @v1.0.0
+pgpm revert --to @v1.0.0
 ```
 
 ### Migration Management
 
-#### `lql migrate`
+#### `pgpm migrate`
 
 Comprehensive migration management.
 
 ```bash
 # Initialize migration tracking
-lql migrate init
+pgpm migrate init
 
 # Check migration status
-lql migrate status
+pgpm migrate status
 
 # List all changes
-lql migrate list
+pgpm migrate list
 
 # Show change dependencies
-lql migrate deps
+pgpm migrate deps
 ```
 
 ### Module Management
 
-#### `lql install`
+#### `pgpm install`
 
 Install LaunchQL modules as dependencies.
 
 ```bash
 # Install single package
-lql install @launchql/auth
+pgpm install @launchql/auth
 
 # Install multiple packages
-lql install @launchql/auth @launchql/utils
+pgpm install @launchql/auth @launchql/utils
 ```
 
-#### `lql extension`
+#### `pgpm extension`
 
 Interactively manage module dependencies.
 
 ```bash
-lql extension
+pgpm extension
 ```
 
-#### `lql tag`
+#### `pgpm tag`
 
 Version your changes with tags.
 
 ```bash
 # Tag latest change
-lql tag v1.0.0
+pgpm tag v1.0.0
 
 # Tag with comment
-lql tag v1.0.0 --comment "Initial release"
+pgpm tag v1.0.0 --comment "Initial release"
 
 # Tag specific change
-lql tag v1.1.0 --package mypackage --changeName my-change
+pgpm tag v1.1.0 --package mypackage --changeName my-change
 ```
 
 ### Packaging and Distribution
 
-#### `lql plan`
+#### `pgpm plan`
 
 Generate deployment plans for your modules.
 
 ```bash
-lql plan
+pgpm plan
 ```
 
-#### `lql package`
+#### `pgpm package`
 
 Package your module for distribution.
 
 ```bash
 # Package with defaults
-lql package
+pgpm package
 
 # Package without deployment plan
-lql package --no-plan
+pgpm package --no-plan
 ```
 
 ### Utilities
 
-#### `lql export`
+#### `pgpm export`
 
 Export migrations from existing databases.
 
 ```bash
-lql export
+pgpm export
 ```
 
-#### `lql kill`
+#### `pgpm kill`
 
 Clean up database connections and optionally drop databases.
 
 ```bash
 # Kill connections and drop databases
-lql kill
+pgpm kill
 
 # Only kill connections
-lql kill --no-drop
+pgpm kill --no-drop
 ```
 
 ## 💡 Common Workflows
@@ -264,17 +258,17 @@ lql kill --no-drop
 ```bash
 # 1. Create workspace
 mkdir my-app && cd my-app
-lql init --workspace
+pgpm init --workspace
 
 # 2. Create your first module
-lql init
+pgpm init
 
 # 3. Add some SQL migrations to sql/ directory
 # 4. Deploy to database
-lql deploy --createdb
+pgpm deploy --createdb
 
 # 5. Start developing
-lql server
+pgpm server
 ```
 
 ### Using Custom Templates
@@ -283,16 +277,16 @@ You can use custom templates from GitHub repositories or local paths:
 
 ```bash
 # Initialize workspace with templates from GitHub
-lql init --workspace --repo owner/repo
+pgpm init --workspace --repo owner/repo
 
 # Initialize workspace with templates from local path
-lql init --workspace --template-path ./my-custom-templates
+pgpm init --workspace --template-path ./my-custom-templates
 
 # Initialize module with custom templates
-lql init --template-path ./my-custom-templates
+pgpm init --template-path ./my-custom-templates
 
 # Use specific branch from GitHub repository
-lql init --workspace --repo owner/repo --from-branch develop
+pgpm init --workspace --repo owner/repo --from-branch develop
 ```
 
 **Template Structure:**
@@ -309,29 +303,29 @@ Custom templates should follow the same structure as the default templates:
 git clone <repo> && cd <project>
 
 # 2. Install dependencies
-lql install
+pgpm install
 
 # 3. Deploy to local database
-lql deploy --createdb
+pgpm deploy --createdb
 
 # 4. Start development server
-lql server
+pgpm server
 ```
 
 ### Production Deployment
 
 ```bash
 # 1. Create deployment plan
-lql plan
+pgpm plan
 
 # 2. Package module
-lql package
+pgpm package
 
 # 3. Deploy to production
-lql deploy --package myapp --to @production
+pgpm deploy --package myapp --to @production
 
 # 4. Verify deployment
-lql verify --package myapp
+pgpm verify --package myapp
 ```
 
 ## ⚙️ Configuration
@@ -354,11 +348,11 @@ export PGPASSWORD=password
 
 ```bash
 # Global help
-lql --help
+pgpm --help
 
 # Command-specific help
-lql deploy --help
-lql server -h
+pgpm deploy --help
+pgpm server -h
 ```
 
 ### Common Options
@@ -404,6 +398,7 @@ Most commands support these global options:
 
 ### 🧰 CLI & Codegen
 
+* [pgpm](https://github.com/launchql/launchql/tree/main/packages/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
 * [@launchql/cli](https://github.com/launchql/launchql/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing LaunchQL projects—supports database scaffolding, migrations, seeding, code generation, and automation.
 * [launchql/launchql-gen](https://github.com/launchql/launchql/tree/main/packages/launchql-gen): **✨ Auto-generated GraphQL** mutations and queries dynamically built from introspected schema data.
 * [@launchql/query-builder](https://github.com/launchql/launchql/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries.

package/commands/add.js

@@ -34,12 +34,12 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@launchql/core");
-const argv_1 = require("../utils/argv");
 const path = __importStar(require("path"));
+const argv_1 = require("../utils/argv");
 const addUsageText = `
-LaunchQL Add Command:
+Add Command:
 
-  lql add [change] [OPTIONS]
+  pgpm add [change] [OPTIONS]
 
   Add a database change to plans and create deploy/revert/verify SQL files.
 
@@ -53,10 +53,10 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql add organizations                                    Add change named 'organizations'
-  lql add brands --note "Adds the brands table"  Add change with note
-  lql add contacts --requires users --note "Adds contacts table"  Add with dependency
-  lql add be/a/path/like/this                        Add change with nested path
+  pgpm add organizations                                    Add change named 'organizations'
+  pgpm add brands --note "Adds the brands table"  Add change with note
+  pgpm add contacts --requires users --note "Adds contacts table"  Add with dependency
+  pgpm add be/a/path/like/this                        Add change with nested path
 `;
 exports.default = async (argv, prompter, _options) => {
     // Show usage if explicitly requested

package/commands/admin-users/add.js

@@ -5,12 +5,12 @@ const logger_1 = require("@launchql/logger");
 const pg_env_1 = require("pg-env");
 const log = new logger_1.Logger('admin-users-add');
 const addUsageText = `
-LaunchQL Admin Users Add Command:
+Admin Users Add Command:
 
-  lql admin-users add [OPTIONS]
+  pgpm admin-users add [OPTIONS]
 
-  Add database users with LaunchQL roles.
-  Note: You must run 'lql admin-users bootstrap' first to initialize roles.
+  Add database users with postgres roles.
+  Note: You must run 'pgpm admin-users bootstrap' first to initialize roles.
 
 Options:
   --help, -h              Show this help message
@@ -20,9 +20,9 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql admin-users add --username myuser --password mypass
-  lql admin-users add --test                # Add test users (requires bootstrap first)
-  lql admin-users add                       # Will prompt for username and password
+  pgpm admin-users add --username myuser --password mypass
+  pgpm admin-users add --test                # Add test users (requires bootstrap first)
+  pgpm admin-users add                       # Will prompt for username and password
 `;
 exports.default = async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -39,7 +39,7 @@ exports.default = async (argv, prompter, _options) => {
                 {
                     type: 'confirm',
                     name: 'yes',
-                    message: 'Are you sure you want to add LaunchQL test users? (WARNING: Should NEVER be run on production!)',
+                    message: 'Are you sure you want to add test users? (WARNING: Should NEVER be run on production!)',
                     default: false
                 }
             ]);

package/commands/admin-users/bootstrap.js

@@ -5,19 +5,19 @@ const logger_1 = require("@launchql/logger");
 const pg_env_1 = require("pg-env");
 const log = new logger_1.Logger('admin-users-bootstrap');
 const bootstrapUsageText = `
-LaunchQL Admin Users Bootstrap Command:
+Admin Users Bootstrap Command:
 
-  lql admin-users bootstrap [OPTIONS]
+  pgpm admin-users bootstrap [OPTIONS]
 
-  Initialize LaunchQL roles and permissions. This command must be run before adding users.
-  Creates the standard LaunchQL roles: anonymous, authenticated, administrator.
+  Initialize postgres roles and permissions. This command must be run before adding users.
+  Creates the standard postgres roles: anonymous, authenticated, administrator.
 
 Options:
   --help, -h              Show this help message
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql admin-users bootstrap              # Initialize LaunchQL roles
+  pgpm admin-users bootstrap              # Initialize postgres roles
 `;
 exports.default = async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -30,7 +30,7 @@ exports.default = async (argv, prompter, _options) => {
         {
             type: 'confirm',
             name: 'yes',
-            message: 'Are you sure you want to initialize LaunchQL roles and permissions?',
+            message: 'Are you sure you want to initialize postgres roles and permissions?',
             default: false
         }
     ]);
@@ -41,7 +41,7 @@ exports.default = async (argv, prompter, _options) => {
     const init = new core_1.LaunchQLInit(pgEnv);
     try {
         await init.bootstrapRoles();
-        log.success('LaunchQL roles and permissions initialized successfully.');
+        log.success('postgres roles and permissions initialized successfully.');
     }
     finally {
         await init.close();

package/commands/admin-users/remove.js

@@ -5,11 +5,11 @@ const logger_1 = require("@launchql/logger");
 const pg_env_1 = require("pg-env");
 const log = new logger_1.Logger('admin-users-remove');
 const removeUsageText = `
-LaunchQL Admin Users Remove Command:
+Admin Users Remove Command:
 
-  lql admin-users remove [OPTIONS]
+  pgpm admin-users remove [OPTIONS]
 
-  Remove database users and revoke their LaunchQL roles.
+  Remove database users and revoke their postgres roles.
 
 Options:
   --help, -h              Show this help message
@@ -18,9 +18,9 @@ Options:
   --cwd <directory>       Working directory (default: current directory)
 
 Examples:
-  lql admin-users remove --username myuser
-  lql admin-users remove --test             # Remove test users
-  lql admin-users remove                    # Will prompt for username
+  pgpm admin-users remove --username myuser
+  pgpm admin-users remove --test             # Remove test users
+  pgpm admin-users remove                    # Will prompt for username
 `;
 exports.default = async (argv, prompter, _options) => {
     // Show usage if explicitly requested
@@ -37,7 +37,7 @@ exports.default = async (argv, prompter, _options) => {
                 {
                     type: 'confirm',
                     name: 'yes',
-                    message: 'Are you sure you want to remove LaunchQL test users (app_user, app_admin)?',
+                    message: 'Are you sure you want to remove test users (app_user, app_admin)?',
                     default: false
                 }
             ]);

package/commands/admin-users.js

@@ -13,11 +13,11 @@ const subcommandMap = {
     remove: remove_1.default
 };
 const adminUsersUsageText = `
-LaunchQL Admin Users Commands:
+Admin Users Commands:
 
-  lql admin-users bootstrap    Initialize LaunchQL roles and permissions (must be run first)
-  lql admin-users add          Add database users with roles
-  lql admin-users remove       Remove database users and revoke roles
+  pgpm admin-users bootstrap    Initialize postgres roles and permissions (must be run first)
+  pgpm admin-users add          Add database users with roles
+  pgpm admin-users remove       Remove database users and revoke roles
 
 Options:
   --help, -h     Show this help message
@@ -60,7 +60,7 @@ exports.default = async (argv, prompter, options) => {
 };
 function getSubcommandDescription(cmd) {
     const descriptions = {
-        bootstrap: 'Initialize LaunchQL roles and permissions (must be run first)',
+        bootstrap: 'Initialize postgres roles and permissions (must be run first)',
         add: 'Add database users with roles',
         remove: 'Remove database users and revoke roles'
     };

package/commands/analyze.js

@@ -3,8 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = __importDefault(require("path"));
 const core_1 = require("@launchql/core");
+const path_1 = __importDefault(require("path"));
 exports.default = async (argv, _prompter) => {
     const cwd = argv.cwd || process.cwd();
     const proj = new core_1.LaunchQLPackage(path_1.default.resolve(cwd));