hydro-ai-helper 1.8.5

package/tests/integration/curl/02-student-chat.sh

@@ -0,0 +1,67 @@
+#!/usr/bin/env bash
+# 学生端发起一次对话，返回 conversationId 并写入 .conversation_id
+set -euo pipefail
+
+BASE_URL="${HYDRO_BASE_URL:-http://127.0.0.1}"
+COOKIE="${HYDRO_STUDENT_COOKIE:?HYDRO_STUDENT_COOKIE not set. Please export HYDRO_STUDENT_COOKIE=\"sid=...\"}"
+
+PROBLEM_ID="${HYDRO_PROBLEM_ID:-P1000}"
+PROBLEM_TITLE="${HYDRO_PROBLEM_TITLE:-Sample Problem}"
+PROBLEM_SUMMARY="${HYDRO_PROBLEM_SUMMARY:-This is a short problem description for testing.}"
+QUESTION_TYPE="${HYDRO_QUESTION_TYPE:-think}" # valid: understand|think|debug|review
+USER_THINKING="${HYDRO_USER_THINKING:-我想用二分解决区间最大值，可以帮我验证思路吗？}"
+INCLUDE_CODE="${HYDRO_CHAT_INCLUDE_CODE:-true}"
+CODE_SNIPPET="${HYDRO_CHAT_CODE:-// sample code: int main(){ return 0; }}"
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+STATE_FILE="${SCRIPT_DIR}/.conversation_id"
+
+echo "[T026] 02-student-chat: create a conversation"
+echo "Using BASE_URL=${BASE_URL}"
+
+payload=$(cat <<EOF
+{
+  "problemId": "$PROBLEM_ID",
+  "problemTitle": "$PROBLEM_TITLE",
+  "problemContent": "$PROBLEM_SUMMARY",
+  "questionType": "$QUESTION_TYPE",
+  "userThinking": "$USER_THINKING",
+  "includeCode": $INCLUDE_CODE,
+  "code": "$CODE_SNIPPET"
+}
+EOF
+)
+
+response=$(curl -sS -w "\nHTTP_STATUS:%{http_code}" -X POST "$BASE_URL/ai-helper/chat" \
+  -H "Cookie: $COOKIE" \
+  -H "Content-Type: application/json" \
+  -d "$payload")
+
+body=$(printf "%s" "$response" | sed '/HTTP_STATUS:/d')
+status=$(printf "%s" "$response" | sed -n 's/.*HTTP_STATUS://p')
+echo "$body"
+
+if [ "$status" != "200" ]; then
+  echo "Unexpected status when chatting: $status" >&2
+  exit 1
+fi
+
+conversation_id=$(printf "%s" "$body" | python3 - <<'PY' || true
+import json, sys
+try:
+    data = json.load(sys.stdin)
+    cid = data.get("conversationId")
+    if cid:
+        print(cid)
+except Exception:
+    pass
+PY
+)
+
+if [ -z "${conversation_id:-}" ]; then
+  echo "conversationId not found in response, please check output above." >&2
+  exit 1
+fi
+
+echo "$conversation_id" > "$STATE_FILE"
+echo "[Done] conversationId stored at $STATE_FILE"

