devports 0.0.1 → 1.0.0

package/dist/worktree.js

@@ -0,0 +1,245 @@
+/**
+ * Secure worktree operations with input validation and safe command execution
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join, basename } from 'path';
+import { glob } from 'glob';
+import { allocatePort, releasePort } from './port-manager.js';
+import { detectServicesFromTemplate, extractProjectNameFromTemplate, makeUrlSafe, processTemplate, } from './render.js';
+import { safeGitWorktreeAdd, safeGitWorktreeRemove, safeScriptExecution, } from './execution.js';
+import { validateWorktreePath, validateBranchName, validateScriptPath, validateServices, validateTemplatePath, validateOutputPath, } from './validation.js';
+/**
+ * Secure version of createWorktree with input validation and safe command execution
+ */
+export async function createWorktree(path, branch, options = {}) {
+    // Validate all inputs first
+    const validatedPath = validateWorktreePath(path);
+    const validatedBranch = validateBranchName(branch);
+    let validatedServices;
+    if (options.services) {
+        const validatedServiceList = validateServices(options.services);
+        validatedServices = validatedServiceList.map((s) => `${s.service}:${s.type}`);
+    }
+    const validatedTemplate = options.template
+        ? validateTemplatePath(options.template)
+        : undefined;
+    const validatedEnvFile = options.envFile
+        ? validateOutputPath(options.envFile)
+        : options.envFile;
+    const validatedPostHook = options.postHook
+        ? validateScriptPath(options.postHook)
+        : undefined;
+    // Extract worktree identifier from path
+    const worktreeDir = basename(validatedPath);
+    // Create the git worktree using safe execution
+    try {
+        await safeGitWorktreeAdd(validatedPath, validatedBranch);
+    }
+    catch (error) {
+        throw new Error(`Failed to create git worktree: ${error.message}`);
+    }
+    // Determine services to allocate and extract project name
+    let services;
+    let templateContent = null;
+    let projectName = null;
+    let templatePath = null;
+    if (validatedTemplate ?? existsSync('.env.devports')) {
+        templatePath = validatedTemplate ?? '.env.devports';
+        try {
+            templateContent = readFileSync(templatePath, 'utf-8');
+            services = detectServicesFromTemplate(templateContent, templatePath);
+            projectName = extractProjectNameFromTemplate(templateContent);
+        }
+        catch {
+            console.warn(`⚠️  Could not read template ${templatePath}, falling back to detection`);
+            services =
+                validatedServices ??
+                    detectServices(validatedPath, validatedEnvFile ?? undefined);
+        }
+    }
+    else {
+        services =
+            validatedServices ??
+                detectServices(validatedPath, validatedEnvFile ?? undefined);
+    }
+    // Override with explicit services if provided
+    if (validatedServices) {
+        services = validatedServices;
+    }
+    // Use project name from template or generate one from worktree directory
+    const finalProjectName = projectName ?? worktreeDir;
+    const urlSafeProjectName = makeUrlSafe(finalProjectName);
+    console.log(`✅ Created worktree: ${validatedPath}`);
+    console.log(`   Branch: ${validatedBranch}`);
+    if (services.length > 0) {
+        console.log(`📍 Detected services: ${services.map((s) => s.split(':')[0]).join(', ')}`);
+    }
+    // Allocate ports for each service
+    const allocatedPorts = {};
+    const serviceTypes = {};
+    for (const service of services) {
+        const [serviceName, serviceType] = service.split(':');
+        const port = await allocatePort(urlSafeProjectName, serviceName, serviceType);
+        allocatedPorts[serviceName] = port;
+        serviceTypes[serviceName] = serviceType;
+    }
+    if (Object.keys(allocatedPorts).length > 0) {
+        console.log('🔌 Allocated ports:');
+        for (const [service, port] of Object.entries(allocatedPorts)) {
+            const type = serviceTypes[service];
+            console.log(`   ${service}: ${port} (${type})`);
+        }
+    }
+    // Generate .env file in the worktree if not skipped
+    if (validatedEnvFile !== null) {
+        const envPath = join(validatedPath, validatedEnvFile ?? '.env');
+        if (templateContent) {
+            // Use template if available
+            const processedContent = processTemplate(templateContent, allocatedPorts, urlSafeProjectName, templatePath ?? undefined);
+            writeFileSync(envPath, processedContent);
+            console.log(`📝 Generated ${basename(envPath)} from template`);
+        }
+        else if (Object.keys(allocatedPorts).length > 0) {
+            // Create basic .env with just port variables
+            const envContent = `${[
+                '# Generated by devports worktree',
+                `DEVPORTS_PROJECT_NAME=${finalProjectName}`,
+                '',
+                ...Object.entries(allocatedPorts).map(([service, port]) => `${service.toUpperCase()}_PORT=${port}`),
+                '',
+                '# Example connection URLs:',
+                ...Object.entries(allocatedPorts)
+                    .filter(([, port]) => port >= 5432 && port < 5500)
+                    .map(([_service, port]) => `# DATABASE_URL=postgresql://user:password@localhost:${port}/myapp`),
+            ].join('\n')}\n`;
+            writeFileSync(envPath, envContent);
+            console.log(`📝 Generated basic ${basename(envPath)} with allocated ports`);
+        }
+        // Auto-render any *.devports files found in current directory
+        await autoRenderDevportsFiles(validatedPath, allocatedPorts, urlSafeProjectName);
+    }
+    // Run post-hook if available
+    if (validatedPostHook ?? existsSync('.devports/hooks/post-worktree')) {
+        await runPostHook(validatedPath, allocatedPorts, urlSafeProjectName, validatedPostHook);
+    }
+    return {
+        worktreePath: validatedPath,
+        ports: allocatedPorts,
+    };
+}
+/**
+ * Secure version of removeWorktree with input validation
+ */
+export async function removeWorktree(path, options = {}) {
+    // Validate input
+    const validatedPath = validateWorktreePath(path);
+    // Determine project name from the worktree directory
+    const worktreeDir = basename(validatedPath);
+    const urlSafeProjectName = makeUrlSafe(worktreeDir);
+    console.log(`🔄 Removing worktree: ${validatedPath}`);
+    // Release all ports for this project
+    const released = await releasePort(urlSafeProjectName, undefined, true);
+    if (released > 0) {
+        console.log(`🔌 Released ${released} allocated port(s)`);
+    }
+    // Remove the git worktree using safe execution
+    try {
+        await safeGitWorktreeRemove(validatedPath, options.force);
+        console.log('✅ Git worktree removed successfully');
+    }
+    catch (error) {
+        throw new Error(`Failed to remove git worktree: ${error.message}`);
+    }
+    return released;
+}
+/**
+ * Detect services from an existing .env file or defaults
+ */
+function detectServices(worktreePath, envFile) {
+    const services = [];
+    const envPath = join(process.cwd(), envFile ?? '.env');
+    if (existsSync(envPath)) {
+        const envContent = readFileSync(envPath, 'utf-8');
+        const portPatterns = [
+            { regex: /DATABASE_PORT|POSTGRES_PORT/i, service: 'postgres:postgres' },
+            { regex: /MYSQL_PORT/i, service: 'mysql:mysql' },
+            { regex: /REDIS_PORT/i, service: 'redis:redis' },
+            { regex: /API_PORT/i, service: 'api:api' },
+            { regex: /APP_PORT|WEB_PORT/i, service: 'app:app' },
+        ];
+        for (const pattern of portPatterns) {
+            if (pattern.regex.test(envContent) &&
+                !services.includes(pattern.service)) {
+                services.push(pattern.service);
+            }
+        }
+    }
+    // Default to postgres if nothing detected
+    if (services.length === 0) {
+        services.push('postgres:postgres');
+    }
+    return services;
+}
+/**
+ * Auto-render any *.devports files found in the current directory
+ */
+async function autoRenderDevportsFiles(worktreePath, allocatedPorts, projectName) {
+    try {
+        const devportsFiles = await glob('**/*.devports', {
+            cwd: process.cwd(),
+            ignore: ['node_modules/**', '.git/**'],
+        });
+        if (devportsFiles.length === 0) {
+            return;
+        }
+        console.log(`🔄 Auto-rendering ${devportsFiles.length} *.devports files for worktree...`);
+        for (const devportsFile of devportsFiles) {
+            const fullDevportsPath = join(process.cwd(), devportsFile);
+            const outputFileName = devportsFile.replace(/\.devports$/, '');
+            const outputPath = join(worktreePath, outputFileName);
+            try {
+                const templateContent = readFileSync(fullDevportsPath, 'utf-8');
+                const processedContent = processTemplate(templateContent, allocatedPorts, projectName, devportsFile);
+                writeFileSync(outputPath, processedContent);
+                console.log(`   ${outputFileName} (from ${devportsFile})`);
+            }
+            catch (error) {
+                console.warn(`⚠️  Failed to render ${devportsFile}: ${error.message}`);
+            }
+        }
+    }
+    catch (error) {
+        console.warn(`⚠️  Error during auto-rendering: ${error.message}`);
+    }
+}
+/**
+ * Run post-worktree hook if available (secure version)
+ */
+async function runPostHook(worktreePath, allocatedPorts, projectName, customHook) {
+    const hookScript = customHook ?? '.devports/hooks/post-worktree';
+    if (!existsSync(hookScript)) {
+        return;
+    }
+    try {
+        console.log('🔗 Running post-worktree hook...');
+        // Prepare environment variables
+        const hookEnv = {
+            DEVPORTS_PROJECT_NAME: projectName,
+            DEVPORTS_WORKTREE_PATH: worktreePath,
+        };
+        // Add all port variables
+        for (const [service, port] of Object.entries(allocatedPorts)) {
+            const varName = `${service.toUpperCase().replace(/-/g, '_')}_PORT`;
+            hookEnv[varName] = port.toString();
+        }
+        // Execute hook script safely
+        await safeScriptExecution(hookScript, hookEnv, {
+            cwd: process.cwd(),
+        });
+        console.log('✅ Post-worktree hook completed');
+    }
+    catch (error) {
+        console.warn(`⚠️  Post-worktree hook failed: ${error.message}`);
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../src/worktree.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,10 +1,94 @@
 {
   "name": "devports",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for devports",
+  "version": "1.0.0",
+  "description": "Port allocation manager for multi-project development",
+  "type": "module",
+  "bin": {
+    "devports": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc && cp src/completion/*.sh dist/completion/",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "prepublishOnly": "npm run test && npm run build",
+    "lint": "eslint . --max-warnings 100 && tsc --noEmit && npm run lint:shell",
+    "lint:fix": "eslint . --fix",
+    "lint:shell": "shellcheck src/completion/bash.sh && zsh -n src/completion/zsh.sh",
+    "preuninstall": "node dist/cli.js completion zsh --uninstall > /dev/null 2>&1 || true && node dist/cli.js completion bash --uninstall > /dev/null 2>&1 || true"
+  },
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+    "ports",
+    "docker",
+    "development",
+    "devtools",
+    "postgres",
+    "port-management",
+    "cli",
+    "automation",
+    "worktree",
+    "multi-project"
+  ],
+  "author": {
+    "name": "Ben Dechrai",
+    "email": "ben@dechrai.com",
+    "url": "https://bendechr.ai"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bendechrai/devports.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bendechrai/devports/issues"
+  },
+  "homepage": "https://github.com/bendechrai/devports#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "commander": "^12.1.0",
+    "glob": "^11.0.3",
+    "magic-string": "^0.30.21",
+    "proper-lockfile": "^4.1.2"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.0",
+    "@semantic-release/npm": "^13.1.2",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@types/glob": "^8.1.0",
+    "@types/node": "^22.10.2",
+    "@types/proper-lockfile": "^4.1.4",
+    "@typescript-eslint/eslint-plugin": "^8.47.0",
+    "@typescript-eslint/parser": "^8.47.0",
+    "@vitest/coverage-v8": "^4.0.10",
+    "eslint": "^9.39.1",
+    "globals": "^16.5.0",
+    "prettier": "^3.6.2",
+    "semantic-release": "^25.0.2",
+    "shellcheck": "^4.1.0",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.47.0",
+    "vitest": "^4.0.9"
+  },
+  "engines": {
+    "node": ">=18"
+  }
 }