devports 0.0.1 → 1.0.0

package/dist/services/lock-manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Lock management service for coordinating file access
+ * Abstracts the common lock/unlock patterns used throughout the application
+ */
+import type { Registry } from '../types.js';
+/**
+ * Configuration for lock operations
+ */
+export interface LockOptions {
+    retries?: number;
+    stale?: number;
+}
+/**
+ * Operation result that controls whether registry is saved
+ */
+export interface RegistryOperationResult<T> {
+    result: T;
+    shouldSave?: boolean;
+}
+/**
+ * Lock manager for coordinating registry file access
+ * Ensures thread-safe operations on the port registry
+ */
+export declare class LockManager {
+    /**
+     * Execute an operation with exclusive access to the registry file
+     * Handles the complete lock/load/save/unlock cycle
+     */
+    static withRegistryLock<T>(operation: (registry: Registry) => Promise<T> | T, options?: LockOptions): Promise<T>;
+    /**
+     * Execute an operation with conditional saving
+     * Save registry only if the operation indicates it should be saved
+     */
+    static withRegistryLockConditional<T>(operation: (registry: Registry) => Promise<RegistryOperationResult<T>> | RegistryOperationResult<T>, options?: LockOptions): Promise<T>;
+    /**
+     * Execute a read-only operation with shared access to the registry
+     * Loads registry without saving changes
+     */
+    static withRegistryReadLock<T>(operation: (registry: Registry) => Promise<T> | T, options?: LockOptions): Promise<T>;
+    /**
+     * Execute an operation with a custom file lock
+     * Generic lock manager for other file operations
+     */
+    static withFileLock<T>(filePath: string, operation: () => Promise<T> | T, options?: LockOptions): Promise<T>;
+}
+//# sourceMappingURL=lock-manager.d.ts.map

package/dist/services/lock-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-manager.d.ts","sourceRoot":"","sources":["../../src/services/lock-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC;IACV,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB;;;OAGG;WACU,gBAAgB,CAAC,CAAC,EAC7B,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACjD,OAAO,GAAE,WAAkC,GAC1C,OAAO,CAAC,CAAC,CAAC;IA6Bb;;;OAGG;WACU,2BAA2B,CAAC,CAAC,EACxC,SAAS,EAAE,CACT,QAAQ,EAAE,QAAQ,KACf,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,CAAC,CAAC,EACrE,OAAO,GAAE,WAAkC,GAC1C,OAAO,CAAC,CAAC,CAAC;IA+Bb;;;OAGG;WACU,oBAAoB,CAAC,CAAC,EACjC,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACjD,OAAO,GAAE,WAAkC,GAC1C,OAAO,CAAC,CAAC,CAAC;IA2Bb;;;OAGG;WACU,YAAY,CAAC,CAAC,EACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAC/B,OAAO,GAAE,WAAkC,GAC1C,OAAO,CAAC,CAAC,CAAC;CAYd"}

package/dist/services/lock-manager.js

