@ha7ch/job-pro 1.0.93

package/dist/alibaba.js

@@ -0,0 +1,509 @@
+// Thin client for Alibaba's public campus-recruiting API at campus-talent.alibaba.com.
+//
+// CSRF flow: the server issues XSRF-TOKEN via a GET to the campus listing page.
+// Every subsequent POST must echo it as both a Cookie and an X-XSRF-TOKEN header.
+// The module-level singleton caches the token on first use and retries once on 403.
+//
+// Endpoint inventory (all under https://campus-talent.alibaba.com):
+//
+//   GET  /campus/position                  — HTML page; sets XSRF-TOKEN cookie
+//   POST /searchCondition/listBatch        — list all active batches (no auth required)
+//   POST /searchCondition/list             — filter taxonomy for a given batchId
+//   POST /position/search                  — paginated job search (filter params below)
+//   POST /position/detail                  — single job detail (body: {id: <number>})
+//   POST /position/queryCircleDept         — dept tree for a circle (returns [] without login)
+//
+// ACTIVE BATCHES (as of 2026-05-14; refresh via fetchDictionaries()):
+//   batchId        | batchName                   | type         | totalCount
+//   100000540002   | 阿里巴巴2027届实习生           | internship   | 474
+//   100000560002   | 阿里巴巴日常实习生             | project      | 225
+//   100000560001   | 阿里巴巴研究型实习生           | project      | 188
+//   (graduate section is empty — no 校招正式 batch open as of 2026-05-14)
+//
+// FULL-TIME (校招正式) NOTE:
+//   Alibaba's full-time new-grad batch (graduate/trainee type) is NOT currently active.
+//   It historically opens in August–October. When it opens, /searchCondition/listBatch
+//   will populate the `graduate` array with a new batchId. Pass that batchId explicitly.
+//
+// BATCHID IS MANDATORY:
+//   POST /position/search with NO batchId returns totalCount=0. There is no "all batches"
+//   aggregate call — you must loop over each batchId to get the full picture.
+//
+// FILTER DIMENSIONS (passed as comma-joined strings in /position/search body):
+//   subCategories  — category values from searchCondition/list (type="category")
+//                    e.g. "11" (技术类), "1" (产品类), "11,1" (both) — comma-joined
+//   regions        — city names from searchCondition/list (type="workCity")
+//                    e.g. "北京", "北京,上海" — comma-joined city labels
+//   customDeptCode — child dept codes from searchCondition/list (type="customDept")
+//                    Must use leaf-level codes (e.g. "JM3EV0" for 阿里云技术线),
+//                    NOT parent codes (e.g. "60002" for 阿里云 returns 0 results).
+//                    Comma-join multiple: "JM3EV0,5YTU0N"
+//
+// KEYWORD SEARCH:
+//   The correct field is `searchKey` (NOT `keyword`). searchKey works: passing "前端"
+//   returns 3 results, "算法" returns 87, "java" returns 2. The old `keyword` field is
+//   silently ignored by the server. This adapter now uses searchKey.
+//
+// CHANNEL NOTE:
+//   The live site uses "new_campus_group_official_site". Both channel values return
+//   identical counts for batchId 100000540002 (474 total), so either works.
+//
+// PositionSummary field mapping (Alibaba → canonical):
+//   post_id        ← String(item.id)                (numeric, e.g. 199903220038)
+//   title          ← item.name
+//   project        ← item.categoryName ?? ""         (e.g. "技术类")
+//   recruit_label  ← item.categoryType ?? ""         (e.g. "internship")
+//   bgs            ← item.circleNames?.[0] ?? ""     (BU / group name)
+//   work_cities    ← item.workLocations.join(" / ")
+//   apply_url      ← https://campus-talent.alibaba.com/campus/positionDetail?positionId=<id>
+import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
+export { extractResumeSignals, scoreOverlap, checkResume };
+const API_ROOT = "https://campus-talent.alibaba.com";
+const CAMPUS_PAGE = `${API_ROOT}/campus/position`;
+const DETAIL_PAGE = (id) => `${API_ROOT}/campus/position/${encodeURIComponent(String(id))}`;
+const DEFAULT_BATCH_ID = 100000540002;
+const DEFAULT_CHANNEL = "new_campus_group_official_site";
+const UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 " +
+    "(KHTML, like Gecko) Chrome/124.0 Safari/537.36";
+let csrfCache = null;
+async function acquireCsrf() {
+    let response;
+    try {
+        response = await fetch(CAMPUS_PAGE, {
+            method: "GET",
+            headers: {
+                "User-Agent": UA,
+                Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+            },
+        });
+    }
+    catch (err) {
+        return null;
+    }
+    if (!response.ok)
+        return null;
+    // Node fetch exposes Set-Cookie via getSetCookie() (Node 18+) or headers.raw()
+    let setCookieHeaders = [];
+    const rawHeaders = response.headers.raw;
+    if (typeof rawHeaders === "function") {
+        const raw = rawHeaders.call(response.headers);
+        setCookieHeaders = raw["set-cookie"] ?? [];
+    }
+    else if (typeof response.headers.getSetCookie === "function") {
+        setCookieHeaders = response.headers.getSetCookie();
+    }
+    let token = "";
+    let session = "";
+    for (const hdr of setCookieHeaders) {
+        const nameVal = hdr.split(";")[0].trim();
+        const [name, val] = nameVal.split("=").map((s) => s.trim());
+        if (name === "XSRF-TOKEN" && val)
+            token = val;
+        if (name === "SESSION" && val)
+            session = val;
+    }
+    if (!token)
+        return null;
+    return { token, session };
+}
+async function getCsrf(force = false) {
+    if (!force && csrfCache)
+        return csrfCache;
+    const state = await acquireCsrf();
+    if (state)
+        csrfCache = state;
+    return state ?? null;
+}
+async function call(path, body, retried = false) {
+    const csrf = await getCsrf();
+    if (!csrf) {
+        return { ok: false, message: "failed to acquire CSRF token from Alibaba" };
+    }
+    const cookieStr = `XSRF-TOKEN=${csrf.token}${csrf.session ? `; SESSION=${csrf.session}` : ""}`;
+    const headers = {
+        "User-Agent": UA,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        Referer: CAMPUS_PAGE,
+        "X-XSRF-TOKEN": csrf.token,
+        Cookie: cookieStr,
+    };
+    let response;
+    try {
+        response = await fetch(`${API_ROOT}${path}`, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (response.status === 403 && !retried) {
+        csrfCache = null;
+        return call(path, body, true);
+    }
+    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}` };
+    }
+    if (payload.success === false) {
+        return {
+            ok: false,
+            message: payload.errorMsg || payload.errorCode || "upstream returned success=false",
+        };
+    }
+    return {
+        ok: true,
+        data: payload.content,
+        message: "ok",
+    };
+}
+function summarizePosition(item) {
+    const id = String(item.id ?? "");
+    return {
+        post_id: id,
+        title: item.name ?? "",
+        project: item.categoryName ?? "",
+        recruit_label: item.categoryType ?? "",
+        bgs: (item.circleNames ?? [])[0] ?? "",
+        work_cities: (item.workLocations ?? []).join(" / "),
+        apply_url: id ? DETAIL_PAGE(id) : CAMPUS_PAGE,
+    };
+}
+function joinFilter(v) {
+    if (!v)
+        return undefined;
+    return Array.isArray(v) ? v.join(",") : v;
+}
+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 searchKey = (opts.keyword ?? "").trim().slice(0, 60) || undefined;
+    const batchId = opts.batchId ?? DEFAULT_BATCH_ID;
+    const body = {
+        batchId,
+        pageIndex: page,
+        pageSize,
+        channel: DEFAULT_CHANNEL,
+        language: "zh",
+    };
+    if (searchKey)
+        body.searchKey = searchKey;
+    const subCategories = joinFilter(opts.subCategories);
+    if (subCategories)
+        body.subCategories = subCategories;
+    const regions = joinFilter(opts.regions);
+    if (regions)
+        body.regions = regions;
+    const customDeptCode = joinFilter(opts.customDeptCode);
+    if (customDeptCode)
+        body.customDeptCode = customDeptCode;
+    const response = await call("/position/search", body);
+    if (!response.ok || !response.data) {
+        return {
+            ok: false,
+            source: "campus-talent.alibaba.com",
+            message: response.message,
+            query: body,
+            page,
+            page_size: pageSize,
+            total: 0,
+            positions: [],
+        };
+    }
+    const rows = response.data.datas ?? [];
+    return {
+        ok: true,
+        source: "campus-talent.alibaba.com",
+        query: body,
+        page,
+        page_size: pageSize,
+        total: response.data.totalCount ?? rows.length,
+        positions: rows.map(summarizePosition),
+    };
+}
+// ---------- fetch all ----------
+export async function fetchAllPositions(opts = {}) {
+    const pageSize = Math.max(1, Math.min(100, opts.pageSize ?? 100));
+    const maxPages = Math.max(1, opts.maxPages ?? 20);
+    const bucket = [];
+    let total;
+    for (let page = 1; page <= maxPages; page++) {
+        const result = await searchPositions({
+            keyword: opts.keyword,
+            page,
+            pageSize,
+            batchId: opts.batchId,
+            subCategories: opts.subCategories,
+            regions: opts.regions,
+            customDeptCode: opts.customDeptCode,
+        });
+        if (!result.ok) {
+            return {
+                ok: false,
+                source: "campus-talent.alibaba.com",
+                message: result.message ?? "search failed",
+                fetched: bucket.length,
+                positions: bucket,
+            };
+        }
+        if (total === undefined)
+            total = result.total;
+        if (!result.positions.length)
+            break;
+        bucket.push(...result.positions);
+        if (total !== undefined && bucket.length >= total)
+            break;
+    }
+    return {
+        ok: true,
+        source: "campus-talent.alibaba.com",
+        total: total ?? bucket.length,
+        fetched: bucket.length,
+        positions: bucket,
+    };
+}
+// ---------- position detail ----------
+export async function fetchPositionDetail(postId) {
+    const id = String(postId ?? "").trim();
+    if (!id)
+        return { ok: false, message: "post_id is required" };
+    const numId = Number(id);
+    const body = { id: Number.isNaN(numId) ? id : numId };
+    const response = await call("/position/detail", body);
+    if (!response.ok || !response.data) {
+        return {
+            ok: false,
+            source: "campus-talent.alibaba.com",
+            message: response.message || "no detail returned",
+            post_id: id,
+        };
+    }
+    const raw = response.data;
+    return {
+        ok: true,
+        source: "campus-talent.alibaba.com",
+        post_id: String(raw.id ?? id),
+        title: raw.name ?? "",
+        direction: raw.categoryName ?? "",
+        description: (raw.description ?? "").trim(),
+        requirements: (raw.requirement ?? "").trim(),
+        work_cities: raw.workLocations ?? [],
+        recruit_cities: raw.interviewLocations ?? [],
+        bgs: (raw.circleNames ?? [])[0] ?? "",
+        batch_name: raw.batchName ?? "",
+        apply_url: DETAIL_PAGE(raw.id ?? id),
+    };
+}
+export async function fetchDictionaries() {
+    // Step 1: fetch all active batches
+    const batchRes = await call("/searchCondition/listBatch", {
+        channel: DEFAULT_CHANNEL,
+        language: "zh",
+    });
+    if (!batchRes.ok || !batchRes.data) {
+        return {
+            ok: false,
+            message: `Alibaba batch list failed: ${batchRes.message}`,
+        };
+    }
+    const rawBatchList = batchRes.data;
+    // Collect all batches across categories
+    const allRawBatches = [];
+    for (const cat of rawBatchList.sequence ?? ["graduate", "internship", "topTalentPlan"]) {
+        const list = rawBatchList[cat];
+        if (Array.isArray(list)) {
+            for (const b of list) {
+                allRawBatches.push({ batch: b, category: cat });
+            }
+        }
+    }
+    // Deduplicate by batchId (topTalentPlan reuses 100000540002)
+    const seen = new Set();
+    const uniqueBatches = allRawBatches.filter(({ batch }) => {
+        if (seen.has(batch.id))
+            return false;
+        seen.add(batch.id);
+        return true;
+    });
+    // Step 2: for each unique batch, fetch the filter taxonomy
+    const batches = await Promise.all(uniqueBatches.map(async ({ batch, category }) => {
+        const condRes = await call("/searchCondition/list", {
+            batchId: batch.id,
+            channel: DEFAULT_CHANNEL,
+            language: "zh",
+        });
+        const searchItems = condRes.data?.searchItems ?? [];
+        const filters = { categories: [], cities: [], customDepts: [] };
+        for (const si of searchItems) {
+            const items = si.items ?? [];
+            if (si.type === "category") {
+                filters.categories = items.map((x) => ({ label: x.label, value: x.value }));
+            }
+            else if (si.type === "workCity") {
+                filters.cities = items.map((x) => ({ label: x.label, value: x.value }));
+            }
+            else if (si.type === "customDept") {
+                filters.customDepts = items.map((x) => ({
+                    label: x.label,
+                    value: x.value,
+                    children: x.children?.map((c) => ({ label: c.label, value: c.value })),
+                }));
+            }
+        }
+        return {
+            batchId: batch.id,
+            batchName: batch.name,
+            batchNameEn: batch.enName ?? "",
+            category, // "graduate" | "internship" | "topTalentPlan"
+            recruitType: batch.type ?? "", // "trainee" | "talent_plan" | "aliStar"
+            remark: batch.remark ?? "",
+            totalPositions: condRes.data?.totalPositions ?? null,
+            filters,
+        };
+    }));
+    return {
+        ok: true,
+        source: "campus-talent.alibaba.com",
+        note: "batchId is mandatory for /position/search — no cross-batch aggregate exists. " +
+            "Graduate (校招正式) batch is empty; it typically opens Aug–Oct. " +
+            "Use subCategories/regions/customDeptCode filters in searchPositions(). " +
+            "customDeptCode requires CHILD-level codes (leaf nodes), not parent group codes.",
+        batches,
+    };
+}
+export async function listNotices() {
+    return {
+        ok: false,
+        message: "Alibaba: no public notices endpoint",
+    };
+}
+export async function getNotice(_id) {
+    return {
+        ok: false,
+        message: "Alibaba: no public notice detail endpoint",
+    };
+}
+export async function findNoticesByQuestion(_question, _opts = {}) {
+    return {
+        ok: false,
+        message: "Alibaba: no public notices endpoint",
+        matches: [],
+    };
+}
+// ---------- resume matching ----------
+export async function matchResume(text, opts = {}) {
+    const topN = Math.max(1, opts.topN ?? 5);
+    const candidates = Math.max(topN, opts.candidates ?? 20);
+    const { terms, cities } = extractResumeSignals(text ?? "");
+    if (!terms.length) {
+        return {
+            ok: false,
+            message: "could not extract any technical signals from the text",
+            preview: (text ?? "").slice(0, 120),
+        };
+    }
+    const keyword = terms.slice(0, 3).join(" ");
+    const list = await searchPositions({ keyword, page: 1, pageSize: 100 });
+    if (!list.ok) {
+        return {
+            ok: false,
+            message: list.message ?? "search failed",
+            positions: [],
+        };
+    }
+    const pre = [];
+    for (const p of list.positions) {
+        const blob = [p.title, p.project, p.recruit_label, p.bgs, p.work_cities].join(" ");
+        const { score, reasons } = scoreOverlap(blob, terms, cities);
+        if (score > 0)
+            pre.push({ score, position: p, reasons });
+    }
+    pre.sort((a, b) => b.score - a.score);
+    let shortlist = pre.slice(0, Math.max(topN, candidates));
+    if (!shortlist.length) {
+        shortlist = list.positions.slice(0, candidates).map((position) => ({
+            score: 0,
+            position,
+            reasons: [],
+        }));
+    }
+    const enriched = [];
+    for (const { score: baseScore, position, reasons: baseReasons } of shortlist.slice(0, candidates)) {
+        const detail = await fetchPositionDetail(position.post_id);
+        if (!detail.ok)
+            continue;
+        const jdBlob = [
+            detail.title,
+            detail.direction,
+            detail.description,
+            detail.requirements,
+            (detail.work_cities ?? []).join(" "),
+        ].join(" ");
+        const { score: extraScore, reasons: extraReasons } = scoreOverlap(jdBlob, terms, cities);
+        const combined = [...new Set([...baseReasons, ...extraReasons])].slice(0, 5);
+        if (!combined.length)
+            combined.push("no specific keyword overlap — surfaced from initial keyword search");
+        enriched.push({
+            score: baseScore + extraScore,
+            row: {
+                ...position,
+                direction: detail.direction,
+                description: detail.description,
+                requirements: detail.requirements,
+                match_reasons: combined,
+            },
+        });
+    }
+    enriched.sort((a, b) => b.score - a.score);
+    return {
+        ok: true,
+        source: "campus-talent.alibaba.com",
+        extracted_terms: terms,
+        city_preferences: cities,
+        matches: enriched.slice(0, topN).map((e) => e.row),
+        note: "match_reasons surfaces overlapping keywords, not a probability of getting an interview. " +
+            "The only authority on selection is HR.",
+    };
+}
+import { buildBespokeApplySchema as _buildBespokeApplySchema_alibaba } from "./apply.js";
+export async function fetchApplicationSchema(postId) {
+    const id = (postId ?? "").trim();
+    if (!id)
+        return { ok: false, source: "campus-talent.alibaba.com", message: "post_id is required" };
+    let title = "";
+    let applyUrl = "https://campus-talent.alibaba.com";
+    try {
+        const detail = (await fetchPositionDetail(id));
+        if (detail?.ok === false) {
+            return { ok: false, source: "campus-talent.alibaba.com", message: detail.message ?? "post not found" };
+        }
+        title = detail?.title ?? "";
+        if (detail?.apply_url)
+            applyUrl = detail.apply_url;
+    }
+    catch { }
+    return {
+        ok: true,
+        schema: _buildBespokeApplySchema_alibaba({
+            source: "campus-talent.alibaba.com",
+            postId: id,
+            jobTitle: title,
+            applyUrl,
+            submitEndpoint: "https://campus-talent.alibaba.com/campus/applyPosition.json",
+            submitKind: "multipart-session",
+            endpointVerified: true,
+            submitNotes: "Alibaba — POST /campus/applyPosition.json with session cookie. Alipay OAuth gates the session. Endpoint anon-probed → HTTP 403 (auth gate, not 404 — confirms real route). Body shape still needs validation against a real candidate session.",
+        }),
+    };
+}