@mtgibbs/canvas-lms-mcp 0.1.0

package/esm/src/api/assignments.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Canvas Assignments API
+ */
+import type { Assignment, ListAssignmentsOptions } from "../types/canvas.js";
+/**
+ * List assignments for a course
+ */
+export declare function listAssignments(options: ListAssignmentsOptions): Promise<Assignment[]>;
+/**
+ * Get a single assignment by ID
+ */
+export declare function getAssignment(courseId: number, assignmentId: number, include?: Array<"submission" | "assignment_visibility" | "all_dates" | "overrides">): Promise<Assignment>;
+/**
+ * List assignments due within a date range
+ */
+export declare function listAssignmentsDueInRange(courseId: number, startDate: Date, endDate: Date): Promise<Assignment[]>;
+/**
+ * List assignments due this week
+ */
+export declare function listAssignmentsDueThisWeek(courseId: number): Promise<Assignment[]>;
+/**
+ * List upcoming assignments (next N days)
+ */
+export declare function listUpcomingAssignments(courseId: number, days?: number): Promise<Assignment[]>;
+/**
+ * List overdue assignments
+ */
+export declare function listOverdueAssignments(courseId: number): Promise<Assignment[]>;
+/**
+ * List unsubmitted assignments that are past their due date
+ * This catches items that Canvas hasn't flagged as "missing" yet
+ */
+export declare function listUnsubmittedPastDue(courseId: number): Promise<Assignment[]>;
+/**
+ * List unsubmitted past-due assignments across multiple courses
+ */
+export declare function listUnsubmittedPastDueForCourses(courseIds: number[]): Promise<(Assignment & {
+    course_name?: string;
+})[]>;
+//# sourceMappingURL=assignments.d.ts.map

package/esm/src/api/assignments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assignments.d.ts","sourceRoot":"","sources":["../../../src/src/api/assignments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE7E;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoB5F;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,GAAG,uBAAuB,GAAG,WAAW,GAAG,WAAW,CAAC,GAClF,OAAO,CAAC,UAAU,CAAC,CASrB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,OAAO,CAAC,UAAU,EAAE,CAAC,CAYvB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAWxF;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAU,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAMvB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAMpF;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBpF;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CACpD,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,CAAC,UAAU,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CAAC,CAiBpD"}

package/esm/src/api/assignments.js

@@ -0,0 +1,133 @@
+/**
+ * Canvas Assignments API
+ */
+import { getClient } from "./client.js";
+/**
+ * List assignments for a course
+ */
+export async function listAssignments(options) {
+    const client = getClient();
+    const { course_id, ...rest } = options;
+    const params = {};
+    if (rest.bucket) {
+        params.bucket = rest.bucket;
+    }
+    if (rest.order_by) {
+        params.order_by = rest.order_by;
+    }
+    if (rest.include) {
+        params.include = rest.include;
+    }
+    if (rest.search_term) {
+        params.search_term = rest.search_term;
+    }
+    return client.getAll(`/courses/${course_id}/assignments`, params);
+}
+/**
+ * Get a single assignment by ID
+ */
+export async function getAssignment(courseId, assignmentId, include) {
+    const client = getClient();
+    const params = {};
+    if (include) {
+        params.include = include;
+    }
+    return client.get(`/courses/${courseId}/assignments/${assignmentId}`, params);
+}
+/**
+ * List assignments due within a date range
+ */
+export async function listAssignmentsDueInRange(courseId, startDate, endDate) {
+    const assignments = await listAssignments({
+        course_id: courseId,
+        include: ["submission"],
+        order_by: "due_at",
+    });
+    return assignments.filter((assignment) => {
+        if (!assignment.due_at)
+            return false;
+        const dueDate = new Date(assignment.due_at);
+        return dueDate >= startDate && dueDate <= endDate;
+    });
+}
+/**
+ * List assignments due this week
+ */
+export async function listAssignmentsDueThisWeek(courseId) {
+    const now = new Date();
+    const startOfWeek = new Date(now);
+    startOfWeek.setDate(now.getDate() - now.getDay());
+    startOfWeek.setHours(0, 0, 0, 0);
+    const endOfWeek = new Date(startOfWeek);
+    endOfWeek.setDate(startOfWeek.getDate() + 7);
+    endOfWeek.setHours(23, 59, 59, 999);
+    return listAssignmentsDueInRange(courseId, startOfWeek, endOfWeek);
+}
+/**
+ * List upcoming assignments (next N days)
+ */
+export async function listUpcomingAssignments(courseId, days = 7) {
+    const now = new Date();
+    const endDate = new Date(now);
+    endDate.setDate(now.getDate() + days);
+    return listAssignmentsDueInRange(courseId, now, endDate);
+}
+/**
+ * List overdue assignments
+ */
+export async function listOverdueAssignments(courseId) {
+    return listAssignments({
+        course_id: courseId,
+        bucket: "overdue",
+        include: ["submission"],
+    });
+}
+/**
+ * List unsubmitted assignments that are past their due date
+ * This catches items that Canvas hasn't flagged as "missing" yet
+ */
+export async function listUnsubmittedPastDue(courseId) {
+    const assignments = await listAssignments({
+        course_id: courseId,
+        include: ["submission"],
+        order_by: "due_at",
+    });
+    const now = new Date();
+    return assignments.filter((assignment) => {
+        // Must have a due date
+        if (!assignment.due_at)
+            return false;
+        // Due date must be in the past
+        const dueDate = new Date(assignment.due_at);
+        if (dueDate >= now)
+            return false;
+        // Must not be submitted
+        const submission = assignment.submission;
+        if (!submission)
+            return true; // No submission record at all
+        if (!submission.submitted_at)
+            return true; // Has record but not submitted
+        return false;
+    });
+}
+/**
+ * List unsubmitted past-due assignments across multiple courses
+ */
+export async function listUnsubmittedPastDueForCourses(courseIds) {
+    const results = [];
+    for (const courseId of courseIds) {
+        try {
+            const assignments = await listUnsubmittedPastDue(courseId);
+            results.push(...assignments);
+        }
+        catch {
+            // Skip courses we can't access
+        }
+    }
+    // Sort by due date (most recent first)
+    return results.sort((a, b) => {
+        if (!a.due_at || !b.due_at)
+            return 0;
+        return new Date(b.due_at).getTime() - new Date(a.due_at).getTime();
+    });
+}

