feat(leetcode.com): add user_progress_questions method to retrieve user progress with filters

Author: jinzcdev

src/_tests/leetcode.test.ts

@@ -3,6 +3,7 @@ import { beforeAll, describe, expect, it } from "vitest";
 import { Cache } from "../cache";
 import { Credential } from "../credential";
 import { LeetCode } from "../leetcode";
+import { QuestionStatusEnum } from "../leetcode-cn";
 
 describe("LeetCode", { timeout: 15_000 }, () => {
     describe("General", () => {
@@ -125,5 +126,29 @@ describe("LeetCode", { timeout: 15_000 }, () => {
                 expect(submission.runtime).toBe(200);
             },
         );
+
+        it.skipIf(!process.env["TEST_LEETCODE_SESSION"])(
+            "should be able to get user progress questions",
+            async () => {
+                const progress = await lc.user_progress_questions({
+                    skip: 0,
+                    limit: 10,
+                });
+                expect(progress).toBeDefined();
+                expect(progress.questions.length).toBeLessThanOrEqual(10);
+
+                const progressWithQuestionStatus = await lc.user_progress_questions({
+                    skip: 0,
+                    limit: 10,
+                    questionStatus: QuestionStatusEnum.SOLVED,
+                });
+                expect(progressWithQuestionStatus).toBeDefined();
+                if (progressWithQuestionStatus.questions.length > 0) {
+                    expect(progressWithQuestionStatus.questions[0].questionStatus).toBe(
+                        QuestionStatusEnum.SOLVED,
+                    );
+                }
+            },
+        );
     });
 });

src/leetcode.ts

@@ -5,13 +5,15 @@ import { Credential } from "./credential";
 import fetch from "./fetch";
 import CONTEST from "./graphql/contest.graphql?raw";
 import DAILY from "./graphql/daily.graphql?raw";
+import USER_PROGRESS_QUESTIONS from "./graphql/leetcode-cn/user-progress-questions.graphql?raw";
 import PROBLEM from "./graphql/problem.graphql?raw";
 import PROBLEMS from "./graphql/problems.graphql?raw";
 import PROFILE from "./graphql/profile.graphql?raw";
 import RECENT_SUBMISSIONS from "./graphql/recent-submissions.graphql?raw";
 import SUBMISSION_DETAIL from "./graphql/submission-detail.graphql?raw";
 import SUBMISSIONS from "./graphql/submissions.graphql?raw";
 import WHOAMI from "./graphql/whoami.graphql?raw";
+import { UserProgressQuestionList, UserProgressQuestionListInput } from "./leetcode-cn";
 import type {
     DailyChallenge,
     Problem,
@@ -203,6 +205,21 @@ export class LeetCode extends EventEmitter {
         return data.submissionDetails as SubmissionDetail;
     }
 
+    /**
+     * Get user progress questions. Need to be authenticated.
+     * @returns
+     */
+    public async user_progress_questions(
+        filters: UserProgressQuestionListInput,
+    ): Promise<UserProgressQuestionList> {
+        await this.initialized;
+        const { data } = await this.graphql({
+            variables: { filters: filters },
+            query: USER_PROGRESS_QUESTIONS,
+        });
+        return data.userProgressQuestionList as UserProgressQuestionList;
+    }
+
     /**
      * Get a list of problems by tags and difficulty.
      * @param option