menuNo 지원

Author: hyeongukryu

README.md

@@ -7,4 +7,8 @@
 npm install kaist-today-notice
 ```
 
-- 차세대 포탈을 지원하는 버전의 사용 방법은 아직 작성되지 않았습니다.
+- 차세대 포탈을 지원하는 버전의 자세한 사용 방법은 아직 작성되지 않았습니다.
+
+- 간편 로그인은 사용자 이름만 있으면 통과할 수 있어서 승인 절차까지 자동화하는 경우 위험할 수 있으므로, 이메일 인증 번호를 사용하는 방식만 구현하고 있습니다.
+
+- 로그인을 병렬로 동시 진행하면 마지막에 이메일로 전송된 OTP만 유효하며, 실패 시 Error가 발생(throw)합니다. `login`에서 발생할 수 있는 오류를 catch해야 하며, 가급적 외부에서 잠금을 구현하거나 적절한 백오프를 적용하십시오. `loginWithRetry`는 단순한 백오프 전략을 제공합니다.

auth.ts

@@ -107,8 +107,11 @@ async function loginToPortal(ssoCode: string) {
     }
 }
 
-// eslint-disable-next-line import/prefer-default-export
-export async function login(username: string, password: string, getOtp: () => Promise<string>) {
+export async function login(
+    username: string,
+    password: string,
+    getOtp: () => Promise<string>,
+): Promise<string> {
     await cookieJar.removeAllCookies();
 
     await loginUsingPassword(username, password);
@@ -121,3 +124,26 @@ export async function login(username: string, password: string, getOtp: () => Pr
 
     return cookieJar.getCookieStringSync('https://portal.kaist.ac.kr');
 }
+
+export async function loginWithRetry(
+    username: string,
+    password: string,
+    getOtp: () => Promise<string>,
+): ReturnType<typeof login> {
+    const backoffSeconds = [15, 30, 30, 60, 60];
+    const getJitter = () => Math.random() * 15;
+
+    for (; ;) {
+        try {
+            // eslint-disable-next-line no-await-in-loop
+            return await login(username, password, getOtp);
+        } catch (e) {
+            if (backoffSeconds.length === 0) {
+                throw e;
+            }
+            const delay = backoffSeconds.shift()! + getJitter();
+            // eslint-disable-next-line no-await-in-loop
+            await new Promise((resolve) => { setTimeout(resolve, delay * 1000); });
+        }
+    }
+}

fetch.ts

@@ -1,5 +1,6 @@
 export interface KaistTodayNoticeFetchOptions {
     cookie: string;
+    menuNo?: number;
     size?: number;
     lang?: 'ko' | 'en';
 }
@@ -39,13 +40,15 @@ export async function fetchPosts(
 ): Promise<KaistTodayNotice[] | null> {
     const size = options.size ?? 10;
     const lang = options.lang ?? 'ko';
+    const menuNo = options.menuNo ?? 0;
 
     const boards = await getBoards(options.cookie);
     const getBoard = (boardId: number) => boards.find((board) => board.boardId === boardId);
 
     const url = new URL('/wz/api/board/recents', 'https://portal.kaist.ac.kr/');
     url.searchParams.append('recordCountPerPage', size.toString());
     url.searchParams.append('lang', lang);
+    url.searchParams.append('menuNo', menuNo.toString());
 
     const response = await fetch(
         url,

package-lock.json

@@ -1,12 +1,11 @@
 {
   "name": "kaist-today-notice",
-  "version": "8.0.0",
+  "version": "8.0.1",
   "description": "KAIST 오늘의 공지사항",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
-    ".": "./dist/index.js",
-    "./auth": "./dist/auth.js"
+    ".": "./dist/index.js"
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",