package/tests/integration/curl/03-teacher-list.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# 教师/管理员查看对话列表，可附带筛选参数
+set -euo pipefail
+
+BASE_URL="${HYDRO_BASE_URL:-http://127.0.0.1}"
+COOKIE="${HYDRO_TEACHER_COOKIE:?HYDRO_TEACHER_COOKIE not set. Use a teacher/admin sid.}"
+
+# 可选筛选
+START_DATE="${HYDRO_LIST_START_DATE:-}"
+END_DATE="${HYDRO_LIST_END_DATE:-}"
+PROBLEM_ID="${HYDRO_LIST_PROBLEM_ID:-}"
+CLASS_ID="${HYDRO_LIST_CLASS_ID:-}"
+USER_ID="${HYDRO_LIST_USER_ID:-}"
+LIMIT="${HYDRO_LIST_LIMIT:-20}"
+PAGE="${HYDRO_LIST_PAGE:-1}"
+
+echo "[T026] 03-teacher-list: fetch conversation list"
+echo "Using BASE_URL=${BASE_URL}"
+
+query="page=${PAGE}&limit=${LIMIT}"
+[ -n "$START_DATE" ] && query="${query}&startDate=${START_DATE}"
+[ -n "$END_DATE" ] && query="${query}&endDate=${END_DATE}"
+[ -n "$PROBLEM_ID" ] && query="${query}&problemId=${PROBLEM_ID}"
+[ -n "$CLASS_ID" ] && query="${query}&classId=${CLASS_ID}"
+[ -n "$USER_ID" ] && query="${query}&userId=${USER_ID}"
+
+response=$(curl -sS -w "\nHTTP_STATUS:%{http_code}" "$BASE_URL/ai-helper/conversations?${query}" \
+  -H "Cookie: $COOKIE" \
+  -H "Accept: application/json")
+
+body=$(printf "%s" "$response" | sed '/HTTP_STATUS:/d')
+status=$(printf "%s" "$response" | sed -n 's/.*HTTP_STATUS://p')
+echo "$body"
+
+if [ "$status" != "200" ]; then
+  echo "Unexpected status when listing conversations: $status" >&2
+  exit 1
+fi
+
+# Optional negative test for invalid date range
+if [ "${RUN_INVALID_DATE_CHECK:-0}" != "0" ]; then
+  invalid_status=$(curl -sS -o /dev/null -w "%{http_code}" "$BASE_URL/ai-helper/conversations?startDate=INVALID_DATE" \
+    -H "Cookie: $COOKIE" \
+    -H "Accept: application/json")
+  echo "Invalid date check status (expected 400): ${invalid_status}"
+  if [ "${invalid_status}" != "400" ]; then
+    echo "Unexpected status for invalid date: ${invalid_status}" >&2
+    exit 1
+  fi
+fi
+
+echo "[Done] conversation list fetched."

package/tests/integration/curl/04-teacher-detail.sh

@@ -0,0 +1,37 @@
+#!/usr/bin/env bash
+# 教师/管理员查看对话详情
+set -euo pipefail
+
+BASE_URL="${HYDRO_BASE_URL:-http://127.0.0.1}"
+COOKIE="${HYDRO_TEACHER_COOKIE:?HYDRO_TEACHER_COOKIE not set. Use a teacher/admin sid.}"
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+STATE_FILE="${SCRIPT_DIR}/.conversation_id"
+
+CONVERSATION_ID="${HYDRO_CONVERSATION_ID:-}"
+if [ -z "$CONVERSATION_ID" ] && [ -f "$STATE_FILE" ]; then
+  CONVERSATION_ID="$(cat "$STATE_FILE")"
+fi
+
+if [ -z "$CONVERSATION_ID" ]; then
+  echo "Missing conversationId. Set HYDRO_CONVERSATION_ID or run 02-student-chat.sh first." >&2
+  exit 1
+fi
+
+echo "[T026] 04-teacher-detail: fetch conversation detail ${CONVERSATION_ID}"
+echo "Using BASE_URL=${BASE_URL}"
+
+response=$(curl -sS -w "\nHTTP_STATUS:%{http_code}" "$BASE_URL/ai-helper/conversations/${CONVERSATION_ID}" \
+  -H "Cookie: $COOKIE" \
+  -H "Accept: application/json")
+
+body=$(printf "%s" "$response" | sed '/HTTP_STATUS:/d')
+status=$(printf "%s" "$response" | sed -n 's/.*HTTP_STATUS://p')
+echo "$body"
+
+if [ "$status" != "200" ]; then
+  echo "Unexpected status when fetching detail: $status" >&2
+  exit 1
+fi
+
+echo "[Done] conversation detail fetched."

package/tests/integration/curl/05-export.sh

