pgpm 0.1.1 → 0.2.0

package/README.md

@@ -1,15 +1,18 @@
-# pgpm
+# **pgpm — a Postgres Package Manager**
 
-> PostgreSQL Package Manager - Database migration and package management CLI
+**A modern CLI for modular PostgreSQL development.**
 
-`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.
+`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.
 
 ## ✨ Features
 
-- 📦 **Module System** - Reusable database modules with dependency management
-- 🔄 **Smart Migrations** - Automated migration generation and deployment
-- 🏗️ **Production Ready** - Deployment plans, versioning, and rollback support
-- 🚀 **Database-First Development** - Design your database with SQL migrations
+- 📦 **Postgres Module System** — Reusable, composable database packages with dependency management, per-module plans, and versioned releases
+- 🔄 **Deterministic Migration Engine** — Version-controlled, plan-driven deployments with rollback support and idempotent execution enforced by dependency and validation safeguards.
+- 📊 **Recursive Module Resolution** — Recursively resolves database package dependencies (just like npm) from plan files or SQL headers, producing a reproducible cross-module migration graph.
+- 🏷️ **Tag-Aware Versioning** - Deploy to @tags, resolve tags to changes, and reference tags across modules for coordinated releases
+- 🐘 **Portable Postgres Development** — Rely on standard SQL migrations for a workflow that runs anywhere Postgres does.
+- 🚀 **Turnkey Module-First Workspaces** — `pgpm init` delivers a ready-to-code Postgres workspace with CI/CD, Docker, end-to-end testing, and modern TS tooling.
+
 
 ## 🚀 Quick Start
 
@@ -37,7 +40,7 @@ pgpm deploy --createdb
 
 ### Getting Started
 
-- `pgpm init` - Initialize a new workspace or module
+- `pgpm init` - Initialize a new module
 - `pgpm init --workspace` - Initialize a new workspace
 
 ### Database Operations
@@ -89,6 +92,8 @@ cd my-app
 pgpm init
 
 # 3. Add some SQL migrations to sql/ directory
+pgpm add some_change
+
 # 4. Deploy to database
 pgpm deploy --createdb
 ```
@@ -174,14 +179,14 @@ pgpm migrate deps
 
 #### `pgpm install`
 
-Install LaunchQL modules as dependencies.
+Install pgpm modules as dependencies.
 
 ```bash
 # Install single package
-pgpm install @launchql/auth
+pgpm install @pgpm/base32
 
 # Install multiple packages
