linke-sdufe 0.1.0

package/src/registry.js

@@ -0,0 +1,51 @@
+/**
+ * 学校适配器注册表。核心命令框架只依赖本文件暴露的接口，
+ * 不 import 任何学校特有模块——新增学校 = 新增包内 src/<id>/ 目录
+ * 并在此注册（T3 验收 7：多学校扩展地基）。
+ *
+ * 适配器是环境注入产物（createSdufeAdapter(env)），因此注册表不预置
+ * 实例：宿主启动时显式 initSdufe(env)（CLI 用 nodeEnv()，uni-app 用
+ * uni.request 垫片 env）。getAdapter 在未初始化时给出明确指引。
+ */
+import { createSdufeAdapter } from './adapter.js'
+import { nodeEnv } from './env.js'
+
+const adapters = new Map()
+
+/** 创建 sdufe 适配器（默认 nodeEnv）并注册；幂等（重复调用覆盖同 id） */
+export function initSdufe(env = nodeEnv()) {
+  const adapter = createSdufeAdapter(env)
+  adapters.set(adapter.id, adapter)
+  return adapter
+}
+
+/**
+ * 适配器接口契约（核心框架只调用这些成员）：
+ *   id, name, baseUrl
+ *   login({ userId, password, recognizeCaptcha }, { maxRetries, onProgress })
+ *     → { cookie, userInfo }
+ *   probeSession(cookie) → userInfo（过期抛 err.isJwLoginExpired）
+ *   fetchCurrentTerm(cookie) → string | null
+ *   fetchSchedule(cookie, { term, week }) → { weeks, remark? }
+ *   fetchScores(cookie, { term }) → rows[]
+ */
+export function getAdapter(schoolId) {
+  const adapter = adapters.get(schoolId)
+  if (!adapter) {
+    throw new Error(
+      `适配器 ${schoolId} 未初始化或未知（当前已注册: ${Array.from(adapters.keys()).join(', ') || '无'}）。` +
+        `宿主启动时需先 initSdufe(env)——Node 宿主可省参（默认 nodeEnv），uni-app 宿主需传 uni.request 垫片 env`
+    )
+  }
+  return adapter
+}
+
+/** 注册适配器（新学校接入入口；测试也用它注入 fake 适配器） */
+export function registerAdapter(adapter) {
+  if (!adapter || !adapter.id) throw new Error('适配器缺少 id')
+  adapters.set(adapter.id, adapter)
+}
+
+export function listAdapters() {
+  return Array.from(adapters.values()).map((a) => ({ id: a.id, name: a.name, baseUrl: a.baseUrl }))
+}

package/src/util.js

@@ -0,0 +1,52 @@
+/**
+ * 教务 HTML 预处理与 cookie 提取（环境无关纯函数）。
+ * 口径与 App 端 linke_App/repositories/jwHttp.js、utils/jwLoginExpired.js 保持同源。
+ */
+
+/**
+ * 从响应对象提取 "k=v; k2=v2" 形式的 Cookie 头。
+ * 接受带 getSetCookie() 的标准 fetch Response（Node >= 18.14），
+ * 也接受宿主垫片构造的同形对象（uni.request 等）。
+ */
+export function extractCookieHeader(response) {
+  const headers = response && response.headers ? response.headers : {}
+  const list = headers.getSetCookie ? headers.getSetCookie() : []
+  const pairs = []
+  for (const raw of list) {
+    const pair = String(raw).split(';')[0]
+    if (pair) pairs.push(pair.trim())
+  }
+  return pairs.join('; ')
+}
+
+/**
+ * 教务 HTML 预处理：删除空格（含全角）与换行。
+ * PHP 端与 App 端解析前都做同一处理，正则依赖此口径（<td align= 会变 <tdalign=）。
+ */
+export function stripSpaces(html) {
+  return String(html ?? '').replace(/[ \u3000\t\n\r]/g, '')
+}
+
+/**
+ * 教务「登录过期」判定。
+ * 判定序（T12 修订：短页阈值曾误伤 cjcx_avg 这类 <5KB 小业务页）：
+ *   1. 登录页表单特征（RANDOMCODE + 账号/密码输入框）——最准；
+ *   2. 「用户登录 / 请先登录」文案；
+ *   3. 短 html + </html> 且不含 <table>——登录页/错误页兜底
+ *      （业务页必有数据表，小页面如 gpa 页含表即放行）。
+ */
+export function isJwLoginExpired(html) {
+  if (!html || typeof html !== 'string') return false
+  const trimmed = html.trim()
+  if (
+    trimmed.includes('RANDOMCODE') &&
+    (trimmed.includes('userAccount') || trimmed.includes('userPassword'))
+  ) {
+    return true
+  }
+  if (trimmed.includes('用户登录') || trimmed.includes('请先登录')) return true
+  if (trimmed.includes('</html>') && trimmed.length < 5000 && !/<table[\s>]/i.test(trimmed)) {
+    return true
+  }
+  return false
+}