@@ -0,0 +1,49 @@
+#!/usr/bin/env bash
+# 导出 CSV，默认写入临时文件
+set -euo pipefail
+
+BASE_URL="${HYDRO_BASE_URL:-http://127.0.0.1}"
+COOKIE="${HYDRO_TEACHER_COOKIE:?HYDRO_TEACHER_COOKIE not set. Use a teacher/admin sid.}"
+
+START_DATE="${HYDRO_EXPORT_START_DATE:-}"
+END_DATE="${HYDRO_EXPORT_END_DATE:-}"
+CLASS_ID="${HYDRO_EXPORT_CLASS_ID:-}"
+PROBLEM_ID="${HYDRO_EXPORT_PROBLEM_ID:-}"
+USER_ID="${HYDRO_EXPORT_USER_ID:-}"
+INCLUDE_SENSITIVE="${HYDRO_EXPORT_INCLUDE_SENSITIVE:-false}"
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+OUTPUT_FILE="${EXPORT_OUTPUT_FILE:-$(mktemp "${SCRIPT_DIR}/export-XXXX.csv")}"
+
+echo "[T026] 05-export: export conversations to CSV"
+echo "Using BASE_URL=${BASE_URL}"
+
+query="format=csv&includeSensitive=${INCLUDE_SENSITIVE}"
+[ -n "$START_DATE" ] && query="${query}&startDate=${START_DATE}"
+[ -n "$END_DATE" ] && query="${query}&endDate=${END_DATE}"
+[ -n "$CLASS_ID" ] && query="${query}&classId=${CLASS_ID}"
+[ -n "$PROBLEM_ID" ] && query="${query}&problemId=${PROBLEM_ID}"
+[ -n "$USER_ID" ] && query="${query}&userId=${USER_ID}"
+
+status=$(curl -sS -o "$OUTPUT_FILE" -w "%{http_code}" "$BASE_URL/ai-helper/export?${query}" \
+  -H "Cookie: $COOKIE" \
+  -H "Accept: text/csv")
+
+if [ "$status" != "200" ]; then
+  echo "Unexpected status when exporting: $status" >&2
+  echo "Response:" >&2
+  cat "$OUTPUT_FILE" >&2
+  exit 1
+fi
+
+echo "Export saved to: $OUTPUT_FILE"
+head -n 5 "$OUTPUT_FILE"
+
+if [ "${RUN_INVALID_FORMAT_CHECK:-0}" != "0" ]; then
+  invalid_status=$(curl -sS -o /dev/null -w "%{http_code}" "$BASE_URL/ai-helper/export?format=json" \
+    -H "Cookie: $COOKIE" \
+    -H "Accept: application/json")
+  echo "Invalid format check status (expected 400): ${invalid_status}"
+fi
+
+echo "[Done] export completed."

package/tests/integration/curl/06-analytics.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+# 查看统计数据
+set -euo pipefail
+
+BASE_URL="${HYDRO_BASE_URL:-http://127.0.0.1}"
+COOKIE="${HYDRO_TEACHER_COOKIE:?HYDRO_TEACHER_COOKIE not set. Use a teacher/admin sid.}"
+
+DIMENSION="${HYDRO_ANALYTICS_DIMENSION:-problem}" # class|problem|student
+START_DATE="${HYDRO_ANALYTICS_START_DATE:-}"
+END_DATE="${HYDRO_ANALYTICS_END_DATE:-}"
+CLASS_ID="${HYDRO_ANALYTICS_CLASS_ID:-}"
+PROBLEM_ID="${HYDRO_ANALYTICS_PROBLEM_ID:-}"
+
+echo "[T026] 06-analytics: fetch analytics (${DIMENSION})"
+echo "Using BASE_URL=${BASE_URL}"
+
+query="dimension=${DIMENSION}"
+[ -n "$START_DATE" ] && query="${query}&startDate=${START_DATE}"
+[ -n "$END_DATE" ] && query="${query}&endDate=${END_DATE}"
+[ -n "$CLASS_ID" ] && query="${query}&classId=${CLASS_ID}"
+[ -n "$PROBLEM_ID" ] && query="${query}&problemId=${PROBLEM_ID}"
+
+response=$(curl -sS -w "\nHTTP_STATUS:%{http_code}" "$BASE_URL/ai-helper/analytics?${query}" \
+  -H "Cookie: $COOKIE" \
+  -H "Accept: application/json")
+
+body=$(printf "%s" "$response" | sed '/HTTP_STATUS:/d')
+status=$(printf "%s" "$response" | sed -n 's/.*HTTP_STATUS://p')
+echo "$body"
+
+if [ "$status" != "200" ]; then
+  echo "Unexpected status when fetching analytics: $status" >&2
+  exit 1
+fi
+
+if [ "${RUN_INVALID_DIMENSION_CHECK:-0}" != "0" ]; then
+  invalid_status=$(curl -sS -o /dev/null -w "%{http_code}" "$BASE_URL/ai-helper/analytics?dimension=invalid" \
+    -H "Cookie: $COOKIE" \
+    -H "Accept: application/json")
+  echo "Invalid dimension check status (expected 400): ${invalid_status}"
+fi
+
+echo "[Done] analytics fetched."