package/esm/src/api/client.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Canvas API Client
+ * Handles authentication, pagination, and HTTP requests
+ */
+import type { PaginationLinks } from "../types/canvas.js";
+export interface ClientOptions {
+    baseUrl: string;
+    apiToken: string;
+    /** Items per page for paginated requests (default: 100) */
+    perPage?: number;
+}
+export declare class CanvasClient {
+    private baseUrl;
+    private apiToken;
+    private perPage;
+    constructor(options: ClientOptions);
+    /**
+     * Build the full URL for an API endpoint
+     */
+    private buildUrl;
+    /**
+     * Parse Link header for pagination
+     */
+    private parseLinkHeader;
+    /**
+     * Make an authenticated request to the Canvas API
+     */
+    fetch<T>(path: string, options?: {
+        method?: string;
+        params?: Record<string, string | string[] | number | boolean | undefined>;
+        body?: unknown;
+    }): Promise<{
+        data: T;
+        links: PaginationLinks;
+    }>;
+    /**
+     * Fetch all pages of a paginated endpoint
+     */
+    fetchAll<T>(path: string, options?: {
+        params?: Record<string, string | string[] | number | boolean | undefined>;
+        /** Maximum number of items to fetch (default: unlimited) */
+        limit?: number;
+    }): Promise<T[]>;
+    /**
+     * Convenience method for GET requests
+     */
+    get<T>(path: string, params?: Record<string, string | string[] | number | boolean | undefined>): Promise<T>;
+    /**
+     * Convenience method for GET requests that return arrays (with pagination)
+     */
+    getAll<T>(path: string, params?: Record<string, string | string[] | number | boolean | undefined>): Promise<T[]>;
+}
+/**
+ * Initialize the singleton client (call once at startup)
+ */
+export declare function initClient(options: ClientOptions): CanvasClient;
+/**
+ * Get the singleton client instance
+ */
+export declare function getClient(): CanvasClient;
+//# sourceMappingURL=client.d.ts.map

package/esm/src/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/src/api/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAY,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,aAAa;IAMlC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAwBhB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACG,KAAK,CAAC,CAAC,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;QAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,GACA,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,eAAe,CAAA;KAAE,CAAC;IA4C/C;;OAEG;IACG,QAAQ,CAAC,CAAC,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;QAC1E,4DAA4D;QAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GACA,OAAO,CAAC,CAAC,EAAE,CAAC;IA6Cf;;OAEG;IACG,GAAG,CAAC,CAAC,EACT,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GACxE,OAAO,CAAC,CAAC,CAAC;IAKb;;OAEG;IACG,MAAM,CAAC,CAAC,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GACxE,OAAO,CAAC,CAAC,EAAE,CAAC;CAGhB;AAKD;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAG/D;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAKxC"}