@@ -0,0 +1,118 @@
+/**
+ * Lock management service for coordinating file access
+ * Abstracts the common lock/unlock patterns used throughout the application
+ */
+import lockfile from 'proper-lockfile';
+import { loadConfig, loadRegistry, saveRegistry } from '../config.js';
+/**
+ * Default lock options used throughout the application
+ */
+const DEFAULT_LOCK_OPTIONS = {
+    retries: 5,
+    stale: 10000,
+};
+/**
+ * Lock manager for coordinating registry file access
+ * Ensures thread-safe operations on the port registry
+ */
+export class LockManager {
+    /**
+     * Execute an operation with exclusive access to the registry file
+     * Handles the complete lock/load/save/unlock cycle
+     */
+    static async withRegistryLock(operation, options = DEFAULT_LOCK_OPTIONS) {
+        const config = loadConfig();
+        // Ensure registry exists before locking
+        loadRegistry();
+        // Lock the registry file
+        const release = await lockfile.lock(config.registryPath, {
+            retries: options.retries,
+            stale: options.stale,
+        });
+        try {
+            // Load fresh registry data while holding the lock
+            const registry = loadRegistry();
+            // Execute the operation with the registry
+            const result = await operation(registry);
+            // Save the registry after the operation
+            saveRegistry(registry);
+            return result;
+        }
+        finally {
+            // Always release the lock
+            await release();
+        }
+    }
+    /**
+     * Execute an operation with conditional saving
+     * Save registry only if the operation indicates it should be saved
+     */
+    static async withRegistryLockConditional(operation, options = DEFAULT_LOCK_OPTIONS) {
+        const config = loadConfig();
+        // Ensure registry exists before locking
+        loadRegistry();
+        // Lock the registry file
+        const release = await lockfile.lock(config.registryPath, {
+            retries: options.retries,
+            stale: options.stale,
+        });
+        try {
+            // Load fresh registry data while holding the lock
+            const registry = loadRegistry();
+            // Execute the operation with the registry
+            const operationResult = await operation(registry);
+            // Save the registry only if requested
+            if (operationResult.shouldSave !== false) {
+                saveRegistry(registry);
+            }
+            return operationResult.result;
+        }
+        finally {
+            // Always release the lock
+            await release();
+        }
+    }
+    /**
+     * Execute a read-only operation with shared access to the registry
+     * Loads registry without saving changes
+     */
+    static async withRegistryReadLock(operation, options = DEFAULT_LOCK_OPTIONS) {
+        const config = loadConfig();
+        // Ensure registry exists before locking
+        loadRegistry();
+        // Lock the registry file (even for reads to ensure consistency)
+        const release = await lockfile.lock(config.registryPath, {
+            retries: options.retries,
+            stale: options.stale,
+        });
+        try {
+            // Load fresh registry data while holding the lock
+            const registry = loadRegistry();
+            // Execute the read-only operation
+            const result = await operation(registry);
+            // No need to save for read-only operations
+            return result;
+        }
+        finally {
+            // Always release the lock
+            await release();
+        }
+    }
+    /**
+     * Execute an operation with a custom file lock
+     * Generic lock manager for other file operations
+     */
+    static async withFileLock(filePath, operation, options = DEFAULT_LOCK_OPTIONS) {
+        const release = await lockfile.lock(filePath, {
+            retries: options.retries,
+            stale: options.stale,
+        });
+        try {
+            return await operation();
+        }
+        finally {
+            await release();
+        }
+    }
+}
+//# sourceMappingURL=lock-manager.js.map

package/dist/services/lock-manager.js.map

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

package/dist/services/response-formatter.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Response formatter service - centralizes JSON/console output patterns
+ * Consolidates the repeated logic across all commands for DRY compliance
+ */
+export interface ResponseOptions {
+    json?: boolean;
+    quiet?: boolean;
+}
+export interface ResponseData {
+    success: boolean;
+    message?: string;
+    data?: unknown;
+}
+export declare class ResponseFormatter {
+    /**
+     * Format and output a response based on options
+     * Handles both JSON and console output patterns
+     */
+    static format(response: ResponseData, options?: ResponseOptions): ResponseData;
+    /**
+     * Format success response with message
+     */
+    static success(message: string, data?: unknown): ResponseData;
+    /**
+     * Format error response with message
+     */
+    static error(message: string, data?: unknown): ResponseData;
+    /**
+     * Format data-only response (for list operations, etc.)
+     */
+    static data(data: unknown, message?: string): ResponseData;
+    /**
+     * Handle quiet-specific output (like port numbers only)
+     */
+    static quiet(value: string | number, data?: unknown): ResponseData;
+    /**
+     * Format port allocation response (common pattern)
+     */
+    static portAllocation(port: number, project: string, service: string, type?: string): ResponseData;
+    /**
+     * Format port release response (common pattern)
+     */
+    static portRelease(count: number, target?: string): ResponseData;
+}
+//# sourceMappingURL=response-formatter.d.ts.map

