job-pro 0.7.0 → 0.7.2

package/dist/oppo.js

@@ -1,94 +1,250 @@
-// OPPO — stub adapter for `job-pro`.
-//
-// STATUS: stub-only. OPPO's careers portal exists at careers.oppo.com and
-// exposes an `/api/job/list` endpoint, but every probed payload variation
-// returns HTTP 500 from the upstream Spring Boot service, suggesting the
-// route requires session-bound CSRF / fingerprint headers that the page's
-// JS bundle injects only after the browser passes a runtime check.
+// OPPO careers adapter for `job-pro`.
 //
 // ============================================================
-// RECONNAISSANCE RESULTS (probed 2026-05):
+// API DISCOVERY (probed 2026-05-15)
 //
-//   https://careers.oppo.com/                  — SPA shell (Vite, /assets/js/campus_oppo-*.js)
-//   POST https://careers.oppo.com/api/job/list — HTTP 500 internal error
-//     payload variants tried:
-//       {} → 500
-//       {"page":1,"pageSize":10} → 500
-//       {"keyword":"","page":1,"pageSize":10,"recruitType":"campus"} → 500
-//       {"keyword":"","jobLineCode":"","jobNature":"","cityCode":"","page":1,"pageSize":10,"locale":"zh-CN"} → 500
-//     All return Spring-style {"timestamp":..,"status":500,"path":"/api/job/list"}.
+// careers.oppo.com is a Vite SPA whose campus job listing is rendered by the
+// dynamically-loaded chunk /assets/js/job-edfe7d6e.js. The chunk exposes two
+// candidate routes:
 //
-//   Feishu ATSX tenants:
-//     oppo.jobs.feishu.cn — HTTP 400 (no portal configured)
+//   POST /ats-candidate-api/open-api/position/queryPositionList  → HTTP 404
+//   POST /openapi/position/pageNew                                → HTTP 200 ✓
 //
-//   Moka:
-//     app.mokahr.com/social-recruitment/oppo — Moka SPA shell renders but
-//       per-slug job feed returns the "您访问的页面不存在" error page.
+// The working route is `/openapi/position/pageNew`. It returns a paginated
+// list of all currently-open positions across the OPPO recruiting site without
+// any token or signed header — only standard browser headers are required.
+// Both campus (校招/应届生) and intern (实习生) postings live on this endpoint;
+// the `recruitmentType` field on each record distinguishes them.
 //
-// Conclusion: OPPO publishes positions through their own bespoke Spring Boot
-// API which requires browser-runtime headers (likely a CSRF + WAF cookie pair)
-// before any 200 response is returned. No anonymous JSON path is currently
-// reachable. Visit https://careers.oppo.com/ for the official portal.
+// Endpoint inventory (all anon, all on careers.oppo.com):
+//   POST /openapi/position/pageNew                       → paginated job list
+//   GET  /openapi/position/detail?idRecruitPosition=<id> → single posting
+//   GET  /openapi/position/project/list                  → recruitment projects
+//   GET  /openapi/position/relatedPosition?...           → related jobs
+//   GET  /openapi/sec/getRiskReport                      → WAF risk probe
+//   GET  /openapi/system/dictionary/queryList            → filter taxonomy
+// ============================================================
 import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
 export { checkResume };
 const SOURCE = "careers.oppo.com";
