@edgible-team/cli 1.0.1 → 1.0.2

package/dist/types/validation/schemas.js

@@ -2,7 +2,7 @@
 // AUTO-GENERATED FILE - DO NOT EDIT
 // This file is copied from backend during build. Changes will be overwritten.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GetResourceSchema = exports.UpdateResourceSchema = exports.CreateResourceSchema = exports.CreateDeviceWithOrphanedOrganizationSchema = exports.GetChallengeSessionSchema = exports.ForceChangePasswordSchema = exports.RefreshTokenSchema = exports.AuthenticateSchema = exports.LinkOrganizationSchema = exports.UpdateResourceLimitsSchema = exports.CreateBillingOrganizationSchema = exports.AdoptOrganizationSchema = exports.CancelInviteSchema = exports.DeclineInviteSchema = exports.AcceptInviteSchema = exports.CreateOrganizationInviteSchema = exports.GetDeviceSchema = exports.UpdateDeviceSchema = exports.CreateDeviceSchema = exports.RefreshCertificatePathSchema = exports.GetCertificatePathSchema = exports.GetCertificatesPathSchema = exports.GetApplicationSchema = exports.UpdateApplicationSchema = exports.CreateApplicationSchema = exports.GetUserSchema = exports.UpdateUserSchema = exports.CreateUserSchema = exports.GetOrganizationSchema = exports.UpdateOrganizationSchema = exports.CreateOrganizationSchema = void 0;
