@robertying/thu-learn-lib 0.0.0-stage → 5.0.0

package/lib/homework.js

@@ -0,0 +1,194 @@
+// Homework (课程作业), excellent homework and homework submission.
+import { Base64 } from 'js-base64';
+import { $, YES } from './request.js';
+import { ContentType, CourseType, FailReason } from './types.js';
+import * as URLS from './urls.js';
+import { GRADE_LEVEL_MAP, decodeHTML, isSelected, trimAndDefine } from './utils.js';
+export async function getHomeworkList(s, courseID, courseType = CourseType.STUDENT, options = {}) {
+    if (courseType === CourseType.TEACHER) {
+        const json = await (await s.fetchWithToken(URLS.LEARN_HOMEWORK_LIST_TEACHER, {
+            method: 'POST',
+            body: URLS.LEARN_PAGE_LIST_FORM_DATA(courseID),
+        })).json();
+        if (json.result !== 'success') {
+            return Promise.reject({
+                reason: FailReason.INVALID_RESPONSE,
+                extra: json,
+            });
+        }
+        const result = (json.object?.aaData ?? []);
+        return result.map((d) => ({
+            id: d.zyid,
+            index: d.wz,
+            title: decodeHTML(d.bt),
+            description: decodeHTML(Base64.decode(d.nr)),
+            publisherId: d.fbr,
+            publishTime: d.fbsj,
+            startTime: d.kssj,
+            deadline: d.jzsj,
+            lateSubmissionDeadline: d.bjjzsj ?? undefined,
+            url: URLS.LEARN_HOMEWORK_DETAIL_TEACHER(courseID, d.zyid),
+            completionType: d.zywcfs,
+            submissionType: d.zytjfs,
+            gradedCount: d.ypys,
+            submittedCount: d.yjs,
+            unsubmittedCount: d.wjs,
+        }));
+    }
+    else {
+        const [lists, excellentHomeworkListByHomework] = await Promise.all([
+            Promise.all(URLS.LEARN_HOMEWORK_LIST_SOURCE.map((source) => getHomeworkListAtUrl(s, courseID, source.url, source.status))),
+            // Don't block the whole process if excellent homework list cannot be fetched
+            getExcellentHomeworkListByHomework(s, courseID).catch(() => ({})),
+        ]);
+        return Promise.all(lists.flat().map(async (h) => {
+            const homework = { ...h, excellentHomeworkList: excellentHomeworkListByHomework[h.baseId] };
+            return isSelected(options.details, homework) ? { ...homework, ...(await getHomeworkDetail(s, h)) } : homework;
+        }));
+    }
+}
+async function getHomeworkListAtUrl(s, courseID, url, status) {
+    const json = await (await s.fetchWithToken(url, {
+        method: 'POST',
+        body: URLS.LEARN_PAGE_LIST_FORM_DATA(courseID),
+    })).json();
+    if (json.result !== 'success') {
+        return Promise.reject({
+            reason: FailReason.INVALID_RESPONSE,
+            extra: json,
+        });
+    }
+    const result = (json.object?.aaData ?? []);
+    return result.map((h) => ({
+        id: h.xszyid,
+        studentHomeworkId: h.xszyid,
+        baseId: h.zyid,
+        title: decodeHTML(h.bt),
+        url: URLS.LEARN_HOMEWORK_PAGE(h.wlkcid, h.xszyid),
+        deadline: h.jzsj,
+        lateSubmissionDeadline: h.bjjzsj ? h.bjjzsj : undefined,
+        isLateSubmission: h.sfbj === YES,
+        completionType: h.zywcfs,
+        submissionType: h.zytjfs,
+        submitUrl: URLS.LEARN_HOMEWORK_SUBMIT_PAGE(h.wlkcid, h.xszyid),
+        submitTime: h.scsj === null ? undefined : h.scsj,
+        grade: h.cj === null ? undefined : h.cj,
+        gradeLevel: GRADE_LEVEL_MAP.get(h.cj),
+        graderName: trimAndDefine(h.jsm),
+        gradeContent: trimAndDefine(h.pynr),
+        gradeTime: h.pysj === null ? undefined : h.pysj,
+        isFavorite: h.sfsc === YES,
+        favoriteTime: h.scsj === null || h.sfsc !== YES ? undefined : h.scsj,
+        comment: h.bznr ?? undefined,
+        ...status,
+    }));
+}
+async function getExcellentHomeworkListByHomework(s, courseID) {
+    const json = await (await s.fetchWithToken(URLS.LEARN_HOMEWORK_LIST_EXCELLENT, {
+        method: 'POST',
+        body: URLS.LEARN_PAGE_LIST_FORM_DATA(courseID),
+    })).json();
+    if (json.result !== 'success') {
+        return Promise.reject({
+            reason: FailReason.INVALID_RESPONSE,
+            extra: json,
+        });
+    }
+    const result = (json.object?.aaData ?? []);
+    return result
+        .map((h) => ({
+        id: h.xszyid,
+        baseId: h.zyid,
+        title: decodeHTML(h.bt),
+        url: URLS.LEARN_HOMEWORK_EXCELLENT_PAGE(h.wlkcid, h.xszyid),
+        completionType: h.zywcfs,
+        author: {
+            id: h.cy?.split(' ')?.[0],
+            name: h.cy?.split(' ')?.[1],
+            anonymous: h.sfzm === YES,
+        },
+    }))
+        .reduce((acc, cur) => {
+        if (!acc[cur.baseId]) {
+            acc[cur.baseId] = [];
+        }
+        acc[cur.baseId].push(cur);
+        return acc;
+    }, {});
+}
+async function parseHomeworkAtUrl(s, url) {
+    const response = await s.fetchWithToken(url);
+    const result = $(await response.text());
+    const fileDivs = result('div.list.fujian.clearfix');
+    return {
+        description: trimAndDefine(result('div.list.calendar.clearfix > div.fl.right > div.c55').slice(0, 1).html()),
+        answerContent: trimAndDefine(result('div.list.calendar.clearfix > div.fl.right > div.c55').slice(1, 2).html()),
+        submittedContent: trimAndDefine($(result('div.boxbox').slice(1, 2).toArray())('div.right').slice(2, 3).html()),
+        attachment: parseHomeworkFile(s, fileDivs[0]),
+        answerAttachment: parseHomeworkFile(s, fileDivs[1]),
+        submittedAttachment: parseHomeworkFile(s, fileDivs[2]),
+        gradeAttachment: parseHomeworkFile(s, fileDivs[3]),
+    };
+}
+/**
+ * Get the detail of one homework or excellent homework: its page (answer, submitted content, attachments) and the
+ * description JSON (which wins for `description`). 2 requests.
+ */
+export async function getHomeworkDetail(s, homework) {
+    const [page, description] = await Promise.all([
+        parseHomeworkAtUrl(s, homework.url),
+        getHomeworkDescription(s, homework.baseId),
+    ]);
+    return { ...page, ...description };
+}
+async function getHomeworkDescription(s, baseId) {
+    const json = await (await s.fetchWithToken(URLS.LEARN_HOMEWORK_DETAIL, {
+        method: 'POST',
+        body: URLS.LEARN_HOMEWORK_DETAIL_FORM_DATA(baseId),
+    })).json();
+    if (json.result !== 'success') {
+        throw {
+            reason: FailReason.INVALID_RESPONSE,
+            extra: json,
+        };
+    }
+    return {
+        description: trimAndDefine(json.msg),
+    };
+}
+function parseHomeworkFile(s, fileDiv) {
+    const fileNode = $(fileDiv)('.ftitle').children('a')[0] ?? $(fileDiv)('.fl').children('a')[0];
+    if (fileNode !== undefined) {
+        const size = trimAndDefine($(fileDiv)('.fl > span[class^="color"]').first().text());
+        const params = new URLSearchParams(fileNode.attribs.href.split('?').slice(-1)[0]);
+        const attachmentId = params.get('fileId');
+        // so dirty here...
+        let downloadUrl = URLS.LEARN_PREFIX + fileNode.attribs.href;
+        if (params.has('downloadUrl')) {
+            downloadUrl = URLS.LEARN_PREFIX + params.get('downloadUrl');
+        }
+        return {
+            id: attachmentId,
+            name: fileNode.children[0].data,
+            downloadUrl,
+            previewUrl: URLS.LEARN_FILE_PREVIEW(ContentType.HOMEWORK, attachmentId, CourseType.STUDENT, s.previewFirstPage),
+            size,
+        };
+    }
+    else {
+        return undefined;
+    }
+}
+export async function submitHomework(s, id, content = '', attachment, removeAttachment = false) {
+    const json = await (await s.fetchWithToken(URLS.LEARN_HOMEWORK_SUBMIT(), {
+        method: 'POST',
+        body: URLS.LEARN_HOMEWORK_SUBMIT_FORM_DATA(id, content, attachment, removeAttachment),
+    })).json();
+    if (json.result !== 'success') {
+        return Promise.reject({
+            reason: FailReason.OPERATION_FAILED,
+            extra: json,
+        });
+    }
+}
+//# sourceMappingURL=homework.js.map

