canvaslms-cli 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -5,10 +5,64 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [1.1.0] - 2025-07-03
+## [1.2.0] - 2025-07-05
+
+### Added
+
+- **Enhanced File Selection UX**: Implemented continuous file selection until empty input
+  - Browse current directory with file size display
+  - Add multiple files one by one
+  - Remove files from selection
+  - Show currently selected files
+  - Smart file filtering (excludes hidden files, package files)
+
+- **Improved Grade Viewing**:
+  - Interactive course selection for grade viewing
+  - Assignment-level grade details with color coding
+  - Overall course grade summary
+  - Better grade formatting and status indicators
+  - Support for letter grades, excused, and missing assignments
+
+- **Enhanced Display Names**:
+  - Show course names instead of IDs in all commands
+  - Display assignment names prominently
+  - Better labeling of IDs vs names throughout interface
+
+- **Interactive Utilities**:
+  - Added validation and retry logic for user input
+  - Confirmation helpers with default values
+  - List selection utilities with cancel option
+
+### Improved
+
+- **Submit Command**: Complete redesign with better file selection workflow
+- **Grades Command**: Interactive course selection and detailed assignment grades
+- **Assignments Command**: Display course names prominently
+- **Announcements Command**: Show course names instead of IDs
+- **User Experience**: More consistent and intuitive interfaces across all commands
+
+### Technical
+
+- Enhanced interactive utilities in `lib/interactive.js`
+- Better error handling and user guidance
+- Improved code organization and modularity
+
+## [1.1.1] - 2025-07-03
+
+### Fixed
+
+- Removed dotenv dependency that was causing module not found errors
+- Fixed configuration file path to use `.canvaslms-cli-config.json`
+- Resolved package publishing and global installation issues
 
 ### Added
 
+- Dual binary support: both `canvaslms-cli` and `canvas` commands work
+
+## [1.1.0] - 2025-07-03
+
+### Major Changes
+
 - Home directory configuration system (~/.canvaslms-cli-config.json)
 - Interactive configuration setup wizard (`canvas config setup`)
 - Configuration management subcommands:

package/commands/announcements.js