package/dist/services/response-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.d.ts","sourceRoot":"","sources":["../../src/services/response-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,MAAM,CACX,QAAQ,EAAE,YAAY,EACtB,OAAO,GAAE,eAAoB,GAC5B,YAAY;IAwBf;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY;IAQ7D;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY;IAQ3D;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IAQ1D;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,YAAY;IAQlE;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,GACZ,YAAY;IAiBf;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;CAYjE"}

package/dist/services/response-formatter.js

@@ -0,0 +1,102 @@
+/**
+ * Response formatter service - centralizes JSON/console output patterns
+ * Consolidates the repeated logic across all commands for DRY compliance
+ */
+export class ResponseFormatter {
+    /**
+     * Format and output a response based on options
+     * Handles both JSON and console output patterns
+     */
+    static format(response, options = {}) {
+        if (options.json) {
+            // JSON output - consistent across all commands
+            const jsonData = response.data ?? {
+                success: response.success,
+                message: response.message,
+            };
+            console.log(JSON.stringify(jsonData, null, 2));
+            return response;
+        }
+        if (options.quiet) {
+            // Quiet mode - minimal or no output
+            return response;
+        }
+        // Console output - show message if present
+        if (response.message) {
+            console.log(response.message);
+        }
+        return response;
+    }
+    /**
+     * Format success response with message
+     */
+    static success(message, data) {
+        return {
+            success: true,
+            message,
+            data,
+        };
+    }
+    /**
+     * Format error response with message
+     */
+    static error(message, data) {
+        return {
+            success: false,
+            message,
+            data,
+        };
+    }
+    /**
+     * Format data-only response (for list operations, etc.)
+     */
+    static data(data, message) {
+        return {
+            success: true,
+            data,
+            message,
+        };
+    }
+    /**
+     * Handle quiet-specific output (like port numbers only)
+     */
+    static quiet(value, data) {
+        console.log(value);
+        return {
+            success: true,
+            data,
+        };
+    }
+    /**
+     * Format port allocation response (common pattern)
+     */
+    static portAllocation(port, project, service, type) {
+        const message = `✅ Allocated port ${port} for ${project}/${service}`;
+        const data = {
+            port,
+            project,
+            service,
+            type,
+            allocatedAt: new Date().toISOString(),
+        };
+        return {
+            success: true,
+            message,
+            data,
+        };
+    }
+    /**
+     * Format port release response (common pattern)
+     */
+    static portRelease(count, target) {
+        const message = count > 0
+            ? `✅ Released ${count} port(s)${target ? ` for ${target}` : ''}`
+            : `⚠️  No ports found${target ? ` for ${target}` : ''}`;
+        return {
+            success: count > 0,
+            message,
+            data: { releasedCount: count },
+        };
+    }
+}
+//# sourceMappingURL=response-formatter.js.map

package/dist/services/response-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-formatter.js","sourceRoot":"","sources":["../../src/services/response-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,MAAM,OAAO,iBAAiB;IAC5B;;;OAGG;IACH,MAAM,CAAC,MAAM,CACX,QAAsB,EACtB,UAA2B,EAAE;QAE7B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,+CAA+C;YAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,IAAI;gBAChC,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,OAAO,EAAE,QAAQ,CAAC,OAAO;aAC1B,CAAC;YACF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,oCAAoC;YACpC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,2CAA2C;QAC3C,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAe,EAAE,IAAc;QAC5C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,OAAe,EAAE,IAAc;QAC1C,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAa,EAAE,OAAgB;QACzC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,OAAO;SACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAsB,EAAE,IAAc;QACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,IAAY,EACZ,OAAe,EACf,OAAe,EACf,IAAa;QAEb,MAAM,OAAO,GAAG,oBAAoB,IAAI,QAAQ,OAAO,IAAI,OAAO,EAAE,CAAC;QACrE,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,OAAO;YACP,OAAO;YACP,IAAI;YACJ,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACtC,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,IAAI;SACL,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAa,EAAE,MAAe;QAC/C,MAAM,OAAO,GACX,KAAK,GAAG,CAAC;YACP,CAAC,CAAC,cAAc,KAAK,WAAW,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAChE,CAAC,CAAC,qBAAqB,MAAM,CAAC,CAAC,CAAC,QAAQ,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAE5D,OAAO;YACL,OAAO,EAAE,KAAK,GAAG,CAAC;YAClB,OAAO;YACP,IAAI,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE;SAC/B,CAAC;IACJ,CAAC;CACF"}

