Files
jackwener__opencli/clis/chaoxing/exams.ts
jakevin 4fe9a73ebc refactor: migrate adapter imports to package exports (#795)
* refactor: migrate adapter imports to package exports

Replace all relative imports (../../src/registry.js, ../../browser/cdp.js, etc.)
with package exports (@jackwener/opencli/registry, @jackwener/opencli/errors, etc.)
across all 484 adapter files.

This decouples adapter import resolution from directory structure:
- User CLIs in ~/.opencli/clis/ resolve via node_modules symlink
- Internal adapters resolve via Node.js self-referencing
- No more shim files needed for import resolution

Changes:
- package.json: add sub-path exports for all public modules
- clis/**: replace relative imports with @jackwener/opencli/...
- discovery.ts: simplify ensureUserCliCompatShims to symlink-only
- registry-api.ts: export CommandArgs type
- Remove root-level shim directories (browser/, download/, pipeline/)
- Remove shim entries from tsconfig.json include and package.json files

* test: add regression tests for package exports

Prevents regressions like #788/#791 by:
1. Scanning all adapter files for forbidden relative imports
   (../../src/, ../../browser/, etc.) — fails if any remain
2. Verifying every package.json export maps to an existing source file

18 new test cases.

* fix: use junction on Windows + broaden test patterns

- discovery.ts: use 'junction' symlink type on Windows (no admin required)
- package-exports.test.ts: generalize forbidden patterns to catch any
  depth of ../ traversal (not just ../../ and ../../../)

* fix: update stale vi.mock/importActual paths in adapter tests

Test files still used old relative paths for vi.mock() and
vi.importActual() calls. Updated 5 test files to use package exports.
Also broadened regression test patterns to catch mock/importActual paths.

* fix: use rm instead of unlink for symlink cleanup, add warn on failure

Addresses review feedback from Astro-Han:
- rm() handles both symlinks and stale directories (unlink fails on dirs)
- Log a warning when symlink creation fails instead of silent catch

* docs: update import examples to use package exports

Update all documentation, contributing guides, and skills to use
@jackwener/opencli/registry instead of ../../src/registry.js.

Without this, users following the docs would write adapters with
broken imports since the old shim files are no longer created.
2026-04-05 16:02:17 +08:00

89 lines
2.6 KiB
TypeScript

import { cli, Strategy } from '@jackwener/opencli/registry';
import {
getCourses, initSession, enterCourse, getTabIframeUrl,
parseExamsFromDom, sleep,
type ExamRow,
} from './utils.js';
cli({
site: 'chaoxing',
name: 'exams',
description: '学习通考试列表',
domain: 'mooc2-ans.chaoxing.com',
strategy: Strategy.COOKIE,
timeoutSeconds: 90,
args: [
{ name: 'course', type: 'string', help: '按课程名过滤(模糊匹配)' },
{
name: 'status',
type: 'string',
default: 'all',
choices: ['all', 'upcoming', 'ongoing', 'finished'],
help: '按状态过滤',
},
{ name: 'limit', type: 'int', default: 20, help: '最大返回数量' },
],
columns: ['rank', 'course', 'title', 'start', 'end', 'status', 'score'],
func: async (page, kwargs) => {
const { course: courseFilter, status: statusFilter = 'all', limit = 20 } = kwargs;
// 1. Establish session
await initSession(page);
// 2. Get courses
const courses = await getCourses(page);
if (!courses.length) throw new Error('未获取到课程列表,请确认已登录学习通');
const filtered = courseFilter
? courses.filter(c => c.title.includes(courseFilter))
: courses;
if (courseFilter && !filtered.length) {
throw new Error(`未找到匹配「${courseFilter}」的课程`);
}
// 3. Per-course: enter → click 考试 tab → navigate to iframe → parse
const allRows: ExamRow[] = [];
for (const c of filtered) {
try {
await enterCourse(page, c);
const iframeUrl = await getTabIframeUrl(page, '考试');
if (!iframeUrl) continue;
await page.goto(iframeUrl);
await page.wait(2);
const rows = await parseExamsFromDom(page, c.title);
allRows.push(...rows);
} catch {
// Single course failure: skip, continue
}
if (filtered.length > 1) await sleep(600);
}
// 4. Sort: upcoming first
allRows.sort((a, b) => {
const order = (s: string) =>
s === '未开始' ? 0 : s === '进行中' ? 1 : s === '已结束' ? 2 : s === '已完成' ? 3 : 4;
return order(a.status) - order(b.status);
});
// 5. Filter by status
const statusMap: Record<string, string[]> = {
upcoming: ['未开始'],
ongoing: ['进行中'],
finished: ['已结束', '已完成'],
};
const finalRows =
statusFilter === 'all'
? allRows
: allRows.filter(r => statusMap[statusFilter]?.includes(r.status));
return finalRows.slice(0, Number(limit)).map((item, i) => ({
rank: i + 1,
...item,
}));
},
});