+exports.CreateLifecycleEventSchema = exports.PostDevicePoolTrafficSchema = exports.CheckApplicationReachabilitySchema = exports.GetResourceSchema = exports.UpdateResourceSchema = exports.CreateResourceSchema = exports.CreateDeviceWithOrphanedOrganizationSchema = exports.GetChallengeSessionSchema = exports.ForceChangePasswordSchema = exports.RefreshTokenSchema = exports.AuthenticateSchema = exports.LinkOrganizationSchema = exports.UpdateResourceLimitsSchema = exports.CreateBillingOrganizationSchema = exports.AdoptOrganizationSchema = exports.CancelInviteSchema = exports.DeclineInviteSchema = exports.AcceptInviteSchema = exports.CreateOrganizationInviteSchema = exports.GetDeviceSchema = exports.UpdateDeviceSchema = exports.CreateDeviceSchema = exports.RefreshCertificatePathSchema = exports.GetCertificatePathSchema = exports.GetCertificatesPathSchema = exports.GetApplicationSchema = exports.UpdateApplicationSchema = exports.CreateApplicationSchema = exports.GetUserSchema = exports.UpdateUserSchema = exports.CreateUserSchema = exports.GetOrganizationSchema = exports.UpdateOrganizationSchema = exports.CreateOrganizationSchema = void 0;
 const zod_1 = require("zod");
 // Organization validation schemas
 exports.CreateOrganizationSchema = zod_1.z.object({
@@ -39,10 +39,17 @@ exports.CreateApplicationSchema = zod_1.z.object({
     name: zod_1.z.string().min(1, 'Name is required').max(100, 'Name must be 100 characters or less'),
     description: zod_1.z.string().max(500).optional(),
     organizationId: zod_1.z.string().min(1, 'Organization ID is required'),
-    environment: zod_1.z.enum(['development', 'staging', 'production']).default('development'),
+    environment: zod_1.z.enum(['development', 'staging', 'prod']).default('development'),
     configuration: zod_1.z.object({
         port: zod_1.z.number().int().min(1).max(65535, 'Port must be between 1 and 65535'),
         protocol: zod_1.z.enum(['http', 'https', 'tcp', 'udp']),
+        command: zod_1.z.string().optional(),
+        workingDirectory: zod_1.z.string().optional(),
+        env: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional(),
+        logFile: zod_1.z.string().optional(),
+        healthCheckPath: zod_1.z.string().optional(),
+        dockerComposePath: zod_1.z.string().optional(),
+        systemdService: zod_1.z.string().optional(),
     }),
     hostnames: zod_1.z
         .array(zod_1.z
@@ -52,12 +59,15 @@ exports.CreateApplicationSchema = zod_1.z.object({
     deviceIds: zod_1.z.array(zod_1.z.string().min(1)).min(1, 'At least one device ID is required'),
     gatewayIds: zod_1.z.array(zod_1.z.string().min(1)).optional(),
     useManagedGateway: zod_1.z.boolean().optional(),
-    subtype: zod_1.z.enum(['local-preexisting', 'managed-docker', 'systemd', 'docker-compose']),
+    subtype: zod_1.z.enum(['local-preexisting', 'managed-docker', 'systemd', 'docker-compose', 'managed-process']),
 });
+// IP address or CIDR block validation
+const IPOrCIDRSchema = zod_1.z.string().regex(/^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)(?:\/(?:[0-9]|[1-2][0-9]|3[0-2]))?$/, 'Invalid IP address or CIDR block (e.g., 192.168.1.0/24 or 10.0.0.1)');
 exports.UpdateApplicationSchema = zod_1.z.object({
     name: zod_1.z.string().min(1).max(100).optional(),
     description: zod_1.z.string().max(500).optional(),
-    environment: zod_1.z.enum(['development', 'staging', 'production']).optional(),
+    environment: zod_1.z.enum(['development', 'staging', 'prod']).optional(),
+    allowedSourceIPs: zod_1.z.array(IPOrCIDRSchema).optional(),
 });
 exports.GetApplicationSchema = zod_1.z.object({
     applicationId: zod_1.z.string().min(1, 'Application ID is required'),
@@ -215,4 +225,36 @@ exports.UpdateResourceSchema = zod_1.z.object({
 exports.GetResourceSchema = zod_1.z.object({
     resourceId: zod_1.z.string().min(1, 'Resource ID is required'),
 });
+// Application reachability validation schemas
+exports.CheckApplicationReachabilitySchema = zod_1.z.object({
+    applicationId: zod_1.z.string().min(1, 'Application ID is required'),
+});
+// Device pool traffic validation schemas
+exports.PostDevicePoolTrafficSchema = zod_1.z.object({
+    ingressBytes: zod_1.z.number().nonnegative('ingressBytes must be non-negative'),
+    egressBytes: zod_1.z.number().nonnegative('egressBytes must be non-negative'),
+});
+// Lifecycle event validation schemas
+exports.CreateLifecycleEventSchema = zod_1.z.object({
+    eventType: zod_1.z.enum([
+        'application_ip_whitelist_updated',
+        'application_started',
+        'application_stopped',
+        'application_config_updated',
+        'device_config_updated',
+        'device_wireguard_config_updated'
+    ]),
+    organizationId: zod_1.z.string().min(1, 'Organization ID is required'),
+    applicationId: zod_1.z.string().min(1).optional(),
+    deviceId: zod_1.z.string().min(1).optional(),
+    eventAction: zod_1.z.string().min(1, 'Event action is required'),
+    message: zod_1.z.string().min(1, 'Message is required'),
+    metadata: zod_1.z.record(zod_1.z.string(), zod_1.z.unknown()).optional(),
+    source: zod_1.z.enum(['backend', 'agent']),
+    sourceDetails: zod_1.z.object({
+        deviceType: zod_1.z.enum(['gateway', 'serving']).optional(),
+        userId: zod_1.z.string().optional(),
+        requestId: zod_1.z.string().optional(),
+    }).optional(),
+});
 //# sourceMappingURL=schemas.js.map

package/dist/types/validation.d.ts

@@ -0,0 +1,68 @@
+import { AgentStatus } from './agent';
+import { ConnectivityReport } from './connectivity';
+import { LocalAgentHealthStatus } from './agent';
+export interface ApplicationSetupResult {
+    application: Application;
+    localAgentStatus: AgentStatus;
+    connectivityTest: ConnectivityReport;
+    healthValidation: LocalAgentHealthStatus;
+    setupComplete: boolean;
+    warnings: string[];
+    errors: string[];
+    duration: number;
+    timestamp: Date;
+}
+export interface ValidationResult {
+    success: boolean;
+    checks: ValidationCheck[];
+    overall: 'pass' | 'fail' | 'warn';
+    message?: string;
+    recommendations: string[];
+}
+export interface ValidationCheck {
+    name: string;
+    status: 'pass' | 'fail' | 'warn' | 'skip';
+    message?: string;
+    details?: any;
+    duration?: number;
+}
+export interface Application {
+    id: string;
+    name: string;
+    workloadId: string;
+    servingIp: string;
+    port: number;
+    protocol: string;
+    status: string;
+    createdAt: string;
+    description?: string;
+    gatewayId?: string;
+    localPort?: number;
+}
+export interface Workload {
+    id: string;
+    name: string;
+    type: string;
+    status: string;
+    image?: string;
+    ports?: PortMapping[];
+    ip?: string;
+    description?: string;
+}
+export interface PortMapping {
+    hostIp?: string;
+    hostPort?: number;
+    containerPort: number;
+    protocol: 'tcp' | 'udp';
+}
+export interface Gateway {
+    id: string;
+    name: string;
+    publicIp: string;
+    privateIp?: string;
+    region: string;
+    status: string;
+    deviceId: string;
+    ec2InstanceId?: string;
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,WAAW,CAAC;IACzB,gBAAgB,EAAE,WAAW,CAAC;IAC9B,gBAAgB,EAAE,kBAAkB,CAAC;IACrC,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,GAAG,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/utils/FileIntegrityManager.d.ts

@@ -0,0 +1,37 @@
+export interface FileIntegrityCheck {
+    isValid: boolean;
+    checksum: string;
+    size: number;
+    lastModified: number;
+    error?: string;
+}
+export declare class FileIntegrityManager {
+    /**
+     * Check file integrity with multiple validation methods
+     */
+    static checkFileIntegrity(filePath: string): Promise<FileIntegrityCheck>;
+    /**
+     * Safely read JSON file with integrity check
+     */
+    static readJsonFileSafely(filePath: string): Promise<{
+        data: any;
+        isValid: boolean;
+        error?: string;
+    }>;
+    /**
+     * Safely write JSON file with atomic operation
+     */
+    static writeJsonFileSafely(filePath: string, data: any): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Clean up corrupted files
+     */
+    static cleanupCorruptedFiles(directory: string): Promise<void>;
+    /**
+     * Create file lock to prevent concurrent access
+     */
+    static withFileLock<T>(filePath: string, operation: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=FileIntegrityManager.d.ts.map

package/dist/utils/FileIntegrityManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileIntegrityManager.d.ts","sourceRoot":"","sources":["../../src/utils/FileIntegrityManager.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,oBAAoB;IAC/B;;OAEG;WACU,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuE9E;;OAEG;WACU,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA6B3G;;OAEG;WACU,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA8C5G;;OAEG;WACU,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BpE;;OAEG;WACU,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAyCxF"}

package/dist/utils/PathMigration.d.ts

@@ -0,0 +1,45 @@
+/**
+ * PathMigration utility handles migration from legacy ~/.edgible paths
+ * to the new XDG/platform-specific paths.
+ */
+export declare class PathMigration {
+    /**
+     * Check if legacy paths exist
+     */
+    static hasLegacyPaths(): boolean;
+    /**
+     * Get the legacy config path
+     */
+    static getLegacyConfigPath(): string;
+    /**
+     * Get the legacy agent path
+     */
+    static getLegacyAgentPath(): string;
+    /**
+     * Migrate configuration from legacy paths to new paths
+     *
+     * @returns true if migration was successful or not needed, false if migration failed
+     */
+    static migrateConfig(): Promise<boolean>;
+    /**
+     * Migrate agent data from legacy paths to new paths
+     *
+     * @returns true if migration was successful or not needed, false if migration failed
+     */
+    static migrateAgentData(): Promise<boolean>;
+    /**
+     * Perform full migration from legacy paths to new paths
+     *
+     * @returns Migration result with details
+     */
+    static migrate(): Promise<{
+        success: boolean;
+        migrated: string[];
+        errors: string[];
+    }>;
+    /**
+     * Copy directory recursively
+     */
+    private static copyDirectory;
+}
+//# sourceMappingURL=PathMigration.d.ts.map

package/dist/utils/PathMigration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathMigration.d.ts","sourceRoot":"","sources":["../../src/utils/PathMigration.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,OAAO;IAKhC;;OAEG;IACH,MAAM,CAAC,mBAAmB,IAAI,MAAM;IAIpC;;OAEG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM;IAInC;;;;OAIG;WACU,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAkD9C;;;;OAIG;WACU,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IA+BjD;;;;OAIG;WACU,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAwC3F;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CA2B7B"}

package/dist/utils/PathResolver.d.ts

@@ -0,0 +1,76 @@
+/**
+ * PathResolver provides centralized path management following industry standards:
+ * - XDG Base Directory specification on Linux
+ * - Platform-specific conventions on macOS and Windows
+ * - Proper handling of sudo contexts (preserves real user)
+ */
+export declare class PathResolver {
+    /**
+     * Get the real user's home directory, even when running under sudo.
+     * Detects the actual user via SUDO_USER environment variable.
+     *
+     * @returns The real user's home directory path
+     */
+    static getRealUserHome(): string;
+    /**
+     * Get the user-level data directory for CLI configuration and data.
+     * Follows XDG Base Directory spec on Linux, platform conventions elsewhere.
+     *
+     * @returns The user data directory path
+     */
+    static getUserDataPath(): string;
+    /**
+     * Get the system-level data directory for agent services.
+     * Used when the agent runs as a system service (systemd, launchd, etc.)
+     *
+     * @returns The system data directory path
+     */
+    static getSystemDataPath(): string;
+    /**
+     * Get the agent configuration directory path.
+     * For CLI: returns user data path + '/agent'
+     * For system services: returns system data path + '/agent'
+     *
+     * @param useSystemPath - If true, use system path; otherwise use user path
+     * @returns The agent configuration directory path
+     */
+    static getAgentConfigPath(useSystemPath?: boolean): string;
+    /**
+     * Get the CLI configuration file path.
+     *
+     * @returns The CLI config.json file path
+     */
+    static getCliConfigPath(): string;
+    /**
+     * Get the agent configuration file path.
+     *
+     * @param useSystemPath - If true, use system path; otherwise use user path
+     * @returns The agent.config.json file path
+     */
+    static getAgentConfigFilePath(useSystemPath?: boolean): string;
+    /**
+     * Get the agent status file path.
+     *
+     * @param useSystemPath - If true, use system path; otherwise use user path
+     * @returns The status.json file path
+     */
+    static getAgentStatusPath(useSystemPath?: boolean): string;
+    /**
+     * Resolve the agent config path based on installation type.
+     * For systemd/launchd/windows-service: uses system path
+     * For docker/podman: uses system path (mounted in container)
+     * Otherwise: uses user path
+     *
+     * @param installationType - The agent installation type
+     * @returns The appropriate agent config path
+     */
+    static resolveAgentConfigPath(installationType?: string): string;
+    /**
+     * Resolve the agent config file path based on installation type.
+     *
+     * @param installationType - The agent installation type
+     * @returns The appropriate agent config file path
+     */
+    static resolveAgentConfigFilePath(installationType?: string): string;
+}
+//# sourceMappingURL=PathResolver.d.ts.map

package/dist/utils/PathResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathResolver.d.ts","sourceRoot":"","sources":["../../src/utils/PathResolver.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;IAkDhC;;;;;OAKG;IACH,MAAM,CAAC,eAAe,IAAI,MAAM;IAyBhC;;;;;OAKG;IACH,MAAM,CAAC,iBAAiB,IAAI,MAAM;IAmBlC;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAa,GAAE,OAAe,GAAG,MAAM;IAKjE;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,IAAI,MAAM;IAKjC;;;;;OAKG;IACH,MAAM,CAAC,sBAAsB,CAAC,aAAa,GAAE,OAAe,GAAG,MAAM;IAKrE;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,aAAa,GAAE,OAAe,GAAG,MAAM;IAKjE;;;;;;;;OAQG;IACH,MAAM,CAAC,sBAAsB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;IAShE;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM;CAQrE"}

package/dist/utils/PlatformDetector.d.ts

@@ -0,0 +1,60 @@
+export type Platform = 'linux' | 'darwin' | 'win32';
+export type InstallationType = 'systemd' | 'launchd' | 'windows-service' | 'docker' | 'podman';
+export interface InstallOption {
+    type: InstallationType;
+    name: string;
+    description: string;
+    requires: string[];
+    pros: string[];
+    cons: string[];
+    bestFor: string;
+    available: boolean;
+    requiresRoot: boolean;
+}
+export declare class PlatformDetector {
+    /**
+     * Get the current platform
+     */
+    static getPlatform(): Platform;
+    /**
+     * Check if running as root/administrator
+     */
+    static isRoot(): Promise<boolean>;
+    /**
+     * Check if systemd is available (Linux)
+     */
+    static hasSystemd(): Promise<boolean>;
+    /**
+     * Check if launchd is available (macOS)
+     */
+    static hasLaunchd(): Promise<boolean>;
+    /**
+     * Check if Docker is available
+     */
+    static hasDocker(): Promise<boolean>;
+    /**
+     * Check if Podman is available
+     */
+    static hasPodman(): Promise<boolean>;
+    /**
+     * Check if Node.js is available
+     */
+    static hasNode(): Promise<boolean>;
+    /**
+     * Get the path to Node.js executable
+     */
+    static getNodePath(): Promise<string>;
+    /**
+     * Get all available installation options for the current platform
+     */
+    static getAvailableOptions(): Promise<InstallOption[]>;
+    /**
+     * Get the recommended installation type for the current platform
+     */
+    static getRecommendedType(): Promise<InstallationType | null>;
+    /**
+     * Get installation requirements message for when not running as root
+     */
+    static getRootRequirementMessage(): string;
+}
+//# sourceMappingURL=PlatformDetector.d.ts.map

package/dist/utils/PlatformDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlatformDetector.d.ts","sourceRoot":"","sources":["../../src/utils/PlatformDetector.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,QAAQ;IAO9B;;OAEG;WACU,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAiBvC;;OAEG;WACU,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAa3C;;OAEG;WACU,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAW3C;;OAEG;WACU,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAW1C;;OAEG;WACU,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAS1C;;OAEG;WACU,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IASxC;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAY3C;;OAEG;WACU,mBAAmB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAoF5D;;OAEG;WACU,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAmCnE;;OAEG;IACH,MAAM,CAAC,yBAAyB,IAAI,MAAM;CAS3C"}

package/dist/utils/console-logger.d.ts

@@ -0,0 +1,37 @@
+import { Logger, LogLevel } from './logger';
+/**
+ * Console logger implementation
+ * Formats and outputs logs to console with colors and formatting
+ */
+export declare class ConsoleLogger implements Logger {
+    private level;
+    private colorEnabled;
+    private plain;
+    constructor(options?: {
+        level?: LogLevel;
+        colorEnabled?: boolean;
+        plain?: boolean;
+    });
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+    setColorEnabled(enabled: boolean): void;
+    setPlain(plain: boolean): void;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    private shouldLog;
+    private log;
+    private logPlain;
+    private logFormatted;
+    private getPrefix;
+}
+/**
+ * Get or create default logger instance
+ */
+export declare function getLogger(): Logger;
+/**
+ * Set default logger instance (useful for testing)
+ */
+export declare function setLogger(logger: Logger): void;
+//# sourceMappingURL=console-logger.d.ts.map

package/dist/utils/console-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.d.ts","sourceRoot":"","sources":["../../src/utils/console-logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAA6B,MAAM,UAAU,CAAC;AAEvE;;;GAGG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,KAAK,CAAkB;gBAEnB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO;IAMvF,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,QAAQ,IAAI,QAAQ;IAIpB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIvC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAI9B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,GAAG;IAeX,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,SAAS;CAkBlB;AAOD;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAKlC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9C"}

package/dist/utils/docker-compose-parser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Utility to parse docker-compose.yml files and extract container/port information
+ */
+export interface ContainerPort {
+    host: number;
+    container: number;
+    protocol: string;
+}
+export interface ContainerInfo {
+    name: string;
+    ports: ContainerPort[];
+}
+export interface DockerComposeParseResult {
+    containers: ContainerInfo[];
+}
+/**
+ * Parse a docker-compose file and extract container and port information
+ * @param filePath Path to the docker-compose.yml or docker-compose.yaml file
+ * @returns Structured data containing containers and their ports
+ */
+export declare function parseDockerComposeFile(filePath: string): DockerComposeParseResult;
+/**
+ * Find docker-compose file in the current directory or specified path
+ * @param providedPath Optional path provided by user
+ * @returns Path to docker-compose file or null if not found
+ */
+export declare function findDockerComposeFile(providedPath?: string): string | null;
+//# sourceMappingURL=docker-compose-parser.d.ts.map

package/dist/utils/docker-compose-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-compose-parser.d.ts","sourceRoot":"","sources":["../../src/utils/docker-compose-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CA4EjF;AA6CD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAqB1E"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Exit codes following Unix conventions
+ */
+export declare enum ExitCode {
+    SUCCESS = 0,
+    ERROR = 1,
+    USAGE_ERROR = 2,
+    CONFIG_ERROR = 3,
+    NETWORK_ERROR = 4
+}
+/**
+ * CLI Error classes for better error handling
+ */
+export declare class CLIError extends Error {
+    readonly exitCode: ExitCode;
+    readonly showHelp: boolean;
+    constructor(message: string, exitCode?: ExitCode, showHelp?: boolean);
+}
+export declare class ValidationError extends CLIError {
+    constructor(message: string);
+}
+export declare class ConfigError extends CLIError {
+    constructor(message: string);
+}
+export declare class NetworkError extends CLIError {
+    constructor(message: string);
+}
+/**
+ * Centralized error handler with consistent output
+ */
+export declare class ErrorHandler {
+    private static colorEnabled;
+    /**
+     * Configure color output
+     */
+    static setColorEnabled(enabled: boolean): void;
+    /**
+     * Handle and display error with consistent format
+     */
+    static handleError(error: unknown): void;
+    /**
+     * Display validation error
+     */
+    static handleValidationError(message: string): void;
+    /**
+     * Display network error
+     */
+    static handleNetworkError(message: string): void;
+    /**
+     * Display configuration error
+     */
+    static handleConfigError(message: string): void;
+}
+/**
+ * Wrapper for async command handlers with error handling
+ */
+export declare function withErrorHandling<T extends any[]>(handler: (...args: T) => Promise<void>): (...args: T) => Promise<void>;
+/**
+ * Wrap a command action with standardized error handling
+ * Use this for all command actions to ensure consistent error handling
+ */
+export declare function wrapCommandAction<T extends any[]>(action: (...args: T) => Promise<void>): (...args: T) => Promise<void>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,oBAAY,QAAQ;IAClB,OAAO,IAAI;IACX,KAAK,IAAI;IACT,WAAW,IAAI;IACf,YAAY,IAAI;IAChB,aAAa,IAAI;CAClB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,QAAQ;aAClB,QAAQ,EAAE,OAAO;gBAFjC,OAAO,EAAE,MAAM,EACC,QAAQ,GAAE,QAAyB,EACnC,QAAQ,GAAE,OAAe;CAK5C;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,YAAa,SAAQ,QAAQ;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,YAAY,CAA6C;IAExE;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI9C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAkBxC;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKnD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMhD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAKhD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,EAC/C,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GACrC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAQ/B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,GAAG,EAAE,EAC/C,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GACpC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAE/B"}

package/dist/utils/health-checker.d.ts

@@ -0,0 +1,34 @@
+import { HttpTestResult, TestOptions } from '../types/connectivity';
+import { HealthCheckConfig } from '../types/agent';
+export declare class HealthChecker {
+    /**
+     * Perform HTTP health check
+     */
+    static checkHttpHealth(url: string, config: HealthCheckConfig, options?: TestOptions): Promise<HttpTestResult>;
+    /**
+     * Evaluate HTTP response for health check
+     */
+    private static evaluateHealthResponse;
+    /**
+     * Generate error message for failed health check
+     */
+    private static generateHealthErrorMessage;
+    /**
+     * Perform multiple health checks with retries
+     */
+    static performHealthChecks(url: string, config: HealthCheckConfig, options?: TestOptions): Promise<HttpTestResult[]>;
+    /**
+     * Check if a service is responding to basic connectivity
+     */
+    static checkBasicConnectivity(host: string, port: number, protocol?: 'http' | 'https'): Promise<boolean>;
+    /**
+     * Generate health check summary
+     */
+    static generateHealthSummary(results: HttpTestResult[]): {
+        overall: boolean;
+        successRate: number;
+        averageResponseTime: number;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=health-checker.d.ts.map

package/dist/utils/health-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-checker.d.ts","sourceRoot":"","sources":["../../src/utils/health-checker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,qBAAa,aAAa;IACxB;;OAEG;WACU,eAAe,CAC1B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,cAAc,CAAC;IAqD1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA4BrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IA0BzC;;OAEG;WACU,mBAAmB,CAC9B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,iBAAiB,EACzB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,cAAc,EAAE,CAAC;IAqB5B;;OAEG;WACU,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,GAAG,OAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;IAUtH;;OAEG;IACH,MAAM,CAAC,qBAAqB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG;QACvD,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB;CAeF"}

package/dist/utils/json-logger.d.ts

@@ -0,0 +1,23 @@
+import { Logger, LogLevel } from './logger';
+/**
+ * JSON logger implementation for scripting and automation
+ * Outputs structured JSON logs that can be easily parsed
+ */
+export declare class JsonLogger implements Logger {
+    private level;
+    private outputStream;
+    constructor(options?: {
+        level?: LogLevel;
+        outputStream?: NodeJS.WriteStream;
+    });
+    setLevel(level: LogLevel): void;
+    getLevel(): LogLevel;
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    private shouldLog;
+    private log;
+    private getLevelName;
+}
+//# sourceMappingURL=json-logger.d.ts.map

package/dist/utils/json-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-logger.d.ts","sourceRoot":"","sources":["../../src/utils/json-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAE5C;;;GAGG;AACH,qBAAa,UAAW,YAAW,MAAM;IACvC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAqB;gBAE7B,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC,WAAW,CAAA;KAAO;IAKjF,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,QAAQ,IAAI,QAAQ;IAIpB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAM/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI;IAMhD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,GAAG;IAYX,OAAO,CAAC,YAAY;CAgBrB"}