package/tests/performance/README.md

@@ -0,0 +1,85 @@
+# 性能测试指南（T027）
+
+本指南用于在测试环境快速验证 HydroOJ 插件 **@hydrooj/hydro-ai-helper** 的关键接口性能。工具选择保持轻量，默认提供 k6 脚本，也可替换为 `ab`/`wrk` 等等。
+
+## 前置条件
+- 已在测试环境部署 HydroOJ 与本插件，核心配置（`ENCRYPTION_KEY`、AI 访问配置等）已填写，并能正常完成对话请求。
+- 拥有测试用 **学生账号 Cookie**（用于 `/ai-helper/chat`），以及 **教师/管理员 Cookie**（用于列表、导出接口）。
+- 本地安装了 [k6](https://k6.io/docs/get-started/installation/)；或在说明中使用容器镜像 `grafana/k6` 运行。
+- 测试环境与生产环境隔离，且压力测试期间监控 CPU、内存、MongoDB 慢查询日志。
+
+## 测试数据准备
+- 目标数据量（建议）：Conversation 数量 1k / 5k / 10k；每个会话约 5-10 条消息。
+- 快速生成数据的两种方式：
+  1) 使用学生账号循环调用 `/ai-helper/chat`：
+
+     ```bash
+     export HYDRO_BASE_URL=http://127.0.0.1
+     export HYDRO_STUDENT_COOKIE="sid=..."
+     for i in {1..200}; do
+       curl -s -X POST "$HYDRO_BASE_URL/ai-helper/chat" \
+         -H 'Content-Type: application/json' \
+         -H "Cookie: $HYDRO_STUDENT_COOKIE" \
+         -d '{"problemId":"demo","questionType":"understand","userThinking":"我想熟悉这道题的双指针思路"}' >/dev/null
+     done
+     ```
+
+  2) 在 MongoDB 中批量插入模拟数据：参考 `tests/performance/data/prepare-sample-data.md` 给出的脚本示例。
+
+## 关键接口与关注点
+- 学生端高频接口：`POST /ai-helper/chat`
+- 教师端列表/详情：`GET /ai-helper/conversations`、`GET /ai-helper/conversations/:id`
+- 导出接口：`GET /ai-helper/export?format=csv`
+- 统计接口：`GET /ai-helper/analytics`
+
+## 压测脚本与运行方式（k6）
+所有脚本位于 `tests/performance/scripts/`。必要环境变量：
+- `HYDRO_BASE_URL`：HydroOJ 基础地址（默认 `http://127.0.0.1`）
+- `HYDRO_STUDENT_COOKIE`：学生登录 Cookie，用于聊天接口
+- `HYDRO_TEACHER_COOKIE`：教师/管理员 Cookie，用于列表/导出接口
+- 可选：`VUS`、`DURATION`、`SLEEP` 用于覆盖并发与节奏
+
+1. **学生对话接口**
+
+   ```bash
+   k6 run tests/performance/scripts/student-chat-k6.js \
+     --env HYDRO_BASE_URL=http://127.0.0.1 \
+     --env HYDRO_STUDENT_COOKIE="sid=..."
+   ```
+
+2. **教师对话列表接口**
+
+   ```bash
+   k6 run tests/performance/scripts/teacher-conversations-k6.js \
+     --env HYDRO_BASE_URL=http://127.0.0.1 \
+     --env HYDRO_TEACHER_COOKIE="sid=..." \
+     --env PAGE_LIMIT=50
+   ```
+
+3. **导出接口（小批量）**
+
+   ```bash
+   k6 run tests/performance/scripts/export-csv-k6.js \
+     --env HYDRO_BASE_URL=http://127.0.0.1 \
+     --env HYDRO_TEACHER_COOKIE="sid=..." \
+     --env EXPORT_DAYS=7
+   ```
+
+> 如果未安装 k6，可使用 Docker：`docker run --rm -i grafana/k6 run - < tests/performance/scripts/student-chat-k6.js`（通过 `-e` 传递环境变量）。
+
+## 推荐性能门槛（可按硬件微调）
+- `/ai-helper/chat`：10 并发、30s 压测下，P95 ≤ 2s
+- `/ai-helper/conversations`：10 并发、30s 压测下，P95 ≤ 1s
+- `/ai-helper/export`：在 1k 会话量级内，P95 ≤ 3s
+
+满足以上门槛即可视为通过；若不满足，请结合 MongoDB `explain`、慢查询日志定位瓶颈。
+
+## 结果解读与记录
+- 关注 k6 输出中的 `http_req_duration`（总耗时）和 `http_req_waiting`（服务端处理耗时）。
+- 以 P95/P99 作为参考；若 P50 与 P95 差距过大，说明尾延迟需要优化。
+- 将测试参数与结果追加记录到 `tests/integration/README.md` 或新建记录文件，便于回溯。
+
+## 风险与注意事项
+- 不要在生产环境直接做大流量压测；优先在隔离的测试服执行。
+- 导出接口请从小批量开始（如 7 天或 500~1000 条数据），确认无内存/超时风险后再扩大范围。
+- 压测期间留意 HydroOJ 进程 CPU/内存、MongoDB 连接数和慢查询日志，必要时降低并发或缩短持续时间。