package/lib/homework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"homework.js","sourceRoot":"","sources":["../src/homework.ts"],"names":[],"mappings":"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"}

package/lib/index.d.ts

@@ -0,0 +1,134 @@
+import type { AllContentsOptions, AllContentsResult, CalendarOptions, CalendarResult, CourseListOptions, ExcellentHomework, HomeworkListOptions, IHomeworkDetail, NotificationListOptions, RemoteFile, CommentItem, CourseInfo, Discussion, FavoriteItem, File, FileCategory, HelperConfig, Homework, HomeworkTA, IHomeworkSubmitAttachment, Language, Notification, Question, Questionnaire, SemesterInfo, UserInfo, ContentType } from './types.ts';
+import { CourseType } from './types.ts';
+export { addCSRFTokenToUrl } from './request.ts';
+export * from './types.ts';
+/** the main helper class */
+export declare class Learn2018Helper {
+    #private;
+    /** you can provide a CookieJar and / or CredentialProvider in the configuration */
+    constructor(config?: HelperConfig);
+    /** whether preview URLs open the first page only (`HelperConfig.generatePreviewUrlForFirstPage`) */
+    get previewFirstPage(): boolean;
+    set previewFirstPage(value: boolean);
+    /** fetch CSRF token from helper (invalid after login / re-login), might be '' if not logged in */
+    getCSRFToken(): string;
+    /** manually set CSRF token (useful when you want to reuse previous token) */
+    setCSRFToken(csrfToken: string): void;
+    /**
+     * If using alternative cookie management systems,
+     * be sure to clear id.tsinghua.edu.cn cookies before calling this function
+     */
+    getRoamingTicket(username: string, password: string, fingerPrint: string, fingerGenPrint?: string, fingerGenPrint3?: string): Promise<string>;
+    /**
+     * Login is necessary if you do not provide a `CredentialProvider`.
+     * Without credentials it uses the provider, and concurrent calls share one SSO login.
+     */
+    login(username?: string, password?: string, fingerPrint?: string, fingerGenPrint?: string, fingerGenPrint3?: string): Promise<void>;
+    /**
+     * Make sure the session is usable without a full SSO login when possible: with a CSRF token (from an earlier login
+     * or `setCSRFToken`), make one cheap request and log in again only if the session has expired; without one, log in.
+     * Use it when resuming an app instead of `login()`.
+     */
+    ensureSession(): Promise<void>;
+    /**  logout (to make everyone happy) */
+    logout(): Promise<void>;
+    /** get user's name and department */
+    getUserInfo(courseType?: CourseType): Promise<UserInfo>;
+    /**
+     * Get calendar items during the specified period (in yyyymmdd format, both inclusive).
+     * Ranges longer than 28 days are fetched in windows and merged; windows that fail even after a retry are listed in
+     * `failedRanges`. Rejects only when every window fails (usually with `FailReason.INVALID_RESPONSE`).
+     */
+    getCalendar(startDate: string, endDate: string, options?: CalendarOptions): Promise<CalendarResult>;
+    getSemesterIdList(): Promise<string[]>;
+    getCurrentSemester(): Promise<SemesterInfo>;
+    /**
+     * Get all courses in the specified semester.
+     * `timeAndLocation` is only fetched (one request per course) with `options.timeAndLocation`.
+     */
+    getCourseList(semesterID: string, courseType?: CourseType, lang?: Language, options?: CourseListOptions): Promise<CourseInfo[]>;
+    /** Get the time and location of one course. */
+    getCourseTimeAndLocation(courseID: string): Promise<string[]>;
+    /**
+     * Get certain type of content of all specified courses.
+     * It wraps around the `getXXX` list functions; a course that fails is reported in `errors` instead of failing
+     * the rest. `options.details` is passed on as homework `details` or notification `attachments`.
+     */
+    getAllContents<T extends ContentType>(courseIDs: string[], type: T, options?: AllContentsOptions<T>): Promise<AllContentsResult<T>>;
+    /**
+     * Get all notifications （课程公告） of the specified course.
+     * Attachments are only fetched (one request per notice) for the notices `options.attachments` selects;
+     * use `getNotificationAttachment` for the others.
+     */
+    getNotificationList(courseID: string, courseType?: CourseType, options?: NotificationListOptions): Promise<Notification[]>;
+    /** Get the attachment of a notice (one request), `undefined` if it has none. */
+    getNotificationAttachment(notification: Pick<Notification, 'url' | 'attachmentName'>, courseType?: CourseType): Promise<RemoteFile | undefined>;
+    /** Get all files （课程文件） of the specified course. */
+    getFileList(courseID: string, courseType?: CourseType): Promise<File[]>;
+    /** Get file categories of the specified course. */
+    getFileCategoryList(courseID: string, courseType?: CourseType): Promise<FileCategory[]>;
+    /**
+     * Get all files of the specified category of the specified course.
+     * Note: this cannot get correct `visitCount` and `downloadCount` for student
+     */
+    getFileListByCategory(courseID: string, categoryId: string, courseType?: CourseType): Promise<File[]>;
+    /**
+     * Get all homeworks （课程作业） of the specified course, with the excellent homework list (without details).
+     * Details (page + description, two requests per homework) are only fetched for the homework `options.details`
+     * selects; use `getHomeworkDetail` for the others.
+     */
+    getHomeworkList(courseID: string): Promise<Homework[]>;
+    getHomeworkList(courseID: string, courseType: CourseType.STUDENT, options?: HomeworkListOptions): Promise<Homework[]>;
+    getHomeworkList(courseID: string, courseType: CourseType.TEACHER): Promise<HomeworkTA[]>;
+    /** Get the detail (page content, attachments and description) of one homework. */
+    getHomeworkDetail(item: Pick<Homework, 'url' | 'baseId'>): Promise<IHomeworkDetail>;
+    /** Get the detail (page content, attachments and description) of one excellent homework. */
+    getExcellentHomeworkDetail(item: Pick<ExcellentHomework, 'url' | 'baseId'>): Promise<IHomeworkDetail>;
+    /** Get all discussions （课程讨论） of the specified course. */
+    getDiscussionList(courseID: string, courseType?: CourseType): Promise<Discussion[]>;
+    /**
+     * Get all notifications （课程答疑） of the specified course.
+     * The student version supports only answered questions, while the teacher version supports all questions.
+     */
+    getAnsweredQuestionList(courseID: string, courseType?: CourseType): Promise<Question[]>;
+    /**
+     * Get all questionnaires （课程问卷/QNR） of the specified course.
+     */
+    getQuestionnaireList(courseID: string): Promise<Questionnaire[]>;
+    /**
+     * Add an item to favorites. (收藏)
+     */
+    addToFavorites(type: ContentType, id: string): Promise<void>;
+    /**
+     * Remove an item from favorites. (取消收藏)
+     */
+    removeFromFavorites(id: string): Promise<void>;
+    /**
+     * Get favorites. (我的收藏)
+     * If `courseID` or `type` is specified, only return favorites of that course or type.
+     */
+    getFavorites(courseID?: string, type?: ContentType): Promise<FavoriteItem[]>;
+    /**
+     * Pin a favorite item. (置顶)
+     */
+    pinFavoriteItem(id: string): Promise<void>;
+    /**
+     * Unpin a favorite item. (取消置顶)
+     */
+    unpinFavoriteItem(id: string): Promise<void>;
+    /**
+     * Set a comment. (备注)
+     * Set an empty string to remove the comment.
+     */
+    setComment(type: ContentType, id: string, content: string): Promise<void>;
+    /**
+     * Get comments. (我的备注)
+     * If `courseID` or `type` is specified, only return favorites of that course or type.
+     */
+    getComments(courseID?: string, type?: ContentType): Promise<CommentItem[]>;
+    sortCourses(courseIDs: string[]): Promise<void>;
+    submitHomework(id: string, content?: string, attachment?: IHomeworkSubmitAttachment, removeAttachment?: boolean): Promise<void>;
+    setLanguage(lang: Language): Promise<void>;
+    getCurrentLanguage(): Language;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/index.js

@@ -0,0 +1,219 @@
+import * as auth from './auth.js';
+import * as calendar from './calendar.js';
+import * as contents from './contents.js';
+import * as courses from './courses.js';
+import * as discussions from './discussions.js';
+import * as favorites from './favorites.js';
+import * as files from './files.js';
+import * as homework from './homework.js';
+import * as notices from './notices.js';
+import * as questionnaires from './questionnaires.js';
+import { Session } from './request.js';
+import { CourseType } from './types.js';
+import * as URLS from './urls.js';
+import * as user from './user.js';
+export { addCSRFTokenToUrl } from './request.js';
+export * from './types.js';
+/** the main helper class */
+export class Learn2018Helper {
+    #session;
+    /** you can provide a CookieJar and / or CredentialProvider in the configuration */
+    constructor(config) {
+        this.#session = new Session(config, () => auth.login(this.#session));
+    }
+    /** whether preview URLs open the first page only (`HelperConfig.generatePreviewUrlForFirstPage`) */
+    get previewFirstPage() {
+        return this.#session.previewFirstPage;
+    }
+    set previewFirstPage(value) {
+        this.#session.previewFirstPage = value;
+    }
+    /** fetch CSRF token from helper (invalid after login / re-login), might be '' if not logged in */
+    getCSRFToken() {
+        return this.#session.csrfToken;
+    }
+    /** manually set CSRF token (useful when you want to reuse previous token) */
+    setCSRFToken(csrfToken) {
+        this.#session.csrfToken = csrfToken;
+    }
+    /**
+     * If using alternative cookie management systems,
+     * be sure to clear id.tsinghua.edu.cn cookies before calling this function
+     */
+    async getRoamingTicket(username, password, fingerPrint, fingerGenPrint = '', fingerGenPrint3 = '') {
+        return auth.getRoamingTicket(this.#session, username, password, fingerPrint, fingerGenPrint, fingerGenPrint3);
+    }
+    /**
+     * Login is necessary if you do not provide a `CredentialProvider`.
+     * Without credentials it uses the provider, and concurrent calls share one SSO login.
+     */
+    async login(username, password, fingerPrint, fingerGenPrint, fingerGenPrint3) {
+        if (!username || !password || !fingerPrint)
+            return this.#session.relogin();
+        return auth.login(this.#session, username, password, fingerPrint, fingerGenPrint, fingerGenPrint3);
+    }
+    /**
+     * Make sure the session is usable without a full SSO login when possible: with a CSRF token (from an earlier login
+     * or `setCSRFToken`), make one cheap request and log in again only if the session has expired; without one, log in.
+     * Use it when resuming an app instead of `login()`.
+     */
+    async ensureSession() {
+        return this.#session.ensureSession(URLS.LEARN_CURRENT_SEMESTER());
+    }
+    /**  logout (to make everyone happy) */
+    async logout() {
+        return auth.logout(this.#session);
+    }
+    /** get user's name and department */
+    async getUserInfo(courseType = CourseType.STUDENT) {
+        return user.getUserInfo(this.#session, courseType);
+    }
+    /**
+     * Get calendar items during the specified period (in yyyymmdd format, both inclusive).
+     * Ranges longer than 28 days are fetched in windows and merged; windows that fail even after a retry are listed in
+     * `failedRanges`. Rejects only when every window fails (usually with `FailReason.INVALID_RESPONSE`).
+     */
+    async getCalendar(startDate, endDate, options) {
+        return calendar.getCalendar(this.#session, startDate, endDate, options);
+    }
+    async getSemesterIdList() {
+        return courses.getSemesterIdList(this.#session);
+    }
+    async getCurrentSemester() {
+        return courses.getCurrentSemester(this.#session);
+    }
+    /**
+     * Get all courses in the specified semester.
+     * `timeAndLocation` is only fetched (one request per course) with `options.timeAndLocation`.
+     */
+    async getCourseList(semesterID, courseType = CourseType.STUDENT, lang = this.#session.lang, options) {
+        return courses.getCourseList(this.#session, semesterID, courseType, lang, options);
+    }
+    /** Get the time and location of one course. */
+    async getCourseTimeAndLocation(courseID) {
+        return courses.getCourseTimeAndLocation(this.#session, courseID);
+    }
+    /**
+     * Get certain type of content of all specified courses.
+     * It wraps around the `getXXX` list functions; a course that fails is reported in `errors` instead of failing
+     * the rest. `options.details` is passed on as homework `details` or notification `attachments`.
+     */
+    async getAllContents(courseIDs, type, options) {
+        return contents.getAllContents(this.#session, courseIDs, type, options);
+    }
+    /**
+     * Get all notifications （课程公告） of the specified course.
+     * Attachments are only fetched (one request per notice) for the notices `options.attachments` selects;
+     * use `getNotificationAttachment` for the others.
+     */
+    async getNotificationList(courseID, courseType = CourseType.STUDENT, options) {
+        return notices.getNotificationList(this.#session, courseID, courseType, options);
+    }
+    /** Get the attachment of a notice (one request), `undefined` if it has none. */
+    async getNotificationAttachment(notification, courseType = CourseType.STUDENT) {
+        return notices.getNotificationAttachment(this.#session, notification, courseType);
+    }
+    /** Get all files （课程文件） of the specified course. */
+    async getFileList(courseID, courseType = CourseType.STUDENT) {
+        return files.getFileList(this.#session, courseID, courseType);
+    }
+    /** Get file categories of the specified course. */
+    async getFileCategoryList(courseID, courseType = CourseType.STUDENT) {
+        return files.getFileCategoryList(this.#session, courseID, courseType);
+    }
+    /**
+     * Get all files of the specified category of the specified course.
+     * Note: this cannot get correct `visitCount` and `downloadCount` for student
+     */
+    async getFileListByCategory(courseID, categoryId, courseType = CourseType.STUDENT) {
+        return files.getFileListByCategory(this.#session, courseID, categoryId, courseType);
+    }
+    async getHomeworkList(courseID, courseType = CourseType.STUDENT, options) {
+        return courseType === CourseType.TEACHER
+            ? homework.getHomeworkList(this.#session, courseID, CourseType.TEACHER)
+            : homework.getHomeworkList(this.#session, courseID, CourseType.STUDENT, options);
+    }
+    /** Get the detail (page content, attachments and description) of one homework. */
+    async getHomeworkDetail(item) {
+        return homework.getHomeworkDetail(this.#session, item);
+    }
+    /** Get the detail (page content, attachments and description) of one excellent homework. */
+    async getExcellentHomeworkDetail(item) {
+        return homework.getHomeworkDetail(this.#session, item);
+    }
+    /** Get all discussions （课程讨论） of the specified course. */
+    async getDiscussionList(courseID, courseType = CourseType.STUDENT) {
+        return discussions.getDiscussionList(this.#session, courseID, courseType);
+    }
+    /**
+     * Get all notifications （课程答疑） of the specified course.
+     * The student version supports only answered questions, while the teacher version supports all questions.
+     */
+    async getAnsweredQuestionList(courseID, courseType = CourseType.STUDENT) {
+        return discussions.getAnsweredQuestionList(this.#session, courseID, courseType);
+    }
+    /**
+     * Get all questionnaires （课程问卷/QNR） of the specified course.
+     */
+    async getQuestionnaireList(courseID) {
+        return questionnaires.getQuestionnaireList(this.#session, courseID);
+    }
+    /**
+     * Add an item to favorites. (收藏)
+     */
+    async addToFavorites(type, id) {
+        return favorites.addToFavorites(this.#session, type, id);
+    }
+    /**
+     * Remove an item from favorites. (取消收藏)
+     */
+    async removeFromFavorites(id) {
+        return favorites.removeFromFavorites(this.#session, id);
+    }
+    /**
+     * Get favorites. (我的收藏)
+     * If `courseID` or `type` is specified, only return favorites of that course or type.
+     */
+    async getFavorites(courseID, type) {
+        return favorites.getFavorites(this.#session, courseID, type);
+    }
+    /**
+     * Pin a favorite item. (置顶)
+     */
+    async pinFavoriteItem(id) {
+        return favorites.pinFavoriteItem(this.#session, id);
+    }
+    /**
+     * Unpin a favorite item. (取消置顶)
+     */
+    async unpinFavoriteItem(id) {
+        return favorites.unpinFavoriteItem(this.#session, id);
+    }
+    /**
+     * Set a comment. (备注)
+     * Set an empty string to remove the comment.
+     */
+    async setComment(type, id, content) {
+        return favorites.setComment(this.#session, type, id, content);
+    }
+    /**
+     * Get comments. (我的备注)
+     * If `courseID` or `type` is specified, only return favorites of that course or type.
+     */
+    async getComments(courseID, type) {
+        return favorites.getComments(this.#session, courseID, type);
+    }
+    async sortCourses(courseIDs) {
+        return courses.sortCourses(this.#session, courseIDs);
+    }
+    async submitHomework(id, content = '', attachment, removeAttachment = false) {
+        return homework.submitHomework(this.#session, id, content, attachment, removeAttachment);
+    }
+    async setLanguage(lang) {
+        return user.setLanguage(this.#session, lang);
+    }
+    getCurrentLanguage() {
+        return this.#session.lang;
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/lib/notices.d.ts

@@ -0,0 +1,14 @@
+import type { Session } from './request.ts';
+import type { INotification, Notification, NotificationListOptions, RemoteFile } from './types.ts';
+import { CourseType } from './types.ts';
+/**
+ * Get all notifications （课程公告） of the specified course: current and expired lists.
+ * Attachments only for the notices `options.attachments` selects.
+ */
+export declare function getNotificationList(s: Session, courseID: string, courseType?: CourseType, options?: NotificationListOptions): Promise<Notification[]>;
+/**
+ * Get the attachment of a notice from its detail page (1 request), or `undefined` without a request if
+ * `attachmentName` says it has none.
+ */
+export declare function getNotificationAttachment(s: Session, notification: Pick<INotification, 'url' | 'attachmentName'>, courseType?: CourseType): Promise<RemoteFile | undefined>;
+//# sourceMappingURL=notices.d.ts.map

package/lib/notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notices.d.ts","sourceRoot":"","sources":["../src/notices.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACnG,OAAO,EAAe,UAAU,EAAc,MAAM,YAAY,CAAC;AAIjE;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,CAAC,EAAE,OAAO,EACV,QAAQ,EAAE,MAAM,EAChB,UAAU,GAAE,UAA+B,EAC3C,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,YAAY,EAAE,CAAC,CAWzB;AA0CD;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,CAAC,EAAE,OAAO,EACV,YAAY,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,GAAG,gBAAgB,CAAC,EAC3D,UAAU,GAAE,UAA+B,GAC1C,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAiCjC"}