@ha7ch/job-pro 1.0.93

package/dist/oppo.js

@@ -0,0 +1,285 @@
+// OPPO careers adapter for `job-pro`.
+//
+// ============================================================
+// API DISCOVERY (probed 2026-05-15)
+//
+// 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:
+//
+//   POST /ats-candidate-api/open-api/position/queryPositionList  → HTTP 404
+//   POST /openapi/position/pageNew                                → HTTP 200 ✓
+//
+// 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.
+//
+// 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 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 {
+        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,
+        query: body,
+        page,
+        page_size: pageSize,
+        total: r.data.total ?? rows.length,
+        positions: rows.map(summarize),
+    };
+}
+// ---------- 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: true,
+        source: SOURCE,
+        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 };
+    // The endpoint expects `id`, not `idRecruitPosition` — passing
+    // `idRecruitPosition` returns the puzzling "id不能为空" error even when the
+    // value is present. The response body still keys the id back as
+    // `idRecruitPosition`, which is what tripped this in the first place.
+    const r = await call("GET", "/openapi/position/detail", {
+        query: { 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: true,
+        source: SOURCE,
+        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() {
+    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: NO_NOTICES, notices: [] };
+}
+export async function getNotice(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: NO_NOTICES, matches: [] };
+}
+// ---------- 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: true,
+        source: SOURCE,
+        extracted_terms: terms,
+        city_preferences: cities,
+        candidate_pool: all.positions.length,
+        matches: scored.slice(0, topN).map((s) => s.position),
+    };
+}
+export { extractResumeSignals, scoreOverlap };
+import { buildBespokeApplySchema as _buildBespokeApplySchema_oppo } from "./apply.js";
+export async function fetchApplicationSchema(postId) {
+    const id = (postId ?? "").trim();
+    if (!id)
+        return { ok: false, source: "careers.oppo.com", message: "post_id is required" };
+    let title = "";
+    let applyUrl = "https://careers.oppo.com";
+    try {
+        const detail = (await fetchPositionDetail(id));
+        if (detail?.ok === false) {
+            return { ok: false, source: "careers.oppo.com", message: detail.message ?? "post not found" };
+        }
+        title = detail?.title ?? "";
+        if (detail?.apply_url)
+            applyUrl = detail.apply_url;
+    }
+    catch { }
+    return {
+        ok: true,
+        schema: _buildBespokeApplySchema_oppo({
+            source: "careers.oppo.com",
+            postId: id,
+            jobTitle: title,
+            applyUrl,
+            submitEndpoint: "https://careers.oppo.com/api/delivery/saveDelivery",
+            submitKind: "multipart-session",
+            endpointVerified: true,
+            submitNotes: "OPPO — POST /api/delivery/saveDelivery with session cookie. Endpoint anon-probed → HTTP 500 + Spring \"Internal Server Error\" (real Spring controller; the /api/delivery/* sub-tree was discovered by reading the SPA's resume-787081aa.js chunk which references /api/delivery/getDeliveryInfo etc, then probing siblings — all 7 candidates returned 500 = real routes). The original /openapi/position/apply returned structured 404 from a different Spring service. Body shape still needs validation.",
+        }),
+    };
+}