package/dist/services/validation-service.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Consolidated validation service - eliminates duplication in validation logic
+ * Implements configurable validation patterns for DRY compliance
+ */
+export declare class ValidationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Configuration for string validation
+ */
+export interface StringValidationConfig {
+    name: string;
+    maxLength?: number;
+    minLength?: number;
+    pattern?: RegExp;
+    disallowedPrefixes?: string[];
+    required?: boolean;
+    customErrorMessage?: string;
+}
+/**
+ * Configuration for path validation
+ */
+export interface PathValidationConfig {
+    name: string;
+    mustExist?: boolean;
+    allowRelative?: boolean;
+    allowedExtensions?: string[];
+    maxLength?: number;
+    customErrorMessage?: string;
+}
+/**
+ * Configuration for numeric validation
+ */
+export interface NumericValidationConfig {
+    name: string;
+    min?: number;
+    max?: number;
+    integer?: boolean;
+    required?: boolean;
+    customErrorMessage?: string;
+}
+/**
+ * Common validation patterns
+ */
+export declare const ValidationPatterns: {
+    readonly PROJECT_SERVICE: RegExp;
+    readonly BRANCH_NAME: RegExp;
+    readonly SAFE_PATH: RegExp;
+    readonly SHELL_DANGEROUS: RegExp;
+};
+/**
+ * Predefined validation configurations for common use cases
+ */
+export declare const ValidationConfigs: {
+    readonly PROJECT_NAME: StringValidationConfig;
+    readonly SERVICE_NAME: StringValidationConfig;
+    readonly BRANCH_NAME: StringValidationConfig;
+    readonly PORT_NUMBER: NumericValidationConfig;
+    readonly TEMPLATE_PATH: PathValidationConfig;
+    readonly WORKTREE_PATH: PathValidationConfig;
+    readonly OUTPUT_PATH: PathValidationConfig;
+};
+/**
+ * Centralized validation service with configurable validators
+ */
+export declare class ValidationService {
+    /**
+     * Validate a string value with configurable rules
+     */
+    static validateString(value: string, config: StringValidationConfig): string;
+    /**
+     * Validate a numeric value with configurable rules
+     */
+    static validateNumber(value: string | number, config: NumericValidationConfig): number;
+    /**
+     * Validate a path with configurable rules
+     */
+    static validatePath(value: string, config: PathValidationConfig): string;
+    /**
+     * Convenience methods using predefined configurations
+     */
+    static validateProjectName(value: string): string;
+    static validateServiceName(value: string): string;
+    static validateBranchName(value: string): string;
+    static validatePort(value: string | number): number;
+    static validateTemplatePath(value: string): string;
+    static validateWorktreePath(value: string): string;
+    static validateOutputPath(value: string): string;
+    /**
+     * Validate service type against allowed types
+     */
+    static validateServiceType(type: string): string;
+    /**
+     * Validate script file path for post-hooks and similar
+     */
+    static validateScriptPath(path: string): string;
+    /**
+     * Validate an array of service definitions in "service" or "service:type" format
+     */
+    static validateServices(services: string[]): Array<{
+        service: string;
+        type: string;
+    }>;
+    /**
+     * Sanitize string for safe display/logging, removing dangerous characters
+     */
+    static sanitizeForDisplay(input: string, maxLength?: number): string;
+}
+//# sourceMappingURL=validation-service.d.ts.map

package/dist/services/validation-service.d.ts.map

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