/**
 * Connection Context Interface
 * 
 * Allows MCP tools to specify project-specific connection context
 * that should be used instead of default install path connections.
 * 
 * Passed from MCP tool parameters through to CLI execution.
 */

export interface ConnectionContext {
  /**
   * Absolute path to the project directory
   * If provided, CLI will execute from this directory
   * and look for connection files here first
   * 
   * @example "/home/user/projects/my-cap-app"
   */
  projectPath?: string;

  /**
   * Connection file name relative to projectPath
   * e.g., ".env", "default-env.json"
   * 
   * If provided along with projectPath, CLI will use this specific file
   * 
   * @example ".env" or "default-env.json"
   */
  connectionFile?: string;

  /**
   * Direct database connection - host
   * Use only when explicit credentials are available
   * 
   * @example "database.example.com" or "localhost"
   */
  host?: string;

  /**
   * Direct database connection - port
   * Default is 30013 for HANA
   * 
   * @example 30013
   */
  port?: number;

  /**
   * Direct database connection - user
   * Use only when explicit credentials are available
   * 
   * @example "DBADMIN"
   */
  user?: string;

  /**
   * Direct database connection - password
   * Use cautiously - prefer file-based credentials via connectionFile
   * 
   * ⚠️ SECURITY: Never pass passwords in parameters if possible
   * Prefer connection files (.env, default-env.json) instead
   * 
   * @example "MyPassword123"
   */
  password?: string;

  /**
   * Direct database connection - database name
   * Default is "SYSTEMDB"
   * 
   * @example "SYSTEMDB"
   */
  database?: string;
}