canvaslms-cli 1.6.4 → 1.6.5

package/CHANGELOG.md

@@ -1,221 +1,236 @@
-# Changelog
-
-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.6.4] - 2025-12-14
-
-### Changed
-
-- **Unified table rendering**: All commands (grades, list, assignments) now use the Table class with live resize support
-- **Grades command refactored**: Replaced 3 custom tables with Table class for consistent styling
-
-### Fixed
-
-- **ESLint warnings**: Fixed `no-constant-condition` and `no-control-regex` warnings in interactive.ts
-
-## [1.6.3] - 2025-12-14
-
-### Added (1.6.3)
-
-- **Live table resize**: Tables re-render automatically when terminal is resized
-- **Adaptive truncation**: Text truncation updates dynamically based on terminal width
-
-### Fixed (1.6.3)
-
-- **Submit table truncation**: Reduced excessive truncation in the submit table by compacting columns and shortening date format
-- **Table overflow**: Fixed tables overflowing terminal width on small screens
-- **Column width calculation**: Corrected border overhead calculation for accurate fitting
-
-### Changed (1.6.3)
-
-- **Submit table columns**: Optimized and tightened column widths for compact display (Assignment Name max width set to 35, Type fixed at 8, Due fixed at 16 with MM/DD/YYYY formatting, Status fixed at 12)
-
-## [1.6.2] - 2025-12-14
-
-- **Table display**: All table now have the same rounded corner format, text size adaptive to the terminal size
-
-## [1.6.1] - 2025-12-13
-
-- **Dry Run Mode**: Submit command now supports `--dry-run` flag to test submission flow without actually uploading files or submitting assignments
-- **Assignment URL Display**: After successful submission, the direct link to the assignment is now displayed for easy access
-
-## [1.6.0] - 2025-12-06
-
-### Added (1.6.0)
-
-- **Boxed Table Displays**: All commands now display data in modern boxed tables with rounded corners (╭╮╰╯)
-- **Adaptive Column Widths**: Tables dynamically adjust column widths based on terminal size for optimal display
-- **Color-Coded Grades**: Assignment grades are now color-coded (green: ≥80%, yellow: ≥50%, red: <50%)
-- **Announcements Table**: Course selection and announcements list now displayed in formatted tables
-- **Profile Table**: User profile information displayed in clean field/value table format
-
-### Changed (1.6.0)
-
-- **Grades Display**: Merged official grades and calculated statistics into a unified table
-- **CLI Descriptions**: Shortened command descriptions for cleaner help output
-- **Config Output**: Simplified config help by removing redundant command examples
-- **Submit Command**: Updated to use rounded corners and adaptive widths
-- **Line Endings**: Standardized all files to LF line endings
-
-### Technical
-
-- Consistent use of box-drawing characters across all commands
-- Improved terminal width detection for responsive layouts
-
-## [1.5.1] - 2025-11-05
-
-## [1.4.7] - 2025-11-05
-
-### Added (1.4.7)
-
-- Show allowed file extensions hint in the interactive file browser when an assignment restricts uploads (e.g. `*.pdf`, `*.docx`).
-- Add `r` keybinding to the file browser to reload the current directory listing without exiting the browser.
-
-- **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)
-  - **Wildcard support**: Use patterns like `*.html`, `*.js`, `*.pdf` to select multiple files
-  - File type icons for better visual identification
-
-- **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
-
-### Notes (1.4.7)
-
-- Bumped package version to 1.4.7.
-  - 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 (1.4.7)
-
-- **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
-
-### Fixed (1.4.7)
-
-- Prevent the interactive file browser from permanently removing other stdin listeners: save and restore `process.stdin` 'data' listeners so `readline` and SIGINT (Ctrl+C) continue to work after browser exit.
-- Filter file browser listings by `allowed_extensions` when provided by the assignment so disallowed file types cannot be selected (prevents HTTP 400 "filetype not allowed").
-- Allow pressing Enter at the final "Proceed with submission? (Y/n)" prompt to accept the default (Yes) to match the shown prompt.
-- **Assignment Name Display**: Fixed "Unknown Assignment" issue in submission summary
-- **File Selection Flow**: Better error handling and user guidance during file selection
-- **Variable Scope**: Proper assignment variable handling throughout submission process
-
-### Technical (1.4.7)
-
-- 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 (1.1.1)
-
-- 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 (1.1.1)
-
-- Dual binary support: both `canvaslms-cli` and `canvas` commands work
-
-## [1.1.0] - 2025-07-03
-
-### Major Changes (1.1.0)
-
-- Home directory configuration system (~/.canvaslms-cli-config.json)
-- Interactive configuration setup wizard (`canvas config setup`)
-- Configuration management subcommands:
-  - `canvas config show` - Display current configuration
-  - `canvas config edit` - Edit existing configuration
-  - `canvas config path` - Show config file location
-  - `canvas config delete` - Remove configuration file
-- Automatic configuration validation for all commands
-- Improved error handling and user guidance
-
-### Changed (1.1.0)
-
-- **BREAKING**: Removed environment variable support (.env files)
-- Configuration now stored in user's home directory instead of project directory
-- Enhanced configuration validation with better error messages
-- Improved user onboarding with guided setup process
-
-### Removed (1.1.0)
-
-- dotenv dependency (no longer needed)
-- Environment variable fallback support
-
-## [1.0.0] - 2025-07-03
-
-### Added (1.0.0)
-
-- Initial release of Canvas CLI Tool
-- Modular architecture with separate command handlers
-- Interactive assignment submission with file upload
-- Course management (list starred/all courses)
-- Assignment operations (view, filter by status)
-- Grade viewing for all courses or specific course
-- Announcements viewing
-- User profile management
-- Raw API access for all HTTP methods (GET, POST, PUT, DELETE)
-- Comprehensive configuration management
-- Color-coded output for better readability
-- Support for multiple file uploads
-- File selection from current directory
-- Detailed verbose modes for all commands
-
-### Features (1.0.0)
-
-- 📚 Course listing with favorites support
-- 📝 Assignment management with status indicators
-- 🚀 Interactive file submission workflow
-- 📢 Announcement viewing
-- 👤 Profile information display
-- 🔧 Direct Canvas API access
-- ⚡ Command aliases for faster usage
-- 🎨 Color-coded grade display
-- 📁 Smart file selection interface
-
-### Technical (1.0.0)
-
-- Modular command structure in separate files
-- Reusable API client library
-- Interactive prompt utilities
-- File upload handling with progress indicators
-- Error handling and user-friendly messages
-- Cross-platform compatibility
-
-## [Unreleased]
-
-### Planned Features (Unreleased)
-
-- Assignment creation and editing
-- Bulk operations
-- Plugin system
-- Advanced filtering options
-- Export functionality
-- Offline mode support
+# Changelog
+
+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.6.5] - 2025-12-15
+
+### Removed (1.6.5)
+
+- **Unused Command File**: Deleted `api.ts` - Raw API command handler that was never imported or used in the CLI
+- **Unused Functions from interactive.ts**: `getSubfoldersRecursive()`, `getFilesMatchingWildcard()`, `selectFilesImproved()`
+- **Unused Dependencies**: Removed `adm-zip` and `@types/adm-zip` packages
+
+## [1.6.4-fix] - 2025-12-15
+
+### Fix (1.6.4)
+
+- **Remove Postinstall Command**: Change to prepare husky
+
+## [1.6.4] - 2025-12-15
+
+### Added (1.6.4)
+
+- **Modules Command**: New `modules` command to view course modules and their items with progress tracking
+- **Calendar Command**: New `calendar` command to view upcoming assignments and events with due dates
+
+### Changed (1.6.4)
+
+- **Course Arguments**: Replaced course ID arguments with course name arguments across all commands (assignments, grades, announcements) for easier usage
+- **Workflow Name**: Changed CI workflow name from "CI" to "Test & Build" for better clarity
+
+## [1.6.3] - 2025-12-14
+
+### Added (1.6.3)
+
+- **Live table resize**: Tables re-render automatically when terminal is resized
+- **Adaptive truncation**: Text truncation updates dynamically based on terminal width
+
+### Fixed (1.6.3)
+
+- **Submit table truncation**: Reduced excessive truncation in the submit table by compacting columns and shortening date format
+- **Table overflow**: Fixed tables overflowing terminal width on small screens
+- **Column width calculation**: Corrected border overhead calculation for accurate fitting
+
+### Changed (1.6.3)
+
+- **Submit table columns**: Optimized and tightened column widths for compact display (Assignment Name max width set to 35, Type fixed at 8, Due fixed at 16 with MM/DD/YYYY formatting, Status fixed at 12)
+
+## [1.6.2] - 2025-12-14
+
+- **Table display**: All table now have the same rounded corner format, text size adaptive to the terminal size
+
+## [1.6.1] - 2025-12-13
+
+- **Dry Run Mode**: Submit command now supports `--dry-run` flag to test submission flow without actually uploading files or submitting assignments
+- **Assignment URL Display**: After successful submission, the direct link to the assignment is now displayed for easy access
+
+## [1.6.0] - 2025-12-06
+
+### Added (1.6.0)
+
+- **Boxed Table Displays**: All commands now display data in modern boxed tables with rounded corners (╭╮╰╯)
+- **Adaptive Column Widths**: Tables dynamically adjust column widths based on terminal size for optimal display
+- **Color-Coded Grades**: Assignment grades are now color-coded (green: ≥80%, yellow: ≥50%, red: <50%)
+- **Announcements Table**: Course selection and announcements list now displayed in formatted tables
+- **Profile Table**: User profile information displayed in clean field/value table format
+
+### Changed (1.6.0)
+
+- **Grades Display**: Merged official grades and calculated statistics into a unified table
+- **CLI Descriptions**: Shortened command descriptions for cleaner help output
+- **Config Output**: Simplified config help by removing redundant command examples
+- **Submit Command**: Updated to use rounded corners and adaptive widths
+- **Line Endings**: Standardized all files to LF line endings
+
+### Technical
+
+- Consistent use of box-drawing characters across all commands
+- Improved terminal width detection for responsive layouts
+
+## [1.5.1] - 2025-11-05
+
+## [1.4.7] - 2025-11-05
+
+### Added (1.4.7)
+
+- Show allowed file extensions hint in the interactive file browser when an assignment restricts uploads (e.g. `*.pdf`, `*.docx`).
+- Add `r` keybinding to the file browser to reload the current directory listing without exiting the browser.
+
+- **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)
+  - **Wildcard support**: Use patterns like `*.html`, `*.js`, `*.pdf` to select multiple files
+  - File type icons for better visual identification
+
+- **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
+
+### Notes (1.4.7)
+
+- Bumped package version to 1.4.7.
+  - 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 (1.4.7)
+
+- **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
+
+### Fixed (1.4.7)
+
+- Prevent the interactive file browser from permanently removing other stdin listeners: save and restore `process.stdin` 'data' listeners so `readline` and SIGINT (Ctrl+C) continue to work after browser exit.
+- Filter file browser listings by `allowed_extensions` when provided by the assignment so disallowed file types cannot be selected (prevents HTTP 400 "filetype not allowed").
+- Allow pressing Enter at the final "Proceed with submission? (Y/n)" prompt to accept the default (Yes) to match the shown prompt.
+- **Assignment Name Display**: Fixed "Unknown Assignment" issue in submission summary
+- **File Selection Flow**: Better error handling and user guidance during file selection
+- **Variable Scope**: Proper assignment variable handling throughout submission process
+
+### Technical (1.4.7)
+
+- 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 (1.1.1)
+
+- 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 (1.1.1)
+
+- Dual binary support: both `canvaslms-cli` and `canvas` commands work
+
+## [1.1.0] - 2025-07-03
+
+### Major Changes (1.1.0)
+
+- Home directory configuration system (~/.canvaslms-cli-config.json)
+- Interactive configuration setup wizard (`canvas config setup`)
+- Configuration management subcommands:
+  - `canvas config show` - Display current configuration
+  - `canvas config edit` - Edit existing configuration
+  - `canvas config path` - Show config file location
+  - `canvas config delete` - Remove configuration file
+- Automatic configuration validation for all commands
+- Improved error handling and user guidance
+
+### Changed (1.1.0)
+
+- **BREAKING**: Removed environment variable support (.env files)
+- Configuration now stored in user's home directory instead of project directory
+- Enhanced configuration validation with better error messages
+- Improved user onboarding with guided setup process
+
+### Removed (1.1.0)
+
+- dotenv dependency (no longer needed)
+- Environment variable fallback support
+
+## [1.0.0] - 2025-07-03
+
+### Added (1.0.0)
+
+- Initial release of Canvas CLI Tool
+- Modular architecture with separate command handlers
+- Interactive assignment submission with file upload
+- Course management (list starred/all courses)
+- Assignment operations (view, filter by status)
+- Grade viewing for all courses or specific course
+- Announcements viewing
+- User profile management
+- Raw API access for all HTTP methods (GET, POST, PUT, DELETE)
+- Comprehensive configuration management
+- Color-coded output for better readability
+- Support for multiple file uploads
+- File selection from current directory
+- Detailed verbose modes for all commands
+
+### Features (1.0.0)
+
+- 📚 Course listing with favorites support
+- 📝 Assignment management with status indicators
+- 🚀 Interactive file submission workflow
+- 📢 Announcement viewing
+- 👤 Profile information display
+- 🔧 Direct Canvas API access
+- ⚡ Command aliases for faster usage
+- 🎨 Color-coded grade display
+- 📁 Smart file selection interface
+
+### Technical (1.0.0)
+
+- Modular command structure in separate files
+- Reusable API client library
+- Interactive prompt utilities
+- File upload handling with progress indicators
+- Error handling and user-friendly messages
+- Cross-platform compatibility
+
+## [Unreleased]
+
+### Planned Features (Unreleased)
+
+- Assignment creation and editing
+- Bulk operations
+- Plugin system
+- Advanced filtering options
+- Export functionality
+- Offline mode support