-const STUB_MESSAGE = "OPPO: careers.oppo.com /api/job/list returns HTTP 500 for every anonymous payload " +
-    "variant probed — the endpoint appears to require browser-runtime CSRF / WAF cookies. " +
-    "No unauthenticated public API available. Visit https://careers.oppo.com/ for the portal.";
-export async function searchPositions(_opts = {}) {
+const API_ROOT = "https://careers.oppo.com";
+const SITE_ROOT = "https://careers.oppo.com/";
+const DETAIL_PAGE = (id) => `https://careers.oppo.com/#/campus/talent/positionDetail/${encodeURIComponent(id)}`;
+const DEFAULT_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+    Accept: "application/json, text/plain, */*",
+    "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+    Referer: SITE_ROOT,
+    Origin: "https://careers.oppo.com",
+};
+async function call(method, path, opts = {}) {
+    let url = `${API_ROOT}${path}`;
+    if (opts.query) {
+        const params = new URLSearchParams();
+        for (const [k, v] of Object.entries(opts.query)) {
+            if (v !== undefined)
+                params.set(k, String(v));
+        }
+        const qs = params.toString();
+        if (qs)
+            url += (path.includes("?") ? "&" : "?") + qs;
+    }
+    const headers = { ...DEFAULT_HEADERS };
+    let body;
+    if (opts.body !== undefined) {
+        body = JSON.stringify(opts.body);
+        headers["Content-Type"] = "application/json;charset=UTF-8";
+    }
+    let response;
+    try {
+        response = await fetch(url, { method, headers, body });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!response.ok) {
+        return { ok: false, message: `HTTP ${response.status}: ${response.statusText}` };
+    }
+    let payload;
+    try {
+        payload = (await response.json());
+    }
+    catch (err) {
+        return { ok: false, message: `bad JSON: ${err instanceof Error ? err.message : err}` };
+    }
+    return {
+        ok: payload.code === 0,
+        data: payload.data,
+        message: payload.msg || (payload.code === 0 ? "ok" : "upstream error"),
+    };
+}
+function summarize(item) {
+    const id = String(item.idRecruitPosition ?? item.idProjPosition ?? item.projectPositionId ?? "");
     return {
-        ok: false,
+        post_id: id,
+        title: (item.positionName ?? item.projectPositionName ?? "").trim(),
+        project: (item.projectName ?? "").trim(),
+        recruit_label: (item.recruitmentTypeName ?? item.recruitmentType ?? "").trim(),
+        bgs: (item.positionTypeName ?? "").trim(),
+        work_cities: (item.workCityName ?? "").trim(),
+        apply_url: id ? DETAIL_PAGE(id) : SITE_ROOT,
+    };
+}
+// ---------- searchPositions ----------
+export async function searchPositions(opts = {}) {
+    const pageSize = Math.max(1, Math.min(100, opts.pageSize ?? 20));
+    const page = Math.max(1, opts.page ?? 1);
+    const body = {
+        pageNum: page,
+        pageSize,
+    };
+    if (opts.keyword)
+        body.keyword = opts.keyword.trim().slice(0, 60);
+    if (opts.recruitType === "campus")
+        body.recruitmentType = "Campus";
+    else if (opts.recruitType === "intern")
+        body.recruitmentType = "Intern";
+    if (opts.cityCode)
+        body.workCityCode = opts.cityCode;
+    const r = await call("POST", "/openapi/position/pageNew", { body });
+    if (!r.ok || !r.data) {
+        return {
+            ok: false,
+            source: SOURCE,
+            message: r.message,
+            query: body,
+            positions: [],
+        };
+    }
+    const rows = r.data.records ?? [];
+    return {
+        ok: true,
         source: SOURCE,
-        message: STUB_MESSAGE,
-        query: {},
-        positions: [],
+        query: body,
+        page,
+        page_size: pageSize,
+        total: r.data.total ?? rows.length,
+        positions: rows.map(summarize),
     };
 }