package/tests/performance/data/prepare-sample-data.md

@@ -0,0 +1,57 @@
+# 测试数据快速准备示例
+
+在测试环境中预先准备一定规模的会话数据可以让性能测试更贴近真实场景。以下两种方式任选其一。
+
+## 方式一：使用脚本循环调用聊天接口
+适合需要真实业务链路的场景，可与 `tests/performance/scripts/student-chat-k6.js` 类似：
+
+```bash
+export HYDRO_BASE_URL=http://127.0.0.1
+export HYDRO_STUDENT_COOKIE="sid=..."
+
+for i in {1..500}; do
+  curl -s -X POST "$HYDRO_BASE_URL/ai-helper/chat" \
+    -H 'Content-Type: application/json' \
+    -H "Cookie: $HYDRO_STUDENT_COOKIE" \
+    -d '{"problemId":"demo","questionType":"understand","userThinking":"第'$i'次压测造数，帮我解释这道题的思路"}' >/dev/null
+  sleep 0.2
+done
+```
+
+## 方式二：直接写入 MongoDB（伪造数据）
+适合快速灌入大量会话以测试列表/导出接口。以下为 Mongo shell/`mongosh` 的示例，按需调整集合名与字段：
+
+```javascript
+// 在 mongosh 中执行
+const conversations = db.getCollection('ai_conversations');
+const messages = db.getCollection('ai_messages');
+
+const now = new Date();
+for (let i = 0; i < 2000; i++) {
+  const conversation = {
+    userId: 10000 + (i % 50),
+    problemId: 'demo',
+    classId: 'class-A',
+    startTime: new Date(now.getTime() - i * 60000),
+    endTime: now,
+    messageCount: 6,
+    isEffective: true,
+    tags: ['loadtest'],
+    metadata: { problemTitle: 'A+B Problem' }
+  };
+
+  const { insertedId } = conversations.insertOne(conversation);
+
+  // 插入简化的消息列表
+  for (let j = 0; j < 6; j++) {
+    messages.insertOne({
+      conversationId: insertedId,
+      role: j % 2 === 0 ? 'student' : 'ai',
+      content: `msg ${j} for conv ${i}`,
+      timestamp: new Date(conversation.startTime.getTime() + j * 1000)
+    });
+  }
+}
+```
+
+> 造数后请确认不会影响生产数据，推荐在独立测试数据库中执行。

