@insignia-education/api-sdk-js 0.25.10 → 0.25.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insignia-education/api-sdk-js",
-  "version": "0.25.10",
+  "version": "0.25.12",
   "description": "JavaScript SDK for the Insignia Education API",
   "main": "index.js",
   "type": "module",

package/src/api/v1/Employee.js

@@ -18,6 +18,12 @@ export default class Employee {
             teacherCourses: (teacherId) => this.#client.get(`${base}/teachers/${teacherId}/courses`),
             /** All sessions for one course_date, any teacher. */
             courseDateSessions: (courseDateId) => this.#client.get(`${base}/course-dates/${courseDateId}/sessions`),
+            /** Ranked roster ({id, name, email, rank}) of any course_date. */
+            courseDateStudents: (courseDateId) => this.#client.get(`${base}/course-dates/${courseDateId}/students`),
+            /** One enrolled student's quiz attempts in this course_date's course (any teacher's date) — same shape as Teacher.dashboard().courseDateStudentQuizzes(). Grade them with Users.quizzes(studentId).detail()/grade(). Not enrolled → 403. */
+            courseDateStudentQuizzes: (courseDateId, studentId) => this.#client.get(`${base}/course-dates/${courseDateId}/students/${studentId}/quizzes`),
+            /** Save the ranking of one course_date's students: `studentIds` in order, first = rank 1. Returns the re-ranked roster. Ids not enrolled → 422. */
+            rankCourseDateStudents: (courseDateId, studentIds) => this.#client.put(`${base}/course-dates/${courseDateId}/students/ranking`, { student_ids: studentIds }),
             /** Mark a student's attendance on any teacher's session. */
             markAttendance: (sessionId, studentId, present) =>
                 this.#client.patch(`${base}/sessions/${sessionId}/attendance`, { student_id: studentId, present }),

package/src/api/v1/Teacher.js

@@ -54,8 +54,10 @@ export default class Teacher {
             courseDates: () => this.#client.get(`${base}/course-dates`),
             /** All sessions for one CourseDate, each with a `students` roster ({id, name, present}). */
             courseDateSessions: (courseDateId) => this.#client.get(`${base}/course-dates/${courseDateId}/sessions`),
-            /** Enrolled roster ({id, name, email}) for one CourseDate, read straight off enrollment — shows up even before any session has been synced. Read-only: does not move students between dates. */
+            /** Enrolled roster ({id, name, email, rank}, ranked first — unranked last) for one CourseDate, read straight off enrollment — shows up even before any session has been synced. Read-only: does not move students between dates. */
             courseDateStudents: (courseDateId) => this.#client.get(`${base}/course-dates/${courseDateId}/students`),
+            /** Save the teacher's ranking of one CourseDate's students: `studentIds` in order, first = rank 1. Returns the re-ranked roster ({id, name, email, rank}). Ids not enrolled → 422. */
+            rankCourseDateStudents: (courseDateId, studentIds) => this.#client.put(`${base}/course-dates/${courseDateId}/students/ranking`, { student_ids: studentIds }),
             /** One student's quiz attempts in this CourseDate's course, every one of them - not just needs_teacher_correction=1 (auto-graded ones never show up in the "Quizzes por corregir" surfaces below). Each row carries `quiz.needs_teacher_correction`, `level`/`lesson`, `final_score_percentage`; filter by level/lesson client-side. */
             courseDateStudentQuizzes: (courseDateId, studentId) => this.#client.get(`${base}/course-dates/${courseDateId}/students/${studentId}/quizzes`),
             /** { url, pending } — the zip archive of this group's course materials, or pending:true while it's (re)building. */