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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019-2022 Harry Chen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,325 @@
-# Temporary Holding Version
+# thu-learn-lib
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![Check](https://github.com/robertying/thu-learn-lib/actions/workflows/check.yml/badge.svg)](https://github.com/robertying/thu-learn-lib/actions/workflows/check.yml)
+[![npm version](https://img.shields.io/npm/v/@robertying/thu-learn-lib)](https://www.npmjs.com/package/@robertying/thu-learn-lib)
+
+This is a JavaScript library aimed to provide a program-friendly interface of [web Learning of Tsinghua University](https://learn.tsinghua.edu.cn).
+
+This is [robertying](https://github.com/robertying)'s fork of [Harry-Chen/thu-learn-lib](https://github.com/Harry-Chen/thu-learn-lib), maintained for [learnX](https://github.com/robertying/learnX) and published as `@robertying/thu-learn-lib`.
+
+This project is licensed under MIT License.
+
+## Compatibility
+
+The library is ESM-only and uses [node-fetch-native](https://github.com/unjs/node-fetch-native) with [fetch-cookie](https://github.com/valeriangalliat/fetch-cookie) for cookie and redirect support. It runs in Node and in React Native; you can also pass your own `fetch` in `HelperConfig`.
+
+## Installation
+
+```bash
+pnpm add @robertying/thu-learn-lib
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm typecheck
+pnpm lint
+pnpm format
+pnpm test
+pnpm build # emits ESM + .d.ts to lib/
+```
+
+The code is split by area under `src/`: `request.ts` (session, CSRF token, re-login), `auth.ts`, `courses.ts`, `notices.ts`, `files.ts`, `homework.ts`, `discussions.ts`, `questionnaires.ts`, `favorites.ts`, `calendar.ts`, `contents.ts` and `user.ts`. `index.ts` holds the public `Learn2018Helper` class, which passes its private session to those functions.
+
+Linting uses type-aware [oxlint](https://oxc.rs/docs/guide/usage/linter) and formatting uses [oxfmt](https://oxc.rs/docs/guide/usage/formatter).
+
+## Releasing
+
+Bump `version` in `package.json`, merge, then push a matching tag (for example `git tag v4.1.0 && git push origin v4.1.0`). The Release workflow checks, builds, publishes to npm with provenance (npm trusted publishing, no token) and creates a GitHub release.
+
+## Usage
+
+### Authentication related (important changes since v1.2.0)
+
+```typescript
+import { Learn2018Helper } from '@robertying/thu-learn-lib';
+
+// There are three ways of logging in:
+
+// 1. provide a cookie jar with existing cookies (see `tough-cookie`)
+const helper = new Learn2018Helper({ cookieJar });
+// 2. provide nothing, and call login with your credentials
+const helper = new Learn2018Helper();
+// 3. provide a CredentialProvider function, which can be async
+const helper = new Learn2018Helper({
+  provider: () => ({ username, password, fingerPrint }),
+});
+
+// `fingerPrint` (and optionally `fingerGenPrint`, `fingerGenPrint3`) is the device fingerprint that
+// id.tsinghua.edu.cn asks for; login fails with `NO_CREDENTIAL` without it.
+
+// With the first two methods the session may time out. With a CredentialProvider the library logs in
+// again and retries once when a request finds the session expired, so we strongly recommend it.
+
+// Without a CredentialProvider you must log in yourself. With one, the first request logs in.
+try {
+  await helper.login(username, password, fingerPrint);
+} catch (e) {
+  // e is an ApiError: check e.reason (a FailReason) and e.extra
+}
+
+// To reuse cookies elsewhere (e.g. for file download), pass your own cookie jar in the config.
+
+// Logout if you want, but the cookie jar will not be cleared.
+await helper.logout();
+```
+
+### Content related
+
+We currently support both student and teacher (or TA) version of web learning. To keep backwards compatibility, the **default behavior of all APIs is to use the student version**. The following APIs needs `CourseType.TEACHER` as the last (optional) parameter to access the teacher version. You **should use them when you are the teacher / TA** of one course, for you will get nothing from the student version in that case.
+
+We do not maintain a global type in `Learn2018Helper` class, for there can be the situation that one can be a student and teacher of the same course simultaneously, on which by using different `CourseType` you can get different results.
+
+- `getCourseList`
+- `getNotificationList/getFileList/getHomeworkList/getDiscussionList/getAnsweredQuestionList`
+- `getAllContents`
+
+Note that currently fetching homework information from teacher version is **partially implemented**.
+
+```typescript
+import { ContentType, ApiError } from '@robertying/thu-learn-lib';
+
+// get ids of all semesters that current account has access to
+const semesters = await helper.getSemesterIdList();
+
+// get get semester info
+const semester = await helper.getCurrentSemester();
+
+// get courses of this semester
+const courses = await helper.getCourseList(semester.id);
+const course = courses[0];
+
+// get detail information about the course
+const discussions = await helper.getDiscussionList(course.id);
+const notifications = await helper.getNotificationList(course.id);
+const files = await helper.getFileList(course.id);
+const homework = await helper.getHomeworkList(course.id);
+const questions = await helper.getAnsweredQuestionList(course.id);
+
+// get content from bunches of courses
+// the return type will be { [id: string]: Content }
+// where Content = Notification | File | Homework | Discussion | Question
+const homeworks = await helper.getAllContents([1, 2, 3], ContentType.HOMEWORK);
+
+// get course calendar in a period (yyyymmdd, inclusive)
+// ranges over 28 days are fetched in windows; windows that fail even after a retry are in failedRanges
+try {
+  const { events, failedRanges } = await helper.getCalendar('20191001', '20191201', { graduate: false });
+} catch (e) {
+  // every window failed
+  const error = e as ApiError;
+  // check e.reason and e.extra for information
+}
+```
+
+Browsers block these cross-origin requests (CORS), so run the library in Node.js or React Native.
+
+## Typing
+
+See `src/types.ts` for type definitions. Note that `ApiError` represents the type that will be used in rejected Promises.
+
+## Testing
+
+`pnpm test` runs the offline tests. They give the helper a fake `fetch` (`test/helpers/fake-server.ts`) that serves hand-written responses shaped like Web Learning's, simulates SSO login and session expiry, and records every request so tests can also check how many requests an API makes.
+
+`pnpm test:live` runs the tests against the real server. It needs your own credentials: copy `test/live/template.env` to `test/live/.env` and fill it in.
+
+## Changelog
+
+- v4.1.0
+  - Published as `@robertying/thu-learn-lib`
+  - Tooling: pnpm, TypeScript 7 (`tsc` ESM + `.d.ts` build), oxlint + oxfmt, Vitest 5, Node 26
+  - (_BREAKING CHANGE_) Drop the IIFE browser build and the browser-extension demo
+  - Code split into modules, with offline tests
+  - No API changes
+- v4.0.0
+  - Upgrade cheerio to 1.0
+  - Add support for questionnaire (add `getQuestionnaireList` API and some public types)
+  - Add support for managing favorite items
+  - Add support for sorting courses (i.e. manage the order on web learning)
+  - Add support for managing comments on content (e.g. files, notifications)
+  - (_BREAKING CHANGE_) Deprecate usage of `studentHomeworkId`
+- v3.2.1
+  - Upgrade to eslint v9
+  - Add `setCSRFToken` function to manually reuse previous (maybe valid) token and prevent unnecessary re-login (see [#49](https://github.com/Harry-Chen/thu-learn-lib/issues/49))  
+    _Note:_ To use this feature in Node.js, `cookieJar` should also be reused, otherwise it will not work. (not the case in browser env)
+  - Fix `CourseContent` type: default value for type param `T` (breaking change introduced in [#53](https://github.com/Harry-Chen/thu-learn-lib/issues/53))
+  - _(Breaking...?)_ Rename `File.id2` added in previous version to actual `id` and previously used `id` to `fileId` (see [#60](https://github.com/Harry-Chen/thu-learn-lib/issues/60))
+  - Upgrade dependencies
+- v3.2.0
+  - Support file categories (see [#57](https://github.com/Harry-Chen/thu-learn-lib/issues/57)):
+    - Add `FileCategory` type and optional `category` field in `File` type
+    - Now `getFileList` function automatically fetches all categories and saves them in each `File` object
+    - Add `getFileCategoryList` function to fetch file categories
+    - Add `getFileListByCategory` function to get file list by category
+  - Fix content of file download url and visit count in for `CourseType.TEACHER`
+- v3.1.4
+  - Allow and check for undefined credential in login (see [#52](https://github.com/Harry-Chen/thu-learn-lib/issues/52))
+  - Discriminate `getAllContents` return type based on input content type (see [#53](https://github.com/Harry-Chen/thu-learn-lib/issues/53))
+  - Use `searchParams` to set csrf token & add csrf token to `getCalendar` (see [#54](https://github.com/Harry-Chen/thu-learn-lib/issues/54))
+  - Update bunches of dependencies
+- v3.1.3
+  - Fix empty time and location of course (see [#145](https://github.com/Harry-Chen/Learn-Helper/issues/145))
+- v3.1.2
+  - Fix empty course name parsing
+  - (Maybe BEARKING) `Homework.gradeLevel` changed to `HomeworkGradeLevel` (a string enum) for better i18n
+  - Fix get language
+- v3.1.1
+  - Remove `fetch-cookie` dependency in browser build, reducing bundle size
+  - Add `getUserInfo` interface (#48, thanks to @robertying)
+- v3.1.0
+  - **Refactor**:
+    - Build tool: `webpack` -> `tsup`
+    - Development tool: `webpack` -> `vite`
+    - Test tool: `jest` -> `vitest`
+    - Fetch:
+      - `cross-fetch` -> `node-fetch-native` (Node.js now has native `fetch`)
+      - `real-isomorphic-fetch` -> `fetch-cookie` (`fetch-cookie` now can handle redirects)
+      - `tough-cookie-no-native` -> `tough-cookie` (`tough-cookie` is now native)
+    - **(BREAKING)** Updated library output structure, now everything exported in index, cannot use `/lib` or `/lib/types` anymore
+  - Added:
+    - Submit homework
+    - Language switching and related behaviour
+    - Get TA's homework info (partial support)
+  - Fixed:
+    - **Web Learning API update**
+    - Decode course name
+  - Other:
+    - Move `fake-parse5` to [a seperate library](https://github.com/AsakuraMizu/fake-parse5)
+- v3.0.4
+  - No feature changes, upgrade dependencies
+- v3.0.3
+  - No feature changes, upgrade dependencies
+- v3.0.2
+  - No feature changes, upgrade dependencies to mitigate security vulnerabilities
+- v3.0.1
+  - Add config `generatePreviewUrlForFirstPage` to switch preview URL type (default to `true`)
+- v3.0.0
+  - (BREAKING CHANGE) Redesign exported types, use `RemoteFile` to represent a file on Web Learning
+  - Add support for parsing attachment sizes & preview URLs in homework & notifications (Harry-Chen/Learn-Helper#109)
+- v2.5.4
+  - Fix (sometimes) incorrect publish time of notifications (#36)
+- v2.5.3
+  - Add `allowFailure` in `getAllContents` for convenience
+- v2.5.2
+  - Allow retrieving CSRF token via `getCSRFToken` method
+  - Export `addCSRFTokenToUrl` function as API for convenience
+- v2.5.1
+  - No feature change, add support for direct `import` in Node.js
+- v2.5.0
+  - Add transparent support for CSRF token (recently deployed) in all Web Learning APIs
+- v2.4.2
+  - No functionality change, bump some dependencies to mitigate security concerns
+- v2.4.1
+  - Replace `parse5` with `htmlparser2` in Cheerio and remove it from bundled file (replaced with `src/fake-parse5`)
+  - Replace TSLint with ESLint
+- v2.4.0
+  - Upgrade to TypeScript 4.1 & Webpack 5.15
+  - Add more null checking for disabled functionalities (see [xxr3376/Learn-Project#90](https://github.com/xxr3376/Learn-Project/issues/90))
+- v2.3.2
+  - Fix a problem in `v2.3.1` (not published) and `v2.3.0` that build output fails to be uploaded to npm
+- v2.3.0
+  - Refine error detecting & handling by using `ApiError` in usage of `Promise.reject` (might be a breaking change)
+- v2.2.3
+  - Add workaround for some strange behaviors in teacher mode (thanks to @MashPlant)
+- v2.2.2
+  - Return error when API return any non-success result
+- v2.2.1
+  - Fix a missing parameter in `previewUrl`
+- v2.2.0
+  - Use ECMAScript private fields in `Learn2018Helper` class to protect credentials
+  - Add `previewUrl` to `File`
+  - Upgrade to TypeScript 3.8.2
+- v2.1.2
+  - Fix problem in invoking JSONP callback (because some engines might do JIT)
+- v2.1.1
+  - Remove usage of `eval` in `getCalendar`
+- v2.1.0
+  - Catch errors returned by calendar API and throw user-defined error
+  - Add documentation for all public APIs
+- v2.0.0
+  - Use ES2018 in generated library
+  - Add `FailReason` to represent all strings that will be used as the reason of rejected Promises
+  - `login` and `logout` no longer return Promises
+- v1.2.2
+  - Fix a function signature to keep compatibility
+- v1.2.1
+  - Support TA version of many APIs (see above for usage)
+  - Fix some wrong URLs in fetched data
+- v1.2.0
+  - Support getting course calendars from academic.tsinghua.edu.cn (thanks to robertying)
+  - Automatic retry logging in when fetching failed and `CredentialProvider` is provided (thanks to mayeths)
+  - Add unit tests using `jest` (thanks to mayeths)
+  - Filter out `null` values in `getSemesterIdList` API
+  - Switch to `https://learn.tsinghua.edu.cn/` from `learn2018` permanently
+- v1.1.4
+  - Return empty array if any content module is disabled
+  - Add `getTACourseList` to get TA's course list (temporarily can not be used by other functions)
+- v1.1.3
+  - Emergency fix of wrongly decoded base64 string, add `js-base64` back
+- v1.1.2
+  - Switch to `Base64.js` instead of `js-base64`, which uses evil `eval`
+- v1.1.1
+  - Decode HTML entities in the title of disscussions (the last one, I promise!)
+- v1.1.0
+  - Fix an typo in grade level mapping
+  - Bump to a new minor version
+- v1.0.16 (no v1.0.15 due to some publishing issues)
+  - Switch to `yarn`
+  - Add parsing of grade levels of homework (A+/A/.../F)
+- v1.0.14
+  - Add prefix for `attachmentUrl` filed of Notification
+  - Deprecate all old versions
+- v1.0.13
+  - Decode HTML entities whenever possible
+- v1.0.12
+  - Add `url` for Course
+  - Fix `url` for Question (to display correct section name)
+- v1.0.11
+  - Fix `url` error in Question
+- v1.0.10
+  - Decode the HTML entities in the `description` field of homework
+- v1.0.9
+  - Use `entities` to decode HTML entities
+- v1.0.8
+  - Export type CourseContent
+- v1.0.7
+  - No change made to code, update README
+- v1.0.6
+  - Add API to fetching content for a list of courses
+- v1.0.5
+  - Fix HTML entity replacement.
+- v1.0.4
+  - No change made to code
+  - Remove unused build commands
+  - Fix multiple typos in README
+- v1.0.3
+  - Add real logout API (thank @zhaofeng-shu33)
+- v1.0.2
+  - Add API to get IDs of all semesters (thank @jiegec)
+- v1.0.1
+  - Expose CookieJar in helper class
+  - Fix some HTML entity decoding problems
+  - **Rename of some APIs** (break compatibility before we have actual users)
+- v1.0.0
+  - First release
+  - Support parsing of notification, homework, file, discussion and **answered** questions
+
+## Projects using this library
+
+- [Harry-Chen/Learn Project](https://github.com/Harry-Chen/Learn-Project)
+- [jiegec/clone-learn-tsinghua](https://github.com/jiegec/clone-learn-tsinghua)
+- [robertying/learnX](https://github.com/robertying/learnX) (customized fork)
+- [Konano/thu-weblearn-tgbot](https://github.com/Konano/thu-weblearn-tgbot)
+- [Starrah/THUCourseHelper](https://github.com/Starrah/THUCourseHelper)

package/lib/auth.d.ts

@@ -0,0 +1,11 @@
+import type { Session } from './request.ts';
+/**
+ * If using alternative cookie management systems,
+ * be sure to clear id.tsinghua.edu.cn cookies before calling this function
+ */
+export declare function getRoamingTicket(s: Session, username: string, password: string, fingerPrint: string, fingerGenPrint?: string, fingerGenPrint3?: string): Promise<string>;
+/** login is necessary if you do not provide a `CredentialProvider` */
+export declare function login(s: Session, username?: string, password?: string, fingerPrint?: string, fingerGenPrint?: string, fingerGenPrint3?: string): Promise<void>;
+/**  logout (to make everyone happy) */
+export declare function logout(s: Session): Promise<void>;
+//# sourceMappingURL=auth.d.ts.map

package/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAM5C;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,CAAC,EAAE,OAAO,EACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,cAAc,GAAE,MAAW,EAC3B,eAAe,GAAE,MAAW,mBA4C7B;AAED,sEAAsE;AACtE,wBAAsB,KAAK,CACzB,CAAC,EAAE,OAAO,EACV,QAAQ,CAAC,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,MAAM,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC,CAyCf;AAED,uCAAuC;AACvC,wBAAsB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtD"}

package/lib/auth.js

@@ -0,0 +1,99 @@
+// Login to Web Learning through id.tsinghua.edu.cn (SSO) and logout.
+import { sm2 } from 'sm-crypto';
+import { $ } from './request.js';
+import { FailReason, Language } from './types.js';
+import * as URLS from './urls.js';
+/**
+ * If using alternative cookie management systems,
+ * be sure to clear id.tsinghua.edu.cn cookies before calling this function
+ */
+export async function getRoamingTicket(s, username, password, fingerPrint, fingerGenPrint = '', fingerGenPrint3 = '') {
+    // Make sure we always start with the form page
+    // More code is needed to handle the case where the user is already logged in (i.e. cookies are set)
+    // It won't be a problem if it is always the same user,
+    // but if the current cookies are from a different user than the one trying to log in,
+    // it will cause problems.
+    try {
+        await s.cookieJar.setCookie('JSESSIONID=; path=/; HttpOnly', URLS.ID_PREFIX);
+    }
+    catch (err) {
+        throw {
+            reason: FailReason.ERROR_SETTING_COOKIES,
+            extra: err,
+        };
+    }
+    try {
+        const loginForm = await s.rawFetch(URLS.ID_LOGIN());
+        const body = $(await loginForm.text());
+        const sm2publicKey = body('#sm2publicKey').text().trim();
+        const formData = new FormData();
+        formData.append('i_user', username);
+        formData.append('i_pass', '04' + sm2.doEncrypt(password, sm2publicKey));
+        formData.append('singleLogin', 'on');
+        formData.append('fingerPrint', fingerPrint);
+        formData.append('fingerGenPrint', fingerGenPrint ?? '');
+        formData.append('fingerGenPrint3', fingerGenPrint3 ?? '');
+        formData.append('i_captcha', '');
+        const checkResponse = await s.rawFetch(URLS.ID_LOGIN_CHECK(), {
+            method: 'POST',
+            body: formData,
+        });
+        const anchor = $(await checkResponse.text())('a');
+        const redirectUrl = anchor.attr('href');
+        const ticket = redirectUrl.split('=').slice(-1)[0];
+        return ticket;
+    }
+    catch (err) {
+        throw {
+            reason: FailReason.ERROR_FETCH_FROM_ID,
+            extra: err,
+        };
+    }
+}
+/** login is necessary if you do not provide a `CredentialProvider` */
+export async function login(s, username, password, fingerPrint, fingerGenPrint, fingerGenPrint3) {
+    if (!username || !password || !fingerPrint) {
+        if (!s.provider)
+            return Promise.reject({
+                reason: FailReason.NO_CREDENTIAL,
+            });
+        const credential = await s.provider();
+        username = credential.username;
+        password = credential.password;
+        fingerPrint = credential.fingerPrint;
+        fingerGenPrint = credential.fingerGenPrint;
+        fingerGenPrint3 = credential.fingerGenPrint3;
+        if (!username || !password || !fingerPrint) {
+            return Promise.reject({
+                reason: FailReason.NO_CREDENTIAL,
+            });
+        }
+    }
+    // check response from id.tsinghua.edu.cn
+    const ticket = await getRoamingTicket(s, username, password, fingerPrint, fingerGenPrint, fingerGenPrint3);
+    const loginResponse = await s.rawFetch(URLS.LEARN_AUTH_ROAM(ticket));
+    if (!loginResponse.ok) {
+        return Promise.reject({
+            reason: FailReason.ERROR_ROAMING,
+        });
+    }
+    const courseListPageSource = await (await s.rawFetch(URLS.LEARN_STUDENT_COURSE_LIST_PAGE())).text();
+    const tokenRegex = /^.*&_csrf=(\S*)".*$/gm;
+    const tokenMatches = [...courseListPageSource.matchAll(tokenRegex)];
+    if (tokenMatches.length === 0) {
+        return Promise.reject({
+            reason: FailReason.INVALID_RESPONSE,
+            extra: 'cannot fetch CSRF token from source',
+        });
+    }
+    s.csrfToken = tokenMatches[0][1];
+    const langRegex = /<script src="\/f\/wlxt\/common\/languagejs\?lang=(zh|en)"><\/script>/g;
+    const langMatches = [...courseListPageSource.matchAll(langRegex)];
+    if (langMatches.length !== 0)
+        s.lang = langMatches[0][1] === 'en' ? Language.EN : Language.ZH;
+}
+/**  logout (to make everyone happy) */
+export async function logout(s) {
+    await s.rawFetch(URLS.LEARN_LOGOUT(), { method: 'POST' });
+}
+//# sourceMappingURL=auth.js.map

package/lib/auth.js.map

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

package/lib/calendar.d.ts

@@ -0,0 +1,16 @@
+import type { Session } from './request.ts';
+import type { CalendarOptions, CalendarRange, CalendarResult } from './types.ts';
+/** The registrar often fails for ranges longer than about a month, so longer ranges are fetched in windows of this many days. */
+export declare const CALENDAR_WINDOW_DAYS = 28;
+/** Split an inclusive yyyymmdd range into consecutive inclusive windows of at most `days` days. */
+export declare function splitCalendarRange(startDate: string, endDate: string, days?: number): CalendarRange[];
+/**
+ * Get calendar items during the specified period (in yyyymmdd format, both inclusive).
+ *
+ * Ranges longer than `CALENDAR_WINDOW_DAYS` are fetched in consecutive windows (one at a time, each retried once) and
+ * merged in date order. Windows that still fail are listed in `failedRanges`, so callers can show partial data and
+ * retry only those. If every window fails, this rejects with the last error instead (usually
+ * `FailReason.INVALID_RESPONSE`). The result might be empty if the period is too far away from now.
+ */
+export declare function getCalendar(s: Session, startDate: string, endDate: string, options?: CalendarOptions): Promise<CalendarResult>;
+//# sourceMappingURL=calendar.d.ts.map

package/lib/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../src/calendar.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAiB,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKhG,iIAAiI;AACjI,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAevC,mGAAmG;AACnG,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,SAAuB,GAAG,aAAa,EAAE,CASnH;AAyBD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/lib/calendar.js

@@ -0,0 +1,81 @@
+// Course calendar from the registrar (academic.tsinghua.edu.cn).
+import { FailReason } from './types.js';
+import * as URLS from './urls.js';
+import { JSONP_EXTRACTOR_NAME, extractJSONPResult } from './utils.js';
+/** The registrar often fails for ranges longer than about a month, so longer ranges are fetched in windows of this many days. */
+export const CALENDAR_WINDOW_DAYS = 28;
+const DAY_MS = 24 * 60 * 60 * 1000;
+const parseDate = (date) => {
+    const match = /^(\d{4})(\d{2})(\d{2})$/.exec(date);
+    const time = match ? Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3])) : NaN;
+    if (Number.isNaN(time) || formatDate(time) !== date) {
+        throw { reason: FailReason.INVALID_RESPONSE, extra: `invalid date ${date}, expected yyyymmdd` };
+    }
+    return time;
+};
+const formatDate = (time) => new Date(time).toISOString().slice(0, 10).replaceAll('-', '');
+/** Split an inclusive yyyymmdd range into consecutive inclusive windows of at most `days` days. */
+export function splitCalendarRange(startDate, endDate, days = CALENDAR_WINDOW_DAYS) {
+    const start = parseDate(startDate);
+    const end = parseDate(endDate);
+    const ranges = [];
+    for (let from = start; from <= end; from += days * DAY_MS) {
+        const to = Math.min(from + (days - 1) * DAY_MS, end);
+        ranges.push({ startDate: formatDate(from), endDate: formatDate(to) });
+    }
+    return ranges;
+}
+async function fetchWindow(s, range, graduate) {
+    const response = await s.fetchWithToken(URLS.REGISTRAR_CALENDAR(range.startDate, range.endDate, graduate, JSONP_EXTRACTOR_NAME));
+    if (!response.ok) {
+        return Promise.reject({
+            reason: FailReason.INVALID_RESPONSE,
+        });
+    }
+    const result = extractJSONPResult(await response.text());
+    return result.map((i) => ({
+        location: i.dd,
+        status: i.fl,
+        startTime: i.kssj,
+        endTime: i.jssj,
+        date: i.nq,
+        courseName: i.nr,
+    }));
+}
+/**
+ * Get calendar items during the specified period (in yyyymmdd format, both inclusive).
+ *
+ * Ranges longer than `CALENDAR_WINDOW_DAYS` are fetched in consecutive windows (one at a time, each retried once) and
+ * merged in date order. Windows that still fail are listed in `failedRanges`, so callers can show partial data and
+ * retry only those. If every window fails, this rejects with the last error instead (usually
+ * `FailReason.INVALID_RESPONSE`). The result might be empty if the period is too far away from now.
+ */
+export async function getCalendar(s, startDate, endDate, options = {}) {
+    const graduate = options.graduate ?? false;
+    const ranges = splitCalendarRange(startDate, endDate);
+    if (ranges.length === 0)
+        return { events: [], failedRanges: [] };
+    const ticketResponse = await s.fetchWithToken(URLS.REGISTRAR_TICKET(), {
+        method: 'POST',
+        body: URLS.REGISTRAR_TICKET_FORM_DATA(),
+    });
+    let ticket = await ticketResponse.text();
+    ticket = ticket.substring(1, ticket.length - 1);
+    await s.fetch(URLS.REGISTRAR_AUTH(ticket));
+    const events = [];
+    const failedRanges = [];
+    let lastError;
+    for (const range of ranges) {
+        try {
+            events.push(...(await fetchWindow(s, range, graduate).catch(() => fetchWindow(s, range, graduate))));
+        }
+        catch (e) {
+            lastError = e;
+            failedRanges.push(range);
+        }
+    }
+    if (failedRanges.length === ranges.length)
+        throw lastError;
+    return { events, failedRanges };
+}
+//# sourceMappingURL=calendar.js.map

package/lib/calendar.js.map

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

package/lib/contents.d.ts

@@ -0,0 +1,9 @@
+import type { Session } from './request.ts';
+import type { CourseContent } from './types.ts';
+import { ContentType, CourseType } from './types.ts';
+/**
+ * Get certain type of content of all specified courses.
+ * It actually wraps around other `getXXX` functions. You can ignore the failure caused by certain courses.
+ */
+export declare function getAllContents<T extends ContentType>(s: Session, courseIDs: string[], type: T, courseType?: CourseType, allowFailure?: boolean): Promise<CourseContent<T>>;
+//# sourceMappingURL=contents.d.ts.map

package/lib/contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.d.ts","sourceRoot":"","sources":["../src/contents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAOjE;;;GAGG;AACH,wBAAsB,cAAc,CAAC,CAAC,SAAS,WAAW,EACxD,CAAC,EAAE,OAAO,EACV,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,EAAE,CAAC,EACP,UAAU,GAAE,UAA+B,EAC3C,YAAY,UAAQ,6BA8CrB"}

package/lib/contents.js

@@ -0,0 +1,52 @@
+// One kind of content for many courses at once.
+import { ContentType, CourseType, FailReason } from './types.js';
+import { getAnsweredQuestionList, getDiscussionList } from './discussions.js';
+import { getFileList } from './files.js';
+import { getHomeworkList } from './homework.js';
+import { getNotificationList } from './notices.js';
+import { getQuestionnaireList } from './questionnaires.js';
+/**
+ * Get certain type of content of all specified courses.
+ * It actually wraps around other `getXXX` functions. You can ignore the failure caused by certain courses.
+ */
+export async function getAllContents(s, courseIDs, type, courseType = CourseType.STUDENT, allowFailure = false) {
+    const fetchContentForCourse = (id) => {
+        switch (type) {
+            case ContentType.NOTIFICATION:
+                return getNotificationList(s, id, courseType);
+            case ContentType.FILE:
+                return getFileList(s, id, courseType);
+            case ContentType.HOMEWORK:
+                return getHomeworkList(s, id);
+            case ContentType.DISCUSSION:
+                return getDiscussionList(s, id, courseType);
+            case ContentType.QUESTION:
+                return getAnsweredQuestionList(s, id, courseType);
+            case ContentType.QUESTIONNAIRE:
+                return getQuestionnaireList(s, id);
+            default:
+                return Promise.reject({
+                    reason: FailReason.NOT_IMPLEMENTED,
+                    extra: 'Unknown content type',
+                });
+        }
+    };
+    const contents = {};
+    const results = await Promise.allSettled(courseIDs.map(async (id) => {
+        contents[id] = await fetchContentForCourse(id);
+    }));
+    if (!allowFailure) {
+        for (const r of results) {
+            if (r.status === 'rejected') {
+                return Promise.reject({
+                    reason: FailReason.INVALID_RESPONSE,
+                    extra: {
+                        reason: r.reason,
+                    },
+                });
+            }
+        }
+    }
+    return contents;
+}
+//# sourceMappingURL=contents.js.map

package/lib/contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contents.js","sourceRoot":"","sources":["../src/contents.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAIhD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,CAAU,EACV,SAAmB,EACnB,IAAO,EACP,UAAU,GAAe,UAAU,CAAC,OAAO,EAC3C,YAAY,GAAG,KAAK;IAEpB,MAAM,qBAAqB,GAAG,CAAC,EAAU,EAAE,EAAE;QAC3C,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,WAAW,CAAC,YAAY;gBAC3B,OAAO,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAiC,CAAC;YAChF,KAAK,WAAW,CAAC,IAAI;gBACnB,OAAO,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAiC,CAAC;YACxE,KAAK,WAAW,CAAC,QAAQ;gBACvB,OAAO,eAAe,CAAC,CAAC,EAAE,EAAE,CAAiC,CAAC;YAChE,KAAK,WAAW,CAAC,UAAU;gBACzB,OAAO,iBAAiB,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAiC,CAAC;YAC9E,KAAK,WAAW,CAAC,QAAQ;gBACvB,OAAO,uBAAuB,CAAC,CAAC,EAAE,EAAE,EAAE,UAAU,CAAiC,CAAC;YACpF,KAAK,WAAW,CAAC,aAAa;gBAC5B,OAAO,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAiC,CAAC;YACrE;gBACE,OAAO,OAAO,CAAC,MAAM,CAAC;oBACpB,MAAM,EAAE,UAAU,CAAC,eAAe;oBAClC,KAAK,EAAE,sBAAsB;iBAC9B,CAAC,CAAC;QACP,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAqB,EAAE,CAAC;IAEtC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;QACzB,QAAQ,CAAC,EAAE,CAAC,GAAG,MAAM,qBAAqB,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CACH,CAAC;IAEF,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAC5B,OAAO,OAAO,CAAC,MAAM,CAAC;oBACpB,MAAM,EAAE,UAAU,CAAC,gBAAgB;oBACnC,KAAK,EAAE;wBACL,MAAM,EAAE,CAAC,CAAC,MAAM;qBACjB;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}