package/tests/performance/scripts/export-csv-k6.js

@@ -0,0 +1,41 @@
+import http from 'k6/http';
+import { check, sleep } from 'k6';
+
+export const options = {
+  vus: parseInt(__ENV.VUS || '2', 10),
+  duration: __ENV.DURATION || '20s',
+  thresholds: {
+    http_req_duration: ['p(95)<3000'],
+    checks: ['rate>0.95']
+  }
+};
+
+const BASE_URL = __ENV.HYDRO_BASE_URL || 'http://127.0.0.1';
+const COOKIE = __ENV.HYDRO_TEACHER_COOKIE || __ENV.HYDRO_ADMIN_COOKIE || '';
+const DAYS = parseInt(__ENV.EXPORT_DAYS || '7', 10);
+const SLEEP_SECONDS = parseFloat(__ENV.SLEEP || '1');
+
+const endDate = new Date();
+const startDate = new Date(endDate.getTime() - DAYS * 24 * 60 * 60 * 1000);
+
+export default function () {
+  const url = `${BASE_URL}/ai-helper/export?format=csv&startDate=${encodeURIComponent(
+    startDate.toISOString()
+  )}&endDate=${encodeURIComponent(endDate.toISOString())}`;
+
+  const res = http.get(url, {
+    headers: {
+      Cookie: COOKIE
+    }
+  });
+
+  check(res, {
+    'status is 200': (r) => r.status === 200,
+    'response time < 3s': (r) => r.timings.duration < 3000,
+    'has csv content': (r) => (r.headers['Content-Type'] || '').includes('csv')
+  });
+
+  if (SLEEP_SECONDS > 0) {
+    sleep(SLEEP_SECONDS);
+  }
+}

package/tests/performance/scripts/student-chat-k6.js

@@ -0,0 +1,44 @@
+import http from 'k6/http';
+import { check, sleep } from 'k6';
+
+export const options = {
+  vus: parseInt(__ENV.VUS || '10', 10),
+  duration: __ENV.DURATION || '30s',
+  thresholds: {
+    http_req_duration: ['p(95)<2000'],
+    checks: ['rate>0.95']
+  }
+};
+
+const BASE_URL = __ENV.HYDRO_BASE_URL || 'http://127.0.0.1';
+const COOKIE = __ENV.HYDRO_STUDENT_COOKIE || '';
+const SLEEP_SECONDS = parseFloat(__ENV.SLEEP || '1');
+
+const payload = JSON.stringify({
+  problemId: __ENV.PROBLEM_ID || 'demo',
+  problemTitle: __ENV.PROBLEM_TITLE || 'Sample Problem',
+  problemContent: __ENV.PROBLEM_CONTENT || '给定两个整数 A 和 B，输出它们的和。',
+  questionType: 'understand',
+  userThinking: __ENV.USER_THINKING || '请帮我理解这道题的双指针/枚举思路。',
+  includeCode: false
+});
+
+const params = {
+  headers: {
+    'Content-Type': 'application/json',
+    Cookie: COOKIE
+  }
+};
+
+export default function () {
+  const res = http.post(`${BASE_URL}/ai-helper/chat`, payload, params);
+
+  check(res, {
+    'status is 200': (r) => r.status === 200,
+    'response time < 2s': (r) => r.timings.duration < 2000
+  });
+
+  if (SLEEP_SECONDS > 0) {
+    sleep(SLEEP_SECONDS);
+  }
+}

package/tests/performance/scripts/teacher-conversations-k6.js