package/esm/src/api/client.js

@@ -0,0 +1,179 @@
+/**
+ * Canvas API Client
+ * Handles authentication, pagination, and HTTP requests
+ */
+export class CanvasClient {
+    constructor(options) {
+        Object.defineProperty(this, "baseUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "apiToken", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "perPage", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.baseUrl = options.baseUrl.replace(/\/$/, "");
+        this.apiToken = options.apiToken;
+        this.perPage = options.perPage || 100;
+    }
+    /**
+     * Build the full URL for an API endpoint
+     */
+    buildUrl(path, params) {
+        const url = new URL(`${this.baseUrl}/api/v1${path}`);
+        // Add per_page by default for list endpoints
+        url.searchParams.set("per_page", String(this.perPage));
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value === undefined)
+                    continue;
+                if (Array.isArray(value)) {
+                    // Handle array params like include[]=foo&include[]=bar
+                    for (const v of value) {
+                        url.searchParams.append(`${key}[]`, v);
+                    }
+                }
+                else {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    /**
+     * Parse Link header for pagination
+     */
+    parseLinkHeader(linkHeader) {
+        if (!linkHeader)
+            return {};
+        const links = {};
+        const parts = linkHeader.split(",");
+        for (const part of parts) {
+            const match = part.match(/<([^>]+)>;\s*rel="([^"]+)"/);
+            if (match) {
+                const [, url, rel] = match;
+                links[rel] = url;
+            }
+        }
+        return links;
+    }
+    /**
+     * Make an authenticated request to the Canvas API
+     */
+    async fetch(path, options) {
+        const { method = "GET", params, body } = options || {};
+        const url = this.buildUrl(path, params);
+        const headers = {
+            Authorization: `Bearer ${this.apiToken}`,
+            Accept: "application/json",
+        };
+        const fetchOptions = {
+            method,
+            headers,
+        };
+        if (body) {
+            headers["Content-Type"] = "application/json";
+            fetchOptions.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, fetchOptions);
+        if (!response.ok) {
+            let errorMessage = `Canvas API error: ${response.status} ${response.statusText}`;
+            try {
+                const errorData = await response.json();
+                if (errorData.message) {
+                    errorMessage = errorData.message;
+                }
+                else if (errorData.errors?.length) {
+                    errorMessage = errorData.errors.map((e) => e.message).join(", ");
+                }
+            }
+            catch {
+                // Couldn't parse error body, use default message
+            }
+            throw new Error(errorMessage);
+        }
+        const data = await response.json();
+        const links = this.parseLinkHeader(response.headers.get("Link"));
+        return { data, links };
+    }
+    /**
+     * Fetch all pages of a paginated endpoint
+     */
+    async fetchAll(path, options) {
+        const { params, limit } = options || {};
+        const results = [];
+        let url = this.buildUrl(path, params);
+        while (url) {
+            const response = await fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${this.apiToken}`,
+                    Accept: "application/json",
+                },
+            });
+            if (!response.ok) {
+                let errorMessage = `Canvas API error: ${response.status} ${response.statusText}`;
+                try {
+                    const errorData = await response.json();
+                    if (errorData.message) {
+                        errorMessage = errorData.message;
+                    }
+                }
+                catch {
+                    // Couldn't parse error body
+                }
+                throw new Error(errorMessage);
+            }
+            const data = await response.json();
+            results.push(...data);
+            // Check if we've hit the limit
+            if (limit && results.length >= limit) {
+                return results.slice(0, limit);
+            }
+            // Get next page URL from Link header
+            const links = this.parseLinkHeader(response.headers.get("Link"));
+            url = links.next;
+        }
+        return results;
+    }
+    /**
+     * Convenience method for GET requests
+     */
+    async get(path, params) {
+        const { data } = await this.fetch(path, { params });
+        return data;
+    }
+    /**
+     * Convenience method for GET requests that return arrays (with pagination)
+     */
+    async getAll(path, params) {
+        return this.fetchAll(path, { params });
+    }
+}
+// Singleton instance for CLI usage
+let clientInstance = null;
+/**
+ * Initialize the singleton client (call once at startup)
+ */
+export function initClient(options) {
+    clientInstance = new CanvasClient(options);
+    return clientInstance;
+}
+/**
+ * Get the singleton client instance
+ */
+export function getClient() {
+    if (!clientInstance) {
+        throw new Error("Canvas client not initialized. Call initClient() first.");
+    }
+    return clientInstance;
+}

package/esm/src/api/courses.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Canvas Courses API
+ */
+import type { Course, Enrollment, ListCoursesOptions } from "../types/canvas.js";
+/**
+ * List all courses for the authenticated user
+ */
+export declare function listCourses(options?: ListCoursesOptions): Promise<Course[]>;
+/**
+ * Get a single course by ID
+ */
+export declare function getCourse(courseId: number): Promise<Course>;
+/**
+ * List enrollments for a course (includes grade info)
+ */
+export declare function listCourseEnrollments(courseId: number, options?: {
+    type?: string[];
+    state?: string[];
+    userId?: number | string;
+}): Promise<Enrollment[]>;
+/**
+ * Get enrollment with grades for a specific user in a course
+ */
+export declare function getUserEnrollment(courseId: number, userId: number | string): Promise<Enrollment | null>;
+/**
+ * List courses with grades for a user (observer or self)
+ * Enriches course data with enrollment/grade information
+ */
+export declare function listCoursesWithGrades(userId?: string | number): Promise<(Course & {
+    enrollment?: Enrollment;
+})[]>;
+//# sourceMappingURL=courses.d.ts.map

package/esm/src/api/courses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"courses.d.ts","sourceRoot":"","sources":["../../../src/src/api/courses.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEjF;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBjF;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGjE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B,GACA,OAAO,CAAC,UAAU,EAAE,CAAC,CAgBvB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAO5B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,GAAE,MAAM,GAAG,MAAe,GAC/B,OAAO,CAAC,CAAC,MAAM,GAAG;IAAE,UAAU,CAAC,EAAE,UAAU,CAAA;CAAE,CAAC,EAAE,CAAC,CAyBnD"}

package/esm/src/api/courses.js

@@ -0,0 +1,85 @@
+/**
+ * Canvas Courses API
+ */
+import { getClient } from "./client.js";
+/**
+ * List all courses for the authenticated user
+ */
+export async function listCourses(options) {
+    const client = getClient();
+    const params = {};
+    if (options?.enrollment_type) {
+        params.enrollment_type = options.enrollment_type;
+    }
+    if (options?.enrollment_state) {
+        params.enrollment_state = options.enrollment_state;
+    }
+    if (options?.include) {
+        params.include = options.include;
+    }
+    if (options?.state) {
+        params.state = options.state;
+    }
+    return client.getAll("/courses", params);
+}
+/**
+ * Get a single course by ID
+ */
+export async function getCourse(courseId) {
+    const client = getClient();
+    return client.get(`/courses/${courseId}`);
+}
+/**
+ * List enrollments for a course (includes grade info)
+ */
+export async function listCourseEnrollments(courseId, options) {
+    const client = getClient();
+    const params = {};
+    if (options?.type) {
+        params.type = options.type;
+    }
+    if (options?.state) {
+        params.state = options.state;
+    }
+    if (options?.userId) {
+        params.user_id = options.userId;
+    }
+    return client.getAll(`/courses/${courseId}/enrollments`, params);
+}
+/**
+ * Get enrollment with grades for a specific user in a course
+ */
+export async function getUserEnrollment(courseId, userId) {
+    const enrollments = await listCourseEnrollments(courseId, {
+        userId,
+        type: ["StudentEnrollment"],
+    });
+    return enrollments[0] || null;
+}
+/**
+ * List courses with grades for a user (observer or self)
+ * Enriches course data with enrollment/grade information
+ */
+export async function listCoursesWithGrades(userId = "self") {
+    // Get all active courses with enrollments included
+    const courses = await listCourses({
+        enrollment_state: "active",
+        include: ["enrollments", "term"],
+        state: ["available"],
+    });
+    // Filter and enrich with the specific user's enrollment data
+    const coursesWithGrades = courses.map((course) => {
+        // Find the enrollment for this user (or observed user)
+        const enrollment = course.enrollments?.find((e) => {
+            if (userId === "self") {
+                return e.type === "StudentEnrollment" || e.type === "ObserverEnrollment";
+            }
+            return e.user_id === Number(userId) || e.observed_user?.id === Number(userId);
+        });
+        return {
+            ...course,
+            enrollment,
+        };
+    });
+    return coursesWithGrades;
+}

package/esm/src/api/stats.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Student statistics API
+ * Calculates late/missing assignment statistics by course
+ */
+export interface CourseStats {
+    course_id: number;
+    course_name: string;
+    total: number;
+    late: number;
+    missing: number;
+    late_pct: number;
+    missing_pct: number;
+}
+export declare function getStudentStats(studentId: string | number): Promise<CourseStats[]>;
+//# sourceMappingURL=stats.d.ts.map

package/esm/src/api/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/src/api/stats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAyDxF"}

package/esm/src/api/stats.js

@@ -0,0 +1,58 @@
+/**
+ * Student statistics API
+ * Calculates late/missing assignment statistics by course
+ */
+import { listCourses } from "./courses.js";
+import { listSubmissions } from "./submissions.js";
+import { getMissingSubmissions } from "./users.js";
+export async function getStudentStats(studentId) {
+    const courses = await listCourses({
+        enrollment_state: "active",
+        state: ["available"],
+    });
+    // Get missing assignments from Canvas
+    const missing = await getMissingSubmissions({
+        studentId,
+        include: ["course"],
+    });
+    // Count missing by course
+    const missingByCourse = new Map();
+    for (const m of missing) {
+        missingByCourse.set(m.course_id, (missingByCourse.get(m.course_id) || 0) + 1);
+    }
+    const stats = [];
+    for (const course of courses) {
+        try {
+            const subs = await listSubmissions({
+                course_id: course.id,
+                student_ids: [Number(studentId)],
+                include: ["assignment"],
+            });
+            let total = 0;
+            let late = 0;
+            for (const sub of subs) {
+                if (sub.assignment === null || sub.assignment === undefined)
+                    continue;
+                total++;
+                if (sub.late)
+                    late++;
+            }
+            const missingCount = missingByCourse.get(course.id) || 0;
+            stats.push({
+                course_id: course.id,
+                course_name: course.name,
+                total,
+                late,
+                missing: missingCount,
+                late_pct: total > 0 ? Math.round((late / total) * 1000) / 10 : 0,
+                missing_pct: total > 0 ? Math.round((missingCount / total) * 1000) / 10 : 0,
+            });
+        }
+        catch {
+            // Skip courses we can't access
+        }
+    }
+    // Sort by missing percentage descending (worst first)
+    stats.sort((a, b) => b.missing_pct - a.missing_pct || b.late_pct - a.late_pct);
+    return stats;
+}

package/esm/src/api/submissions.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Canvas Submissions API
+ */
+import type { Submission, ListSubmissionsOptions } from "../types/canvas.js";
+/**
+ * List submissions for a course (all students or specific students)
+ */
+export declare function listSubmissions(options: ListSubmissionsOptions): Promise<Submission[]>;
+/**
+ * Get submission for a specific assignment and user
+ */
+export declare function getSubmission(courseId: number, assignmentId: number, userId: number | string, include?: Array<"submission_history" | "submission_comments" | "rubric_assessment">): Promise<Submission>;
+/**
+ * List all submissions for a specific user in a course
+ */
+export declare function listUserSubmissions(courseId: number, userId: number | string, options?: {
+    include?: Array<"submission_history" | "submission_comments" | "assignment" | "user">;
+    workflowState?: "submitted" | "unsubmitted" | "graded" | "pending_review";
+}): Promise<Submission[]>;
+/**
+ * List graded submissions for a user
+ */
+export declare function listGradedSubmissions(courseId: number, userId: number | string): Promise<Submission[]>;
+/**
+ * List submissions with grades below a threshold
+ */
+export declare function listSubmissionsBelowThreshold(courseId: number, userId: number | string, threshold: number): Promise<Submission[]>;
+/**
+ * List unsubmitted past-due assignments for a student
+ * Uses the submissions endpoint to get the student's actual submission status
+ */
+export declare function listUnsubmittedPastDueForStudent(courseId: number, studentId: number | string): Promise<Submission[]>;
+//# sourceMappingURL=submissions.d.ts.map

package/esm/src/api/submissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"submissions.d.ts","sourceRoot":"","sources":["../../../src/src/api/submissions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE7E;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAuB5F;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,KAAK,CAAC,oBAAoB,GAAG,qBAAqB,GAAG,mBAAmB,CAAC,GAClF,OAAO,CAAC,UAAU,CAAC,CAYrB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,KAAK,CAAC,oBAAoB,GAAG,qBAAqB,GAAG,YAAY,GAAG,MAAM,CAAC,CAAC;IACtF,aAAa,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,gBAAgB,CAAC;CAC3E,GACA,OAAO,CAAC,UAAU,EAAE,CAAC,CAOvB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,GACtB,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC,CAWvB;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CACpD,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,MAAM,GACzB,OAAO,CAAC,UAAU,EAAE,CAAC,CAwBvB"}