@@ -7,6 +7,9 @@ const { makeCanvasRequest } = require('../lib/api-client');
 async function showAnnouncements(courseId, options) {
   try {
     if (courseId) {
+      // Get course information first
+      const course = await makeCanvasRequest('get', `courses/${courseId}`);
+      
       // Get announcements for specific course
       const announcements = await makeCanvasRequest('get', `courses/${courseId}/discussion_topics`, [
         'only_announcements=true',
@@ -14,11 +17,11 @@ async function showAnnouncements(courseId, options) {
       ]);
       
       if (!announcements || announcements.length === 0) {
-        console.log('No announcements found for this course.');
+        console.log(`No announcements found for course: ${course.name}`);
         return;
       }
       
-      console.log(`Recent ${announcements.length} announcement(s) for course ${courseId}:\n`);
+      console.log(`📢 Recent ${announcements.length} announcement(s) for: ${course.name}\n`);
       
       announcements.forEach((announcement, index) => {
         console.log(`${index + 1}. ${announcement.title}`);

package/commands/assignments.js

@@ -6,12 +6,15 @@ const { makeCanvasRequest } = require('../lib/api-client');
 
 async function listAssignments(courseId, options) {
   try {
+    // First get course information to display course name
+    const course = await makeCanvasRequest('get', `courses/${courseId}`);
+    
     const queryParams = ['include[]=submission', 'include[]=score_statistics', 'per_page=100'];
     
     const assignments = await makeCanvasRequest('get', `courses/${courseId}/assignments`, queryParams);
     
     if (!assignments || assignments.length === 0) {
-      console.log('No assignments found for this course.');
+      console.log(`No assignments found for course: ${course.name}`);
       return;
     }
     
@@ -23,7 +26,9 @@ async function listAssignments(courseId, options) {
       filteredAssignments = assignments.filter(a => !a.submission || !a.submission.submitted_at);
     }
     
-    console.log(`Found ${filteredAssignments.length} assignment(s):\n`);
+    // Display course information prominently
+    console.log(`📚 Course: ${course.name}`);
+    console.log(`📝 Found ${filteredAssignments.length} assignment(s):\n`);
     
     filteredAssignments.forEach((assignment, index) => {
       const submission = assignment.submission;
@@ -67,9 +72,8 @@ async function listAssignments(courseId, options) {
       if (submission && submission.grade && isNaN(submission.grade)) {
         gradeDisplay = submission.grade + (assignment.points_possible ? ` (${gradeDisplay})` : '');
       }
-      
-      console.log(`${index + 1}. ${submissionStatus} ${assignment.name}`);
-      console.log(`   ID: ${assignment.id}`);
+        console.log(`${index + 1}. ${submissionStatus} ${assignment.name}`);
+      console.log(`   Assignment ID: ${assignment.id}`);
       console.log(`   Grade: ${gradeColor}${gradeDisplay} pts\x1b[0m`);
       console.log(`   Due: ${assignment.due_at ? new Date(assignment.due_at).toLocaleString() : 'No due date'}`);
       

package/commands/grades.js

@@ -3,63 +3,200 @@
  */
 
 const { makeCanvasRequest } = require('../lib/api-client');
+const { createReadlineInterface, askQuestion } = require('../lib/interactive');
 
 async function showGrades(courseId, options) {
+  const rl = createReadlineInterface();
+  
   try {
     if (courseId) {
-      // Get grades for specific course
-      const enrollments = await makeCanvasRequest('get', `courses/${courseId}/enrollments`, ['user_id=self', 'include[]=grades']);
-      
-      if (!enrollments || enrollments.length === 0) {
-        console.log('No enrollment found for this course.');
-        return;
-      }
-      
-      const enrollment = enrollments[0];
-      console.log(`Grades for course: ${enrollment.course_id}`);
-      console.log(`Current Score: ${enrollment.grades?.current_score || 'N/A'}%`);
-      console.log(`Final Score: ${enrollment.grades?.final_score || 'N/A'}%`);
-      console.log(`Current Grade: ${enrollment.grades?.current_grade || 'N/A'}`);
-      console.log(`Final Grade: ${enrollment.grades?.final_grade || 'N/A'}`);
+      // Get grades for specific course with assignment details
+      await showCourseGrades(courseId, options, rl);
     } else {
-      // Get grades for all courses
-      const courses = await makeCanvasRequest('get', 'courses', [
-        'enrollment_state=active', 
-        'include[]=enrollments',
-        'include[]=total_scores'
-      ]);
+      // Interactive course selection for grades
+      await showInteractiveGrades(options, rl);
+    }
+    
+  } catch (error) {
+    console.error('Error fetching grades:', error.message);
+    process.exit(1);
+  } finally {
+    rl.close();
+  }
+}
+
+async function showCourseGrades(courseId, options, rl) {
+  // Get course details
+  const course = await makeCanvasRequest('get', `courses/${courseId}`);
+  
+  // Get overall enrollment grades
+  const enrollments = await makeCanvasRequest('get', `courses/${courseId}/enrollments`, [
+    'user_id=self', 
+    'include[]=grades'
+  ]);
+  
+  if (!enrollments || enrollments.length === 0) {
+    console.log('No enrollment found for this course.');
+    return;
+  }
+  
+  const enrollment = enrollments[0];
+  
+  console.log(`\n📚 Grades for: ${course.name}`);
+  console.log(`📊 Course Overview:`);
+  console.log(`   Current Score: ${enrollment.grades?.current_score || 'N/A'}%`);
+  console.log(`   Final Score: ${enrollment.grades?.final_score || 'N/A'}%`);
+  console.log(`   Current Grade: ${enrollment.grades?.current_grade || 'N/A'}`);
+  console.log(`   Final Grade: ${enrollment.grades?.final_grade || 'N/A'}`);
+  
+  // Get assignment grades
+  console.log('\n📝 Loading assignment grades...');
+  const assignments = await makeCanvasRequest('get', `courses/${courseId}/assignments`, [
+    'include[]=submission',
+    'order_by=due_at',
+    'per_page=100'
+  ]);
+  
+  if (!assignments || assignments.length === 0) {
+    console.log('No assignments found for this course.');
+    return;
+  }
+  
+  // Filter assignments with grades
+  const gradedAssignments = assignments.filter(assignment => {
+    const submission = assignment.submission;
+    return submission && (
+      submission.score !== null || 
+      submission.excused || 
+      submission.missing ||
+      submission.grade
+    );
+  });
+  
+  if (gradedAssignments.length === 0) {
+    console.log('No graded assignments found.');
+    return;
+  }
+  
+  console.log(`\n📋 Assignment Grades (${gradedAssignments.length} graded):`);
+  gradedAssignments.forEach((assignment, index) => {
+    const submission = assignment.submission;
+    let gradeDisplay = '';
+    let gradeColor = '';
+    
+    if (submission.score !== null && submission.score !== undefined) {
+      const score = submission.score % 1 === 0 ? Math.round(submission.score) : submission.score;
+      const total = assignment.points_possible || 0;
+      gradeDisplay = `${score}/${total} pts`;
       
-      if (!courses || courses.length === 0) {
-        console.log('No courses found.');
-        return;
+      // Color coding based on percentage
+      if (total > 0) {
+        const percentage = (submission.score / total) * 100;
+        if (percentage >= 90) gradeColor = '\x1b[32m'; // Green
+        else if (percentage >= 80) gradeColor = '\x1b[36m'; // Cyan
+        else if (percentage >= 70) gradeColor = '\x1b[33m'; // Yellow
+        else if (percentage >= 60) gradeColor = '\x1b[35m'; // Magenta
+        else gradeColor = '\x1b[31m'; // Red
       }
       
-      console.log('Grades Summary:\n');
-      
-      courses.forEach((course, index) => {
-        console.log(`${index + 1}. ${course.name}`);
-        console.log(`   ID: ${course.id}`);
+      // Add letter grade if available
+      if (submission.grade && isNaN(submission.grade)) {
+        gradeDisplay = `${submission.grade} (${gradeDisplay})`;
+      }
+    } else if (submission.excused) {
+      gradeDisplay = 'Excused';
+      gradeColor = '\x1b[34m'; // Blue
+    } else if (submission.missing) {
+      gradeDisplay = 'Missing';
+      gradeColor = '\x1b[31m'; // Red
+    }
+    
+    console.log(`${index + 1}. ${assignment.name}`);
+    console.log(`   Grade: ${gradeColor}${gradeDisplay}\x1b[0m`);
+    
+    if (submission.submitted_at) {
+      console.log(`   Submitted: ${new Date(submission.submitted_at).toLocaleDateString()}`);
+    }
+    
+    if (assignment.due_at) {
+      console.log(`   Due: ${new Date(assignment.due_at).toLocaleDateString()}`);
+    }
+    
+    if (options.verbose && submission.grader_comments) {
+      console.log(`   Comments: ${submission.grader_comments}`);
+    }
+    
+    console.log('');
+  });
+}
+
+async function showInteractiveGrades(options, rl) {
+  // Get all courses with enrollment information
+  const courses = await makeCanvasRequest('get', 'courses', [
+    'enrollment_state=active',
+    'include[]=enrollments',
+    'include[]=favorites',
+    'include[]=total_scores'
+  ]);
+  
+  if (!courses || courses.length === 0) {
+    console.log('No courses found.');
+    return;
+  }
+  
+  // Show courses overview first
+  console.log('📊 Grades Overview:\n');
+  
+  const coursesWithGrades = courses.filter(course => 
+    course.enrollments && course.enrollments.length > 0
+  );
+  
+  console.log(`Found ${coursesWithGrades.length} enrolled course(s):\n`);
+  
+  coursesWithGrades.forEach((course, index) => {
+    const starIcon = course.is_favorite ? '⭐ ' : '';
+    console.log(`${index + 1}. ${starIcon}${course.name}`);
+    
+    if (course.enrollments && course.enrollments.length > 0) {
+      const enrollment = course.enrollments[0];
+      if (enrollment.grades) {
+        const currentScore = enrollment.grades.current_score;
+        const currentGrade = enrollment.grades.current_grade;
         
-        if (course.enrollments && course.enrollments.length > 0) {
-          const enrollment = course.enrollments[0];
-          if (enrollment.grades) {
-            console.log(`   Current Score: ${enrollment.grades.current_score || 'N/A'}%`);
-            console.log(`   Final Score: ${enrollment.grades.final_score || 'N/A'}%`);
-            console.log(`   Current Grade: ${enrollment.grades.current_grade || 'N/A'}`);
-          } else {
-            console.log(`   Grades: Not available`);
-          }
-        } else {
-          console.log(`   Enrollment: Not found`);
+        // Color code the grade
+        let gradeColor = '\x1b[90m'; // Gray default
+        if (currentScore !== null && currentScore !== undefined) {
+          if (currentScore >= 90) gradeColor = '\x1b[32m'; // Green
+          else if (currentScore >= 80) gradeColor = '\x1b[36m'; // Cyan
+          else if (currentScore >= 70) gradeColor = '\x1b[33m'; // Yellow
+          else if (currentScore >= 60) gradeColor = '\x1b[35m'; // Magenta
+          else gradeColor = '\x1b[31m'; // Red
         }
         
-        console.log('');
-      });
+        console.log(`   Current: ${gradeColor}${currentScore || 'N/A'}% (${currentGrade || 'N/A'})\x1b[0m`);
+      } else {
+        console.log(`   Current: \x1b[90mGrades not available\x1b[0m`);
+      }
     }
-    
-  } catch (error) {
-    console.error('Error fetching grades:', error.message);
-    process.exit(1);
+    console.log('');
+  });
+  
+  // Ask if user wants to see detailed grades for a specific course
+  const viewDetailed = await askQuestion(rl, 'View detailed grades for a specific course? (Y/n): ');
+  
+  if (viewDetailed.toLowerCase() === 'n' || viewDetailed.toLowerCase() === 'no') {
+    return;
+  }
+  
+  const courseChoice = await askQuestion(rl, '\nEnter course number for detailed grades: ');
+  const courseIndex = parseInt(courseChoice) - 1;
+  
+  if (courseIndex >= 0 && courseIndex < coursesWithGrades.length) {
+    const selectedCourse = coursesWithGrades[courseIndex];
+    console.log(`\n✅ Selected: ${selectedCourse.name}`);
+    await showCourseGrades(selectedCourse.id, options, rl);
+  } else {
+    console.log('Invalid course selection.');
   }
 }
 

package/commands/submit.js

@@ -15,6 +15,8 @@ async function submitAssignment(options) {
     let courseId = options.course;
     let assignmentId = options.assignment;
     let filePath = options.file;
+    let selectedCourse = null;
+    let selectedAssignment = null;
     
     // Step 1: Select Course (if not provided)
     if (!courseId) {
@@ -42,7 +44,7 @@ async function submitAssignment(options) {
       console.log('Select a course:');
       starredCourses.forEach((course, index) => {
         const starIcon = course.is_favorite ? '⭐ ' : '';
-        console.log(`${index + 1}. ${starIcon}${course.name} (ID: ${course.id})`);
+        console.log(`${index + 1}. ${starIcon}${course.name}`);
       });
       
       const courseChoice = await askQuestion(rl, '\nEnter course number: ');
@@ -54,8 +56,17 @@ async function submitAssignment(options) {
         return;
       }
       
-      courseId = starredCourses[courseIndex].id;
-      console.log(`Selected: ${starredCourses[courseIndex].name}\n`);
+      selectedCourse = starredCourses[courseIndex];
+      courseId = selectedCourse.id;
+      console.log(`✅ Selected: ${selectedCourse.name}\n`);
+    } else {
+      // Fetch course details if ID was provided
+      try {
+        selectedCourse = await makeCanvasRequest('get', `courses/${courseId}`);
+      } catch (error) {
+        console.log(`⚠️  Could not fetch course details for ID ${courseId}`);
+        selectedCourse = { id: courseId, name: `Course ${courseId}` };
+      }
     }
     
     // Step 2: Select Assignment (if not provided)
@@ -129,7 +140,7 @@ async function submitAssignment(options) {
         return;
       }
       
-      const selectedAssignment = assignments[assignmentIndex];
+      const      selectedAssignment = assignments[assignmentIndex];
       
       // Check if assignment accepts file uploads
       if (!selectedAssignment.submission_types || 
@@ -141,7 +152,7 @@ async function submitAssignment(options) {
       }
       
       assignmentId = selectedAssignment.id;
-      console.log(`Selected: ${selectedAssignment.name}\n`);
+      console.log(`✅ Selected: ${selectedAssignment.name}\n`);
       
       // Check if already submitted
       if (selectedAssignment.submission && selectedAssignment.submission.submitted_at) {
@@ -152,14 +163,21 @@ async function submitAssignment(options) {
           return;
         }
       }
+    } else {
+      // Fetch assignment details if ID was provided
+      try {
+        selectedAssignment = await makeCanvasRequest('get', `courses/${courseId}/assignments/${assignmentId}`);
+      } catch (error) {
+        console.log(`⚠️  Could not fetch assignment details for ID ${assignmentId}`);
+        selectedAssignment = { id: assignmentId, name: `Assignment ${assignmentId}` };
+      }
     }
-    
-    // Step 3: Select Files (if not provided)
+      // Step 3: Select Files (if not provided)
     let filePaths = [];
     if (filePath) {
       filePaths = [filePath]; // Single file provided via option
     } else {
-      filePaths = await selectFiles(rl);
+      filePaths = await selectFilesImproved(rl);
     }
     
     // Validate all selected files exist
@@ -179,16 +197,15 @@ async function submitAssignment(options) {
     }
     
     filePaths = validFiles;
-    
-    // Step 4: Confirm and Submit
+      // Step 4: Confirm and Submit
     console.log('\n📋 Submission Summary:');
-    console.log(`Course ID: ${courseId}`);
-    console.log(`Assignment ID: ${assignmentId}`);
-    console.log(`Files (${filePaths.length}):`);
+    console.log(`📚 Course: ${selectedCourse?.name || 'Unknown Course'}`);
+    console.log(`📝 Assignment: ${selectedAssignment?.name || 'Unknown Assignment'}`);
+    console.log(`📁 Files (${filePaths.length}):`);
     filePaths.forEach((file, index) => {
       const stats = fs.statSync(file);
       const size = (stats.size / 1024).toFixed(1) + ' KB';
-      console.log(`  ${index + 1}. ${file} (${size})`);
+      console.log(`  ${index + 1}. ${path.basename(file)} (${size})`);
     });
     
     const confirm = await askQuestion(rl, '\nProceed with submission? (Y/n): ');
@@ -361,6 +378,127 @@ async function selectSingleFileFromList(rl, files) {
   }
 }
 
+async function selectFilesImproved(rl) {
+  console.log('📁 Enhanced File Selection');
+  console.log('Choose files by entering their paths or browse current directory');
+  console.log('Press Enter with no input when done selecting files.\n');
+  
+  const allFiles = [];
+  let fileIndex = 1;
+  
+  while (true) {
+    console.log(`\n📎 File ${fileIndex} selection:`);
+    console.log('1. Enter file path directly');
+    console.log('2. Browse current directory');
+    console.log('3. Show currently selected files');
+    console.log('(Press Enter with no input to finish selection)');
+    
+    const choice = await askQuestion(rl, '\nChoose option (1-3 or Enter to finish): ');
+    
+    // Empty input means we're done selecting files
+    if (choice.trim() === '') {
+      if (allFiles.length === 0) {
+        console.log('⚠️  No files selected. Please select at least one file.');
+        continue;
+      }
+      break;
+    }
+    
+    if (choice === '1') {
+      // Direct file path entry
+      const filePath = await askQuestion(rl, 'Enter file path: ');
+      if (filePath.trim() !== '') {
+        if (fs.existsSync(filePath.trim())) {
+          if (!allFiles.includes(filePath.trim())) {
+            allFiles.push(filePath.trim());
+            const stats = fs.statSync(filePath.trim());
+            const size = (stats.size / 1024).toFixed(1) + ' KB';
+            console.log(`✅ Added: ${path.basename(filePath.trim())} (${size})`);
+            fileIndex++;
+          } else {
+            console.log('⚠️  File already selected.');
+          }
+        } else {
+          console.log('❌ File not found. Please check the path.');
+        }
+      }
+    } else if (choice === '2') {
+      // Browse current directory
+      try {
+        const files = fs.readdirSync('.').filter(file => {
+          const stats = fs.statSync(file);
+          return stats.isFile() && 
+                 !file.startsWith('.') &&
+                 !['package.json', 'package-lock.json', 'node_modules'].includes(file);
+        });
+        
+        if (files.length === 0) {
+          console.log('No suitable files found in current directory.');
+          continue;
+        }
+        
+        console.log('\n📂 Files in current directory:');
+        files.forEach((file, index) => {
+          const stats = fs.statSync(file);
+          const size = (stats.size / 1024).toFixed(1) + ' KB';
+          const alreadySelected = allFiles.includes(file) ? ' ✅' : '';
+          console.log(`${index + 1}. ${file} (${size})${alreadySelected}`);
+        });
+        
+        const fileChoice = await askQuestion(rl, '\nEnter file number (or Enter to go back): ');
+        if (fileChoice.trim() !== '') {
+          const fileIdx = parseInt(fileChoice) - 1;
+          if (fileIdx >= 0 && fileIdx < files.length) {
+            const selectedFile = files[fileIdx];
+            if (!allFiles.includes(selectedFile)) {
+              allFiles.push(selectedFile);
+              const stats = fs.statSync(selectedFile);
+              const size = (stats.size / 1024).toFixed(1) + ' KB';
+              console.log(`✅ Added: ${selectedFile} (${size})`);
+              fileIndex++;
+            } else {
+              console.log('⚠️  File already selected.');
+            }
+          } else {
+            console.log('❌ Invalid file number.');
+          }
+        }
+      } catch (error) {
+        console.log('❌ Error reading directory:', error.message);
+      }
+    } else if (choice === '3') {
+      // Show currently selected files
+      if (allFiles.length === 0) {
+        console.log('📋 No files selected yet.');
+      } else {
+        console.log(`\n📋 Currently selected files (${allFiles.length}):`);
+        allFiles.forEach((file, index) => {
+          const stats = fs.existsSync(file) ? fs.statSync(file) : null;
+          const size = stats ? (stats.size / 1024).toFixed(1) + ' KB' : 'File not found';
+          console.log(`  ${index + 1}. ${path.basename(file)} (${size})`);
+        });
+        
+        const removeFile = await askQuestion(rl, '\nRemove a file? Enter number or press Enter to continue: ');
+        if (removeFile.trim() !== '') {
+          const removeIdx = parseInt(removeFile) - 1;
+          if (removeIdx >= 0 && removeIdx < allFiles.length) {
+            const removedFile = allFiles.splice(removeIdx, 1)[0];
+            console.log(`🗑️  Removed: ${path.basename(removedFile)}`);
+            fileIndex--;
+          } else {
+            console.log('❌ Invalid file number.');
+          }
+        }
+      }
+    } else {
+      console.log('❌ Invalid option. Please choose 1, 2, 3, or press Enter to finish.');
+    }
+  }
+  
+  console.log(`\n✅ File selection complete! Selected ${allFiles.length} file(s).`);
+  return allFiles;
+}
+
 module.exports = {
   submitAssignment
 };

package/lib/interactive.js

@@ -25,7 +25,83 @@ function askQuestion(rl, question) {
   });
 }
 
+/**
+ * Ask a question with validation and retry logic
+ */
+function askQuestionWithValidation(rl, question, validator, errorMessage) {
+  return new Promise(async (resolve) => {
+    let answer;
+    do {
+      answer = await askQuestion(rl, question);
+      if (validator(answer)) {
+        resolve(answer.trim());
+        return;
+      } else {
+        console.log(errorMessage || 'Invalid input. Please try again.');
+      }
+    } while (true);
+  });
+}
+
+/**
+ * Ask for confirmation (Y/n format)
+ */
+async function askConfirmation(rl, question, defaultYes = true) {
+  const suffix = defaultYes ? ' (Y/n)' : ' (y/N)';
+  const answer = await askQuestion(rl, question + suffix + ': ');
+  
+  if (answer.trim() === '') {
+    return defaultYes;
+  }
+  
+  const lower = answer.toLowerCase();
+  return lower === 'y' || lower === 'yes';
+}
+
+/**
+ * Select from a list of options
+ */
+async function selectFromList(rl, items, displayProperty = null, allowCancel = true) {
+  if (!items || items.length === 0) {
+    console.log('No items to select from.');
+    return null;
+  }
+  
+  console.log('\nSelect an option:');
+  items.forEach((item, index) => {
+    const displayText = displayProperty ? item[displayProperty] : item;
+    console.log(`${index + 1}. ${displayText}`);
+  });
+  
+  if (allowCancel) {
+    console.log('0. Cancel');
+  }
+  
+  const validator = (input) => {
+    const num = parseInt(input);
+    return !isNaN(num) && num >= (allowCancel ? 0 : 1) && num <= items.length;
+  };
+  
+  const answer = await askQuestionWithValidation(
+    rl, 
+    '\nEnter your choice: ',
+    validator,
+    `Please enter a number between ${allowCancel ? '0' : '1'} and ${items.length}.`
+  );
+  
+  const choice = parseInt(answer);
+  
+  if (choice === 0 && allowCancel) {
+    return null;
+  }
+  
+  return items[choice - 1];
+}
+
 module.exports = {
   createReadlineInterface,
-  askQuestion
+  askQuestion,
+  askQuestionWithValidation,
+  askConfirmation,
+  selectFromList
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "canvaslms-cli",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "A command line tool for interacting with Canvas LMS API",
   "keywords": [
     "canvas",

package/src/index.js

@@ -26,7 +26,7 @@ const program = new Command();
 program
   .name('canvas')
   .description('Canvas API Command Line Tool')
-  .version('1.1.1');
+  .version('1.2.0');
 
 // Raw API commands
 function createQueryCommand(method) {