@@ -0,0 +1,33 @@
+import http from 'k6/http';
+import { check, sleep } from 'k6';
+
+export const options = {
+  vus: parseInt(__ENV.VUS || '5', 10),
+  duration: __ENV.DURATION || '30s',
+  thresholds: {
+    http_req_duration: ['p(95)<1000'],
+    checks: ['rate>0.95']
+  }
+};
+
+const BASE_URL = __ENV.HYDRO_BASE_URL || 'http://127.0.0.1';
+const COOKIE = __ENV.HYDRO_TEACHER_COOKIE || __ENV.HYDRO_ADMIN_COOKIE || '';
+const PAGE_LIMIT = parseInt(__ENV.PAGE_LIMIT || '50', 10);
+const SLEEP_SECONDS = parseFloat(__ENV.SLEEP || '1');
+
+export default function () {
+  const res = http.get(`${BASE_URL}/ai-helper/conversations?limit=${PAGE_LIMIT}`, {
+    headers: {
+      Cookie: COOKIE
+    }
+  });
+
+  check(res, {
+    'status is 200': (r) => r.status === 200,
+    'response time < 1s': (r) => r.timings.duration < 1000
+  });
+
+  if (SLEEP_SECONDS > 0) {
+    sleep(SLEEP_SECONDS);
+  }
+}

package/tsconfig.json

@@ -0,0 +1,42 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": [
+      "ES2020"
+    ],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": false,
+    "noImplicitAny": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": false,
+    "resolveJsonModule": true,
+    "declaration": false,
+    "sourceMap": true,
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "isolatedModules": false,
+    "noEmitOnError": false,
+    "baseUrl": ".",
+    "paths": {
+      "hydrooj": [
+        "types/hydrooj"
+      ]
+    }
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist",
+    "src/__tests__"
+  ],
+  "ts-node": {
+    "transpileOnly": true
+  }
+}

package/tsconfig.vercel.json

@@ -0,0 +1,27 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": ".vercel/output",
+    "rootDir": ".",
+    "strict": false,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "moduleResolution": "node",
+    "noEmit": false
+  },
+  "include": [
+    "api/**/*",
+    "lib/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "src",
+    "frontend",
+    "dist"
+  ]
+}

package/types/hydrooj/index.d.ts

@@ -0,0 +1,73 @@
+declare module 'hydrooj' {
+  import { Collection, Db, Cursor } from 'mongodb';
+
+  export interface Context {
+    Route(name: string, path: string, handler: any, privilege?: any): void;
+    [key: string]: any;
+  }
+
+  export class Handler {
+    ctx: Context;
+    request: any;
+    response: any;
+    user?: any;
+    args?: any;
+  }
+
+  export const PRIV: Record<string, any>;
+
+  export function definePlugin<TConfig = any>(options: {
+    name?: string;
+    using?: (keyof Context)[];
+    schema?: any;
+    apply: (ctx: Context, config: TConfig) => void | Promise<void>;
+  }): {
+    name?: string;
+    schema?: any;
+    apply: (ctx: Context, config: TConfig) => void | Promise<void>;
+  };
+
+  export const Schema: any;
+
+  export interface DbService {
+    collection<T = any>(name: string): Collection<T>;
+  }
+
+  export const db: DbService;
+
+  export const RecordModel: {
+    getMulti(domainId: string, query: any): {
+      sort(order: any): {
+        limit(n: number): {
+          project(projection: any): {
+            toArray(): Promise<any[]>;
+          };
+        };
+      };
+    };
+  };
+
+  export const ProblemModel: any;
+
+  // STATUS enum from @hydrooj/common, re-exported via builtin
+  export const STATUS: {
+    STATUS_WAITING: number;
+    STATUS_ACCEPTED: number;
+    STATUS_WRONG_ANSWER: number;
+    STATUS_TIME_LIMIT_EXCEEDED: number;
+    STATUS_MEMORY_LIMIT_EXCEEDED: number;
+    STATUS_OUTPUT_LIMIT_EXCEEDED: number;
+    STATUS_RUNTIME_ERROR: number;
+    STATUS_COMPILE_ERROR: number;
+    STATUS_SYSTEM_ERROR: number;
+    STATUS_CANCELED: number;
+    STATUS_ETC: number;
+    STATUS_HACKED: number;
+    STATUS_JUDGING: number;
+    STATUS_COMPILING: number;
+    STATUS_FETCHED: number;
+    STATUS_IGNORED: number;
+    STATUS_FORMAT_ERROR: number;
+    [key: string]: number;
+  };
+}

package/vercel.json

@@ -0,0 +1,3 @@
+{
+  "version": 2
+}