-pgpm install @launchql/auth @launchql/utils
+pgpm install @pgpm/base32 @pgpm/faker
 ```
 
 #### `pgpm extension`

package/commands/clear.js

@@ -38,7 +38,7 @@ exports.default = async (argv, prompter, _options) => {
     if (!modulePath) {
         throw new Error('Could not resolve module path');
     }
-    const planPath = path_1.default.join(modulePath, 'launchql.plan');
+    const planPath = path_1.default.join(modulePath, 'pgpm.plan');
     const result = (0, core_2.parsePlanFile)(planPath);
     if (result.errors.length > 0) {
         throw types_1.errors.PLAN_PARSE_ERROR({ planPath, errors: result.errors.map(e => e.message).join(', ') });

package/commands/init/module.js

@@ -13,8 +13,8 @@ async function runModuleSetup(argv, prompter) {
         log.error('Not inside a LaunchQL workspace.');
         throw types_1.errors.NOT_IN_WORKSPACE({});
     }
-    if (!project.isInsideAllowedDirs(cwd) && !project.isInWorkspace()) {
-        log.error('You must be inside one of the workspace packages.');
+    if (!project.isInsideAllowedDirs(cwd) && !project.isInWorkspace() && !project.isParentOfAllowedDirs(cwd)) {
+        log.error('You must be inside the workspace root or a parent directory of modules (like packages/).');
         throw types_1.errors.NOT_IN_WORKSPACE_MODULE({});
     }
     const availExtensions = project.getAvailableModules();

package/commands/migrate/deps.js

@@ -10,9 +10,9 @@ const database_1 = require("../../utils/database");
 const log = new logger_1.Logger('migrate-deps');
 exports.default = async (argv, prompter, options) => {
     const cwd = argv.cwd || process.cwd();
-    const planPath = (0, path_1.join)(cwd, 'launchql.plan');
+    const planPath = (0, path_1.join)(cwd, 'pgpm.plan');
     if (!(0, fs_1.existsSync)(planPath)) {
-        log.error(`No launchql.plan found in ${cwd}`);
+        log.error(`No pgpm.plan found in ${cwd}`);
         process.exit(1);
     }
     // Get specific change to analyze

package/commands/migrate/list.js

@@ -10,9 +10,9 @@ const database_1 = require("../../utils/database");
 const log = new logger_1.Logger('migrate-list');
 exports.default = async (argv, prompter, options) => {
     const cwd = argv.cwd || process.cwd();
-    const planPath = (0, path_1.join)(cwd, 'launchql.plan');
+    const planPath = (0, path_1.join)(cwd, 'pgpm.plan');
     if (!(0, fs_1.existsSync)(planPath)) {
-        log.error(`No launchql.plan found in ${cwd}`);
+        log.error(`No pgpm.plan found in ${cwd}`);
         process.exit(1);
     }
     // Get database configuration

package/commands/migrate/status.js

@@ -10,9 +10,9 @@ const database_1 = require("../../utils/database");
 const log = new logger_1.Logger('migrate-status');
 exports.default = async (argv, prompter, options) => {
     const cwd = argv.cwd || process.cwd();
-    const planPath = (0, path_1.join)(cwd, 'launchql.plan');
+    const planPath = (0, path_1.join)(cwd, 'pgpm.plan');
     if (!(0, fs_1.existsSync)(planPath)) {
-        log.error(`No launchql.plan found in ${cwd}`);
+        log.error(`No pgpm.plan found in ${cwd}`);
         process.exit(1);
     }
     // Get database configuration

package/esm/commands/clear.js

@@ -33,7 +33,7 @@ export default async (argv, prompter, _options) => {
     if (!modulePath) {
         throw new Error('Could not resolve module path');
     }
-    const planPath = path.join(modulePath, 'launchql.plan');
+    const planPath = path.join(modulePath, 'pgpm.plan');
     const result = parsePlanFile(planPath);
     if (result.errors.length > 0) {
         throw errors.PLAN_PARSE_ERROR({ planPath, errors: result.errors.map(e => e.message).join(', ') });

package/esm/commands/init/module.js

@@ -10,8 +10,8 @@ export default async function runModuleSetup(argv, prompter) {
         log.error('Not inside a LaunchQL workspace.');
         throw errors.NOT_IN_WORKSPACE({});
     }
-    if (!project.isInsideAllowedDirs(cwd) && !project.isInWorkspace()) {
-        log.error('You must be inside one of the workspace packages.');
+    if (!project.isInsideAllowedDirs(cwd) && !project.isInWorkspace() && !project.isParentOfAllowedDirs(cwd)) {
+        log.error('You must be inside the workspace root or a parent directory of modules (like packages/).');
         throw errors.NOT_IN_WORKSPACE_MODULE({});
     }
     const availExtensions = project.getAvailableModules();

package/esm/commands/migrate/deps.js

@@ -8,9 +8,9 @@ import { getTargetDatabase } from '../../utils/database';
 const log = new Logger('migrate-deps');
 export default async (argv, prompter, options) => {
     const cwd = argv.cwd || process.cwd();
-    const planPath = join(cwd, 'launchql.plan');
+    const planPath = join(cwd, 'pgpm.plan');
     if (!existsSync(planPath)) {
-        log.error(`No launchql.plan found in ${cwd}`);
+        log.error(`No pgpm.plan found in ${cwd}`);
         process.exit(1);
     }
     // Get specific change to analyze

package/esm/commands/migrate/list.js

@@ -8,9 +8,9 @@ import { getTargetDatabase } from '../../utils/database';
 const log = new Logger('migrate-list');
 export default async (argv, prompter, options) => {
     const cwd = argv.cwd || process.cwd();
-    const planPath = join(cwd, 'launchql.plan');
+    const planPath = join(cwd, 'pgpm.plan');
     if (!existsSync(planPath)) {
-        log.error(`No launchql.plan found in ${cwd}`);
+        log.error(`No pgpm.plan found in ${cwd}`);
         process.exit(1);
     }
     // Get database configuration

package/esm/commands/migrate/status.js

@@ -8,9 +8,9 @@ import { getTargetDatabase } from '../../utils/database';
 const log = new Logger('migrate-status');
 export default async (argv, prompter, options) => {
     const cwd = argv.cwd || process.cwd();
-    const planPath = join(cwd, 'launchql.plan');
+    const planPath = join(cwd, 'pgpm.plan');
     if (!existsSync(planPath)) {
-        log.error(`No launchql.plan found in ${cwd}`);
+        log.error(`No pgpm.plan found in ${cwd}`);
         process.exit(1);
     }
     // Get database configuration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pgpm",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "author": "Dan Lynch <pyramation@gmail.com>",
   "description": "PostgreSQL Package Manager - Database migration and package management CLI",
   "main": "index.js",
@@ -25,7 +25,7 @@
   "scripts": {
     "copy": "copyfiles -f ../../LICENSE README.md package.json dist",
     "clean": "rimraf dist/**",
-    "prepare": "npm run build",
+    "prepack": "npm run build",
     "build": "npm run clean; tsc -p tsconfig.json; tsc -p tsconfig.esm.json; npm run copy",
     "build:dev": "npm run clean; tsc -p tsconfig.json --declarationMap; tsc -p tsconfig.esm.json; npm run copy",
     "dev": "ts-node ./src/index.ts",
@@ -45,17 +45,17 @@
     "ts-node": "^10.9.2"
   },
   "dependencies": {
-    "@launchql/core": "^2.14.4",
-    "@launchql/env": "^2.4.6",
-    "@launchql/logger": "^1.1.3",
-    "@launchql/templatizer": "^2.4.6",
-    "@launchql/types": "^2.7.1",
+    "@launchql/core": "^2.15.0",
+    "@launchql/env": "^2.5.0",
+    "@launchql/logger": "^1.1.4",
+    "@launchql/templatizer": "^2.5.0",
+    "@launchql/types": "^2.8.0",
     "chalk": "^4.1.0",
     "inquirerer": "^2.0.8",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
-    "pg-cache": "^1.3.9",
-    "pg-env": "^1.1.1",
+    "pg-cache": "^1.4.0",
+    "pg-env": "^1.1.2",
     "shelljs": "^0.9.2"
   },
   "keywords": [
@@ -70,5 +70,5 @@
     "pg",
     "pgsql"
   ],
-  "gitHead": "efef74a45c940502c4f4cdeb889dfeaf5c9a65a6"
+  "gitHead": "810621bb74659b75a5360634c9cf91bf0996ce19"
 }