Canvas Student Wrapper

Exposes an object that contains a student's courses, their announcements, and their grades.

Usage:

Install with npm install canvas-student-wrapper -S and import using

import StudentCanvas, { RedactedCanvas } from 'canvas-student-wrapper' in a .mjs file.

You can generate a student access token by going to canvas, navigating to the profile settting page, and clicking on + New Access Token. You can give this access token any name.

Student Canvas

Acts as an interface for everything a student can see on their course page. This includes read status for announcements and the status of their assignments.

To create an instance of StudentCanvas, use const canvas = new StudentCavas(ACCESS_TOKEN, SUBDOMAIN).

StudentCanvas Methods:

• getActiveCourses(): Gets basic information about all courses the user is currently enrolled in. This does not include announcements or assignments.
• getAllCourses(): Gets basic information about all courses the user has ever been enrolled in. This does not include announcements or assignments.
• getAnnouncements(COURSE_IDS): Get the announcements for all courses in COURSE_IDS.
• getAssignments(COURSE_IDS): Get the assignments for all courses in COURSE_IDS.
• getCourseExtras(COURSE_IDS): Gets both announcements and assignments for courses in COURSE_IDS.
• update(): Refreshes all courses, announcements, and assignments that are currently stored.

Redacted Canvas

This has most of the same functions as the student canvas, but it removes all sensitive information and autopopulates all currently active lectures.

To create an instance of RedactedCanvas, use const canvas = await RedactedCanvas.setup(ACCESS_TOKEN, SUBDOMAIN).

The update method of RedactedCanvas only updates active courses.

Course Object

Course objects Contain the following properties:

| Key | Property | | --- | --- | | id | A number that uniquely identifies the course on canvas. | | name | The long, descriptive name of the course. | | code | The course code. | | startDate | A date object with the start date of the course. | | active | A boolean representing whether the student is currently in the course. | | calendarLink | A link to an ics file that has the course calendar. | | term | An object with the keys name, startDate, and endDate that represents the term the course was taken in. | | courseImg | A link to the front image of the course. | | totalStudents | The total number of students in the course. | | teachers | An array of objects with the keys avatar, link, and name that identify the course instructors. | | tabs | An array of objects with the keys id, label, link, position, and type that point to canvas pages. | | announcements | An array of Annoucement objects (Reference Below). | | assignments | An array of Assignment objects (Reference Below). |

Annoucement Object

Annoucement objects contain the following properties:

| Key | Property | | --- | --- | | position | Number that sorts the annoucements. | | title | The title of the annoucement. | | message | The body text of the annoucement | | read | Whether the user has opened this announcement. | | author | An object with a name key that identifies the person who posted the announcement. | | link | A link to the announcement page. | | date | The date that the announcement was made. |

Assignment Object

Assignment objects contain the following properties:

| Key | Property | | --- | --- | | position | Number that sorts the annoucements. | | name | The title of the assignment. | | description | A detailed description of the assignment. | | dueDate | A date object representing the due date. | | unlockDate | A date object representing the date the assignment will be available at. | | counts | A boolean value representing whether the assignment will effect the final grade. | | allowedAttempts | A number representing the number of times the user can submit. | | submitted | A boolean representing whether the user has submitted. | | link | A link to the assignment page. | | submission | A Submission object. (Reference Below) | | possiblePoints | A number representing the max number of points on the assignment | | submitted | Whether the student has submitted this assignment. |

Submission Object

Submission objects contain the following properties:

| Key | Property | | --- | --- | | score | A number representing how many points the student got. | | possiblePoints | The max number of points that could be achieved. | | submissionDate | The date that the user submitted. | | gradedDate | The date that the submission was graded. | | graded | A boolean representing if the submission has been graded. | | late | A boolean representing if the submission was late. | | missing | A boolean representing if the submission is missing. |