-export async function fetchAllPositions(_opts = {}) {
+// ---------- fetchAllPositions ----------
+export async function fetchAllPositions(opts = {}) {
+    const pageSize = Math.max(1, Math.min(100, opts.pageSize ?? 50));
+    const maxPages = Math.max(1, opts.maxPages ?? 40);
+    const bucket = [];
+    let total;
+    for (let page = 1; page <= maxPages; page++) {
+        const r = await searchPositions({
+            keyword: opts.keyword,
+            page,
+            pageSize,
+            recruitType: opts.recruitType,
+        });
+        if (!r.ok) {
+            return { ok: false, source: SOURCE, message: r.message, total: 0, fetched: bucket.length, positions: bucket };
+        }
+        if (total === undefined)
+            total = r.total;
+        if (!r.positions.length)
+            break;
+        bucket.push(...r.positions);
+        if (total !== undefined && bucket.length >= total)
+            break;
+    }
     return {
-        ok: false,
+        ok: true,
         source: SOURCE,
-        message: STUB_MESSAGE,
-        total: 0,
-        fetched: 0,
-        positions: [],
+        total: total ?? bucket.length,
+        fetched: bucket.length,
+        positions: bucket,
     };
 }
 export async function fetchPositionDetail(postId) {
+    const id = (postId ?? "").trim();
+    if (!id)
+        return { ok: false, source: SOURCE, message: "post_id is required", post_id: id };
+    const r = await call("GET", "/openapi/position/detail", {
+        query: { idRecruitPosition: id },
+    });
+    if (!r.ok || !r.data) {
+        return { ok: false, source: SOURCE, message: r.message || "no detail returned", post_id: id };
+    }
+    const raw = r.data;
     return {
-        ok: false,
+        ok: true,
         source: SOURCE,
-        message: STUB_MESSAGE,
-        post_id: postId,
+        post_id: String(raw.idRecruitPosition ?? id),
+        title: raw.positionName ?? raw.projectPositionName ?? "",
+        project: raw.projectName ?? "",
+        recruit_label: raw.recruitmentTypeName ?? raw.recruitmentType ?? "",
+        position_type: raw.positionTypeName ?? "",
+        description: (raw.positionDesc ?? raw.projectPositionDesc ?? "").trim(),
+        requirements: (raw.positionRequire ?? raw.projectPositionRequire ?? "").trim(),
+        work_city: raw.workCityName ?? "",
+        work_city_code: raw.workCityCode ?? "",
+        head_count: raw.positionNum,
+        release_time: raw.releaseTime ?? "",
+        apply_url: DETAIL_PAGE(id),
     };
 }
+// ---------- fetchDictionaries ----------
 export async function fetchDictionaries() {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE };
+    const r = await call("GET", "/openapi/system/dictionary/queryList");
+    if (!r.ok)
+        return { ok: false, source: SOURCE, message: r.message };
+    return {
+        ok: true,
+        source: SOURCE,
+        api_host: API_ROOT,
+        verified_at: new Date().toISOString(),
+        dictionaries: r.data,
+    };
 }
+// ---------- notices (not exposed publicly) ----------
+const NO_NOTICES = "OPPO careers does not expose a public notices/announcements endpoint.";
 export async function listNotices() {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notices: [] };
+    return { ok: false, source: SOURCE, message: NO_NOTICES, notices: [] };
 }
 export async function getNotice(noticeId) {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notice_id: noticeId };
+    return { ok: false, source: SOURCE, message: NO_NOTICES, notice_id: noticeId };
 }
 export async function findNoticesByQuestion(question, _opts = {}) {
-    return {
-        ok: false,
-        source: SOURCE,
-        question,
-        message: STUB_MESSAGE,
-        matches: [],
-    };
+    return { ok: false, source: SOURCE, question, message: NO_NOTICES, matches: [] };
 }
-export async function matchResume(text, _opts = {}) {
+// ---------- matchResume ----------
+export async function matchResume(text, opts = {}) {
     const { terms, cities } = extractResumeSignals(text ?? "");
+    const topN = Math.max(1, opts.topN ?? 5);
+    const candidates = Math.max(topN, opts.candidates ?? 200);
+    const all = await fetchAllPositions({ pageSize: 50, maxPages: Math.ceil(candidates / 50) });
+    if (!all.ok) {
+        return {
+            ok: false,
+            source: SOURCE,
+            message: all.message,
+            extracted_terms: terms,
+            city_preferences: cities,
+            matches: [],
+        };
+    }
+    const scored = [];
+    for (const p of all.positions) {
+        const haystack = `${p.title} ${p.project} ${p.bgs} ${p.work_cities}`;
+        const score = scoreOverlap(haystack, terms, cities).score;
+        if (score > 0)
+            scored.push({ score, position: p });
+    }
+    scored.sort((a, b) => b.score - a.score);
     return {
-        ok: false,
+        ok: true,
         source: SOURCE,
         extracted_terms: terms,
         city_preferences: cities,
-        matches: [],
-        message: STUB_MESSAGE,
+        candidate_pool: all.positions.length,
+        matches: scored.slice(0, topN).map((s) => s.position),
     };
 }
 export { extractResumeSignals, scoreOverlap };