package/dist/commands/calendar.d.ts

@@ -0,0 +1,7 @@
+export interface CalendarOptions {
+    days?: string;
+    all?: boolean;
+    past?: boolean;
+}
+export declare function showCalendar(options?: CalendarOptions): Promise<void>;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/commands/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../commands/calendar.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA8CD,wBAAsB,YAAY,CAChC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CA+If"}

package/dist/commands/calendar.js

@@ -0,0 +1,150 @@
+import { makeCanvasRequest } from "../lib/api-client.js";
+import { Table, printInfo, printError, printSuccess } from "../lib/display.js";
+import chalk from "chalk";
+function formatTimeRemaining(dueDate) {
+    const now = new Date();
+    const diff = dueDate.getTime() - now.getTime();
+    const days = Math.floor(diff / (1000 * 60 * 60 * 24));
+    const hours = Math.floor((diff % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+    if (diff < 0) {
+        const pastDays = Math.abs(days);
+        if (pastDays === 0)
+            return { text: "Today", color: chalk.red };
+        if (pastDays === 1)
+            return { text: "1d ago", color: chalk.red };
+        return { text: `${pastDays}d ago`, color: chalk.red };
+    }
+    if (days === 0) {
+        if (hours <= 1)
+            return { text: "< 1 hour", color: chalk.red };
+        return { text: `${hours} hours`, color: chalk.red };
+    }
+    if (days === 1)
+        return { text: "Tomorrow", color: chalk.yellow };
+    if (days <= 3)
+        return { text: `${days} days`, color: chalk.yellow };
+    if (days <= 7)
+        return { text: `${days} days`, color: chalk.cyan };
+    return { text: `${days} days`, color: chalk.green };
+}
+function formatDueDate(date) {
+    const month = (date.getMonth() + 1).toString().padStart(2, "0");
+    const day = date.getDate().toString().padStart(2, "0");
+    const hours = date.getHours().toString().padStart(2, "0");
+    const mins = date.getMinutes().toString().padStart(2, "0");
+    return `${month}/${day} ${hours}:${mins}`;
+}
+export async function showCalendar(options = {}) {
+    try {
+        const days = parseInt(options.days || "14", 10);
+        const showPast = options.past || false;
+        printInfo("\n" + "-".repeat(60));
+        printInfo("Loading upcoming due dates...");
+        const queryParams = ["enrollment_state=active", "include[]=favorites"];
+        const courses = await makeCanvasRequest("get", "courses", queryParams);
+        if (!courses || courses.length === 0) {
+            printError("No courses found.");
+            return;
+        }
+        let targetCourses = courses;
+        if (!options.all) {
+            const starred = courses.filter((c) => c.is_favorite);
+            if (starred.length > 0) {
+                targetCourses = starred;
+            }
+        }
+        const now = new Date();
+        const futureDate = new Date(now.getTime() + days * 24 * 60 * 60 * 1000);
+        const pastDate = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        const assignmentPromises = targetCourses.map(async (course) => {
+            try {
+                const assignments = await makeCanvasRequest("get", `courses/${course.id}/assignments`, ["include[]=submission", "per_page=100"]);
+                return { course, assignments: assignments || [] };
+            }
+            catch {
+                return { course, assignments: [] };
+            }
+        });
+        const results = await Promise.all(assignmentPromises);
+        const dueItems = [];
+        for (const { course, assignments } of results) {
+            for (const assignment of assignments) {
+                if (!assignment.due_at)
+                    continue;
+                const dueAt = new Date(assignment.due_at);
+                const submission = assignment.submission;
+                const isSubmitted = !!(submission && submission.submitted_at);
+                if (showPast) {
+                    if (dueAt < pastDate || dueAt > futureDate)
+                        continue;
+                }
+                else {
+                    if (dueAt < now || dueAt > futureDate)
+                        continue;
+                }
+                dueItems.push({
+                    courseName: course.name,
+                    courseId: course.id,
+                    assignmentName: assignment.name,
+                    assignmentId: assignment.id,
+                    dueAt,
+                    submitted: isSubmitted,
+                    pointsPossible: assignment.points_possible || 0,
+                });
+            }
+        }
+        dueItems.sort((a, b) => a.dueAt.getTime() - b.dueAt.getTime());
+        if (dueItems.length === 0) {
+            console.log(chalk.yellow(`\nNo upcoming assignments due in the next ${days} days.`));
+            if (!options.all) {
+                console.log(chalk.gray("Tip: Use --all to include all courses."));
+            }
+            return;
+        }
+        const courseLabel = options.all ? "all courses" : "starred courses";
+        console.log(chalk.cyan.bold(`\nUpcoming Due Dates (${courseLabel}, next ${days} days)`));
+        printSuccess(`Found ${dueItems.length} upcoming assignment(s).`);
+        const table = new Table([
+            { key: "course", header: "Course", flex: 1, minWidth: 10 },
+            { key: "assignment", header: "Assignment", flex: 1, minWidth: 15 },
+            { key: "due", header: "Due", width: 12 },
+            {
+                key: "remaining",
+                header: "Remaining",
+                width: 10,
+                color: (value, row) => {
+                    const colorFn = row._remainingColor;
+                    return colorFn ? colorFn(value) : chalk.white(value);
+                },
+            },
+            {
+                key: "status",
+                header: "Status",
+                width: 8,
+                color: (value, row) => row._submitted ? chalk.green(value) : chalk.yellow(value),
+            },
+        ], { showRowNumbers: true });
+        for (const item of dueItems) {
+            const remaining = formatTimeRemaining(item.dueAt);
+            table.addRow({
+                course: item.courseName,
+                assignment: item.assignmentName,
+                due: formatDueDate(item.dueAt),
+                remaining: remaining.text,
+                status: item.submitted ? "Done" : "Pending",
+                _submitted: item.submitted,
+                _remainingColor: remaining.color,
+            });
+        }
+        table.renderWithResize();
+        const pending = dueItems.filter((d) => !d.submitted).length;
+        const done = dueItems.filter((d) => d.submitted).length;
+        console.log(chalk.gray(`\n  ${pending} pending, ${done} submitted`));
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error(chalk.red("Error fetching calendar:"), errorMessage);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=calendar.js.map