publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/imooc/article.js

@@ -1,192 +1 @@
-import { CliError, CommandExecutionError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { publishArticle } from '../_shared/article/publish.js';
-import { checkLogin } from '../_shared/article/auth.js';
-import { readFile, stat } from 'node:fs/promises';
-
-// ── 慕课手记 profile ────────────────────────────────────────────────────────
-// 移植自 Wechatsync ImoocAdapter（outputFormat: markdown，最薄）。
-// 慕课只提供「存草稿」接口，没有一键发布接口，所以始终以草稿返回（draft: true）。
-// 图片上传需要 File 对象 + 额外表单字段，装不进声明式 spec，用 uploadFn。
-export const imoocProfile = {
-    home: 'https://www.imooc.com/article',
-    outputFormat: 'markdown',
-
-    // ── 登录检测 ──────────────────────────────────────────────────────────────
-    // 移植自 Wechatsync checkAuth()：调 JSONP 接口，解析 uid/nickname/img。
-    // HEADER_RULES（Origin/Referer）在 opencli 页面内执行时天然满足，无需注入。
-    checkAuth: async (PP) => {
-        const resp = await fetch('https://www.imooc.com/u/card', { credentials: 'include' });
-        let text = await resp.text();
-        // 解析 JSONP：jsonpcallback({...}) → {...}
-        text = text.replace(/^jsonpcallback\(/, '').replace(/\}\)$/, '}');
-        let result;
-        try { result = JSON.parse(text); } catch (e) { return { isAuthenticated: false, error: 'JSONP 解析失败：' + String(e && e.message || e) }; }
-        if (!result || result.result !== 0) {
-            return { isAuthenticated: false, error: (result && result.msg) || '未登录' };
-        }
-        return {
-            isAuthenticated: true,
-            userId: String(result.data.uid),
-            username: result.data.nickname,
-            avatar: result.data.img,
-        };
-    },
-
-    // ── 图片转存 ─────────────────────────────────────────────────────────────
-    // 移植自 uploadImageByUrl：下载图片字节 → multipart POST。
-    // 需要 new File([blob], filename, {type}) 并附带额外字段（type/id/name/lastModifiedDate/size），
-    // 声明式 binary-multipart spec 不支持此格式，故用 uploadFn。
-    // 返回的 imgpath 可能是协议相对路径（//img.xxx），统一补 https:。
-    image: {
-        uploadFn: async (src, PP) => {
-            const imageResp = await fetch(src, { credentials: 'omit' });
-            if (!imageResp.ok) throw new Error('图片下载失败：HTTP ' + imageResp.status);
-            const blob = await imageResp.blob();
-            const filename = Date.now() + '.jpg';
-            const file = new File([blob], filename, { type: blob.type || 'image/jpeg' });
-
-            const formData = new FormData();
-            formData.append('photo', file, filename);
-            formData.append('type', file.type);
-            formData.append('id', 'WU_FILE_0');
-            formData.append('name', filename);
-            formData.append('lastModifiedDate', new Date().toString());
-            formData.append('size', String(file.size));
-
-            const resp = await fetch('https://www.imooc.com/article/ajaxuploadimg', {
-                method: 'POST',
-                credentials: 'include',
-                body: formData,
-            });
-            const res = await resp.json();
-            if (!res || res.result !== 0) {
-                throw new Error((res && res.msg) || '图片上传失败');
-            }
-            let imgUrl = res.data.imgpath;
-            if (imgUrl && imgUrl.indexOf('//') === 0) {
-                imgUrl = 'https:' + imgUrl;
-            }
-            return { url: imgUrl };
-        },
-        skip: ['img.imooc.com', 'imooc.com'],
-    },
-
-    // ── 发布 ─────────────────────────────────────────────────────────────────
-    // 移植自 Wechatsync publish()：POST savedraft（始终保存为草稿）。
-    // I.content 已完成图片转存，直接提交。
-    // 慕课无「发布」独立接口，draftOnly 忽略（始终草稿），保持语义诚实，draft 始终 true。
-    publish: async (I, PP) => {
-        const resp = await fetch('https://www.imooc.com/article/savedraft', {
-            method: 'POST',
-            credentials: 'include',
-            headers: {
-                'Content-Type': 'application/x-www-form-urlencoded',
-            },
-            body: new URLSearchParams({
-                editor: '0',
-                draft_id: '0',
-                title: I.title,
-                content: I.content,
-            }),
-        });
-        if (!resp.ok) {
-            const txt = await resp.text();
-            return { ok: false, stage: 'savedraft', status: resp.status, message: txt.slice(0, 300) };
-        }
-        const res = await resp.json();
-        if (!res || !res.data) {
-            const raw = JSON.stringify(res).slice(0, 300);
-            return { ok: false, stage: 'savedraft', status: resp.status, message: '保存草稿失败：' + raw };
-        }
-        const id = String(res.data);
-        return {
-            ok: true,
-            id: id,
-            url: 'https://www.imooc.com/article/draft/id/' + id,
-            draft: true,
-        };
-    },
-};
-
-// ── requireExecute / resolvePayload / buildResultRow 内联精简版 ───────────────
-// imooc 没有 write-shared.js，参照 zhihu/write-shared.js 内联关键三函数。
-function requireExecute(kwargs) {
-    if (!kwargs.execute) {
-        throw new CliError('INVALID_INPUT', '此命令需要 --execute 才会真正写入。不加 --execute 时仅做格式校验。');
-    }
-}
-
-async function resolvePayload(kwargs) {
-    const text = typeof kwargs.text === 'string' ? kwargs.text : undefined;
-    const file = typeof kwargs.file === 'string' ? kwargs.file : undefined;
-    if (text && file) {
-        throw new CliError('INVALID_INPUT', '<text> 和 --file 不能同时使用');
-    }
-    let resolved = text ?? '';
-    if (file) {
-        let fileStat;
-        try { fileStat = await stat(file); } catch { throw new CliError('INVALID_INPUT', '文件不存在：' + file); }
-        if (!fileStat.isFile()) throw new CliError('INVALID_INPUT', '路径必须是可读文本文件：' + file);
-        let raw;
-        try { raw = await readFile(file); } catch { throw new CliError('INVALID_INPUT', '文件读取失败：' + file); }
-        try { resolved = new TextDecoder('utf-8', { fatal: true }).decode(raw); } catch { throw new CliError('INVALID_INPUT', '文件不是有效 UTF-8：' + file); }
-    }
-    if (!resolved.trim()) throw new CliError('INVALID_INPUT', '正文不能为空');
-    return resolved;
-}
-
-function buildResultRow(message, targetType, target, outcome, extra = {}) {
-    return [{ status: 'success', outcome, message, target_type: targetType, target, ...extra }];
-}
-
-// ── CLI 注册 ─────────────────────────────────────────────────────────────────
-cli({
-    site: 'imooc',
-    name: 'article',
-    access: 'write',
-    description: '发布慕课手记文章（Markdown，始终存为草稿）。正文默认为 Markdown；外链图自动转存到慕课图床。',
-    domain: 'www.imooc.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    args: [
-        { name: 'title', positional: true, required: true, help: '文章标题' },
-        { name: 'text', positional: true, help: '文章正文（Markdown，默认）' },
-        { name: 'file', help: '正文文件路径（UTF-8，Markdown）' },
-        { name: 'html', type: 'boolean', help: '将正文视为原始 HTML 而非 Markdown' },
-        { name: 'draft', type: 'boolean', help: '（慕课始终草稿，此标志无额外效果）' },
-        { name: 'execute', type: 'boolean', help: '真正执行写入，不加此标志时拒绝写操作' },
-    ],
-    columns: ['status', 'outcome', 'message', 'target_type', 'target', 'created_target', 'created_url'],
-    func: async (page, kwargs) => {
-        if (!page) throw new CommandExecutionError('慕课手记发布需要浏览器会话');
-        requireExecute(kwargs);
-        const title = String(kwargs.title ?? '').trim();
-        if (!title) throw new CliError('INVALID_INPUT', '文章标题不能为空');
-        const body = await resolvePayload(kwargs);
-
-        const result = await publishArticle(page, {
-            title,
-            body,
-            format: kwargs.html ? 'html' : 'markdown',
-            draftOnly: true,   // 慕课始终草稿
-            profile: imoocProfile,
-        });
-
-        const upN = result.images.uploaded.length | 0;
-        const failN = result.images.failed.length | 0;
-        let message = '已保存慕课手记草稿';
-        if (upN || failN) {
-            message += `・图片：${upN} 张已转存${failN ? `，${failN} 张失败` : ''}`;
-        }
-        return buildResultRow(
-            message,
-            'article',
-            '',
-            'draft',
-            { created_target: 'article:' + result.id, created_url: result.url },
-        );
-    },
-});
-
-// imoocProfile 已在声明时 export，whoami.js 直接从此文件 import 即可。
+import{CliError as M,CommandExecutionError as W}from"@jackwener/opencli/errors";import{cli as X,Strategy as Y}from"@jackwener/opencli/registry";import{publishArticle as Z}from"../_shared/article/publish.js";import{checkLogin as I}from"../_shared/article/auth.js";import{readFile as $,stat as q}from"node:fs/promises";export const imoocProfile={home:"https://www.imooc.com/article",outputFormat:"markdown",checkAuth:async(H)=>{let z=await(await fetch("https://www.imooc.com/u/card",{credentials:"include"})).text();z=z.replace(/^jsonpcallback\(/,"").replace(/\}\)$/,"}");let B;try{B=JSON.parse(z)}catch(G){return{isAuthenticated:!1,error:"JSONP 解析失败："+String(G&&G.message||G)}}if(!B||B.result!==0)return{isAuthenticated:!1,error:B&&B.msg||"未登录"};return{isAuthenticated:!0,userId:String(B.data.uid),username:B.data.nickname,avatar:B.data.img}},image:{uploadFn:async(H,K)=>{const z=await fetch(H,{credentials:"omit"});if(!z.ok)throw Error("图片下载失败：HTTP "+z.status);const B=await z.blob(),G=Date.now()+".jpg",J=new File([B],G,{type:B.type||"image/jpeg"}),L=new FormData;L.append("photo",J,G);L.append("type",J.type);L.append("id","WU_FILE_0");L.append("name",G);L.append("lastModifiedDate",new Date().toString());L.append("size",String(J.size));const O=await(await fetch("https://www.imooc.com/article/ajaxuploadimg",{method:"POST",credentials:"include",body:L})).json();if(!O||O.result!==0)throw Error(O&&O.msg||"图片上传失败");let Q=O.data.imgpath;if(Q&&Q.indexOf("//")===0)Q="https:"+Q;return{url:Q}},skip:["img.imooc.com","imooc.com"]},publish:async(H,K)=>{const z=await fetch("https://www.imooc.com/article/savedraft",{method:"POST",credentials:"include",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({editor:"0",draft_id:"0",title:H.title,content:H.content})});if(!z.ok){const J=await z.text();return{ok:!1,stage:"savedraft",status:z.status,message:J.slice(0,300)}}const B=await z.json();if(!B||!B.data){const J=JSON.stringify(B).slice(0,300);return{ok:!1,stage:"savedraft",status:z.status,message:"保存草稿失败："+J}}const G=String(B.data);return{ok:!0,id:G,url:"https://www.imooc.com/article/draft/id/"+G,draft:!0}}};function A(H){if(!H.execute)throw new M("INVALID_INPUT","此命令需要 --execute 才会真正写入。不加 --execute 时仅做格式校验。")}async function F(H){const K=typeof H.text==="string"?H.text:void 0,z=typeof H.file==="string"?H.file:void 0;if(K&&z)throw new M("INVALID_INPUT","<text> 和 --file 不能同时使用");let B=K??"";if(z){let G;try{G=await q(z)}catch{throw new M("INVALID_INPUT","文件不存在："+z)}if(!G.isFile())throw new M("INVALID_INPUT","路径必须是可读文本文件："+z);let J;try{J=await $(z)}catch{throw new M("INVALID_INPUT","文件读取失败："+z)}try{B=new TextDecoder("utf-8",{fatal:!0}).decode(J)}catch{throw new M("INVALID_INPUT","文件不是有效 UTF-8："+z)}}if(!B.trim())throw new M("INVALID_INPUT","正文不能为空");return B}function T(H,K,z,B,G={}){return[{status:"success",outcome:B,message:H,target_type:K,target:z,...G}]}X({site:"imooc",name:"article",access:"write",description:"发布慕课手记文章（Markdown，始终存为草稿）。正文默认为 Markdown；外链图自动转存到慕课图床。",domain:"www.imooc.com",strategy:Y.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题"},{name:"text",positional:!0,help:"文章正文（Markdown，默认）"},{name:"file",help:"正文文件路径（UTF-8，Markdown）"},{name:"html",type:"boolean",help:"将正文视为原始 HTML 而非 Markdown"},{name:"draft",type:"boolean",help:"（慕课始终草稿，此标志无额外效果）"},{name:"execute",type:"boolean",help:"真正执行写入，不加此标志时拒绝写操作"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(H,K)=>{if(!H)throw new W("慕课手记发布需要浏览器会话");A(K);const z=String(K.title??"").trim();if(!z)throw new M("INVALID_INPUT","文章标题不能为空");const B=await F(K),G=await Z(H,{title:z,body:B,format:K.html?"html":"markdown",draftOnly:!0,profile:imoocProfile}),J=G.images.uploaded.length|0,L=G.images.failed.length|0;let V="已保存慕课手记草稿";if(J||L)V+=`・图片：${J} 张已转存${L?`，${L} 张失败`:""}`;return T(V,"article","","draft",{created_target:"article:"+G.id,created_url:G.url})}});

package/clis/imooc/login.js

@@ -1,15 +1 @@
-import { registerArticleLogin } from '../_shared/article/login.js';
-import { imoocProfile } from './article.js';
-
-// 慕课网 login 命令：补桌面客户端「登录」按钮所需的 `imooc login`。
-// 登录态判定复用 imoocProfile.checkAuth（与 whoami 同源），打开手记发布页（未登录会被
-// 重定向到登录页）让用户完成登录。
-registerArticleLogin({
-    site: 'imooc',
-    domain: 'imooc.com',
-    profile: {
-        home: imoocProfile.home,
-        checkAuth: imoocProfile.checkAuth,
-    },
-    loginDescription: '打开慕课网登录页并等待浏览器完成登录（供桌面客户端引导登录）。',
-});
+import{registerArticleLogin as k}from"../_shared/article/login.js";import{imoocProfile as b}from"./article.js";k({site:"imooc",domain:"imooc.com",profile:{home:b.home,checkAuth:b.checkAuth},loginDescription:"打开慕课网登录页并等待浏览器完成登录（供桌面客户端引导登录）。"});

package/clis/imooc/whoami.js

@@ -1,33 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { checkLogin, cookieQuickCheck } from '../_shared/article/auth.js';
-import { imoocProfile } from './article.js';
-
-// 从 article profile 提取 authProfile（home + checkAuth）
-const authProfile = {
-    home: imoocProfile.home,
-    checkAuth: imoocProfile.checkAuth,
-};
-
-cli({
-    site: 'imooc',
-    name: 'whoami',
-    access: 'read',
-    description: '查询当前在 Chrome 里登录的慕课网账号。',
-    domain: 'www.imooc.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    columns: ['logged_in', 'user_id', 'username'],
-    // 快速登录检测（`auth status` quick / 桌面 GUI 用）：慕课网登录态由 apsid
-    // 承载（实测：去掉它鉴权接口翻匿名，仅留它也仍登录）。
-    authStatus: {
-        quickCheck: cookieQuickCheck('https://www.imooc.com', ['apsid']),
-    },
-    func: async (page) => {
-        const r = await checkLogin(page, authProfile);
-        return [{
-            logged_in: r.isAuthenticated,
-            user_id: r.userId || '',
-            username: r.username || '',
-        }];
-    },
-});
+import{cli as x,Strategy as z}from"@jackwener/opencli/registry";import{checkLogin as A,cookieQuickCheck as B}from"../_shared/article/auth.js";import{imoocProfile as q}from"./article.js";const D={home:q.home,checkAuth:q.checkAuth};x({site:"imooc",name:"whoami",access:"read",description:"查询当前在 Chrome 里登录的慕课网账号。",domain:"www.imooc.com",strategy:z.COOKIE,browser:!0,columns:["logged_in","user_id","username"],authStatus:{quickCheck:B("https://www.imooc.com",["apsid"])},func:async(v)=>{const b=await A(v,D);return[{logged_in:b.isAuthenticated,user_id:b.userId||"",username:b.username||""}]}});

package/clis/indeed/job.js

@@ -1,43 +1,4 @@
-/**
- * Indeed job detail.
- *
- * Reads the full job posting (title, company, location, salary, job type,
- * description) for a given `jk` (job key, the 16-char id surfaced by
- * `indeed search`). Browser-driven for the same Cloudflare reason as
- * `search`.
- */
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError, CommandExecutionError } from '@jackwener/opencli/errors';
-import {
-    JOB_COLUMNS,
-    requireJobKey,
-    buildJobUrl,
-} from './utils.js';
-
-cli({
-    site: 'indeed',
-    name: 'job',
-    aliases: ['detail', 'view'],
-    access: 'read',
-    description: 'Read the full Indeed job posting by jk (job key)',
-    domain: 'www.indeed.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        { name: 'id', positional: true, required: true, help: 'Job key (16-char hex from `indeed search`, e.g. "dccc07ac5a6a3683")' },
-    ],
-    columns: JOB_COLUMNS,
-    func: async (page, kwargs) => {
-        const jk = requireJobKey(kwargs.id);
-        const url = buildJobUrl(jk);
-        await page.goto(url);
-        await page.wait(4);
-
-        let detail;
-        try {
-            detail = await page.evaluate(`(async () => {
+import{cli as d,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as s,CommandExecutionError as a}from"@jackwener/opencli/errors";import{JOB_COLUMNS as l,requireJobKey as m,buildJobUrl as y}from"./utils.js";d({site:"indeed",name:"job",aliases:["detail","view"],access:"read",description:"Read the full Indeed job posting by jk (job key)",domain:"www.indeed.com",strategy:c.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"id",positional:!0,required:!0,help:'Job key (16-char hex from `indeed search`, e.g. "dccc07ac5a6a3683")'}],columns:l,func:async(t,i)=>{const o=m(i.id),r=y(o);await t.goto(r);await t.wait(4);let e;try{e=await t.evaluate(`(async () => {
                 let ready = !!document.querySelector('#jobDescriptionText, h1, [data-testid="error-page"]');
                 for (let i = 0; i < 30; i++) {
                     if (ready) break;
@@ -56,31 +17,4 @@ cli({
                     .join(', ');
                 const description = document.querySelector('#jobDescriptionText')?.innerText?.trim() ?? '';
                 return { ready, challenge, notFound, title, company, location, salary, jobType, description };
-            })()`);
-        }
-        catch (e) {
-            throw new CommandExecutionError(`Failed to scrape Indeed job detail DOM: ${e?.message ?? e}`, 'The page may not have fully loaded; try again.');
-        }
-
-        if (detail?.challenge) {
-            throw new CommandExecutionError('Indeed served a Cloudflare challenge page', 'Open https://www.indeed.com in the connected browser and clear the challenge, then retry.');
-        }
-        if (!detail?.ready) {
-            throw new CommandExecutionError('Indeed job page did not expose detail or error markers within 15s', 'Indeed may still be loading or the DOM shape may have changed; retry after opening Indeed in the connected browser.');
-        }
-        if (detail?.notFound || (!detail?.title && !detail?.description)) {
-            throw new EmptyResultError('indeed job', `No Indeed job posting found for jk "${jk}"`);
-        }
-
-        return [{
-            id: jk,
-            title: detail.title.replace(/\s+/g, ' ').trim(),
-            company: detail.company.replace(/\s+/g, ' ').trim(),
-            location: detail.location.replace(/\s+/g, ' ').trim(),
-            salary: detail.salary.replace(/\s+/g, ' ').trim(),
-            job_type: detail.jobType.replace(/\s+/g, ' ').trim(),
-            description: detail.description,
-            url,
-        }];
-    },
-});
+            })()`)}catch(n){throw new a(`Failed to scrape Indeed job detail DOM: ${n?.message??n}`,"The page may not have fully loaded; try again.")}if(e?.challenge)throw new a("Indeed served a Cloudflare challenge page","Open https://www.indeed.com in the connected browser and clear the challenge, then retry.");if(!e?.ready)throw new a("Indeed job page did not expose detail or error markers within 15s","Indeed may still be loading or the DOM shape may have changed; retry after opening Indeed in the connected browser.");if(e?.notFound||!e?.title&&!e?.description)throw new s("indeed job",`No Indeed job posting found for jk "${o}"`);return[{id:o,title:e.title.replace(/\s+/g," ").trim(),company:e.company.replace(/\s+/g," ").trim(),location:e.location.replace(/\s+/g," ").trim(),salary:e.salary.replace(/\s+/g," ").trim(),job_type:e.jobType.replace(/\s+/g," ").trim(),description:e.description,url:r}]}});

package/clis/indeed/search.js

@@ -1,58 +1,4 @@
-/**
- * Indeed keyword search.
- *
- * Drives the public `/jobs?q=&l=` listing page through a real browser
- * because Cloudflare returns 403 to bare fetches. Extraction happens
- * inside `page.evaluate` against the rendered DOM (Indeed's JSON-island
- * is heavily obfuscated and changes shape per A/B bucket).
- */
-
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError, CommandExecutionError } from '@jackwener/opencli/errors';
-import {
-    SEARCH_COLUMNS,
-    requireQuery,
-    requireBoundedInt,
-    requireNonNegativeInt,
-    requireFromage,
-    requireSort,
-    buildSearchUrl,
-    searchCardToRow,
-} from './utils.js';
-
-cli({
-    site: 'indeed',
-    name: 'search',
-    access: 'read',
-    description: 'Indeed keyword job search (rendered DOM via browser session, US site)',
-    domain: 'www.indeed.com',
-    strategy: Strategy.COOKIE,
-    browser: true,
-    navigateBefore: false,
-    args: [
-        { name: 'query', positional: true, required: true, help: 'Job keyword (title / skill / company)' },
-        { name: 'location', type: 'string', default: '', help: 'Location filter (e.g. "remote", "New York, NY", "San Francisco")' },
-        { name: 'fromage', type: 'string', default: '', help: 'Recency filter, days back: 1 / 3 / 7 / 14' },
-        { name: 'sort', type: 'string', default: 'relevance', help: 'Sort order: relevance | date' },
-        { name: 'start', type: 'int', default: 0, help: 'Pagination offset (multiple of 10, 0-based)' },
-        { name: 'limit', type: 'int', default: 15, help: 'Max rows to return (1-25, capped at one page)' },
-    ],
-    columns: SEARCH_COLUMNS,
-    func: async (page, kwargs) => {
-        const query = requireQuery(kwargs.query);
-        const location = String(kwargs.location ?? '').trim();
-        const fromage = requireFromage(kwargs.fromage);
-        const sort = requireSort(kwargs.sort);
-        const start = requireNonNegativeInt(kwargs.start, 0, 'start');
-        const limit = requireBoundedInt(kwargs.limit, 15, 25, 'limit');
-
-        const url = buildSearchUrl({ query, location, fromage, sort, start });
-        await page.goto(url);
-        await page.wait(4);
-
-        let cards;
-        try {
-            cards = await page.evaluate(`(async () => {
+import{cli as y,Strategy as p}from"@jackwener/opencli/registry";import{EmptyResultError as b,CommandExecutionError as o}from"@jackwener/opencli/errors";import{SEARCH_COLUMNS as f,requireQuery as g,requireBoundedInt as w,requireNonNegativeInt as S,requireFromage as q,requireSort as j,buildSearchUrl as C,searchCardToRow as k}from"./utils.js";y({site:"indeed",name:"search",access:"read",description:"Indeed keyword job search (rendered DOM via browser session, US site)",domain:"www.indeed.com",strategy:p.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"query",positional:!0,required:!0,help:"Job keyword (title / skill / company)"},{name:"location",type:"string",default:"",help:'Location filter (e.g. "remote", "New York, NY", "San Francisco")'},{name:"fromage",type:"string",default:"",help:"Recency filter, days back: 1 / 3 / 7 / 14"},{name:"sort",type:"string",default:"relevance",help:"Sort order: relevance | date"},{name:"start",type:"int",default:0,help:"Pagination offset (multiple of 10, 0-based)"},{name:"limit",type:"int",default:15,help:"Max rows to return (1-25, capped at one page)"}],columns:f,func:async(r,e)=>{const s=g(e.query),n=String(e.location??"").trim(),l=q(e.fromage),d=j(e.sort),i=S(e.start,0,"start"),u=w(e.limit,15,25,"limit"),m=C({query:s,location:n,fromage:l,sort:d,start:i});await r.goto(m);await r.wait(4);let t;try{t=await r.evaluate(`(async () => {
                 const hasResults = () => !!document.querySelector('.job_seen_beacon');
                 const hasEmptyState = () => {
                     const text = document.body?.innerText || '';
@@ -88,23 +34,4 @@ cli({
                 const blockedHeadline = document.title || '';
                 const challenge = blockedHeadline.includes('Just a moment') || !!document.querySelector('[id^="cf-"]');
                 return { cards: out, challenge, ready };
-            })()`);
-        }
-        catch (e) {
-            throw new CommandExecutionError(`Failed to scrape Indeed search DOM: ${e?.message ?? e}`, 'The page may not have fully loaded; try again.');
-        }
-
-        if (cards?.challenge) {
-            throw new CommandExecutionError('Indeed served a Cloudflare challenge page', 'Open https://www.indeed.com in the connected browser and clear the challenge, then retry.');
-        }
-        if (!cards?.ready) {
-            throw new CommandExecutionError('Indeed search page did not expose result or empty-state markers within 15s', 'Indeed may still be loading or the DOM shape may have changed; retry after opening Indeed in the connected browser.');
-        }
-
-        const list = Array.isArray(cards?.cards) ? cards.cards : [];
-        if (list.length === 0) {
-            throw new EmptyResultError('indeed search', `No Indeed jobs matched "${query}"${location ? ` in ${location}` : ''}`);
-        }
-        return list.slice(0, limit).map((c, i) => searchCardToRow(c, start + i + 1));
-    },
-});
+            })()`)}catch(a){throw new o(`Failed to scrape Indeed search DOM: ${a?.message??a}`,"The page may not have fully loaded; try again.")}if(t?.challenge)throw new o("Indeed served a Cloudflare challenge page","Open https://www.indeed.com in the connected browser and clear the challenge, then retry.");if(!t?.ready)throw new o("Indeed search page did not expose result or empty-state markers within 15s","Indeed may still be loading or the DOM shape may have changed; retry after opening Indeed in the connected browser.");const c=Array.isArray(t?.cards)?t.cards:[];if(c.length===0)throw new b("indeed search",`No Indeed jobs matched "${s}"${n?` in ${n}`:""}`);return c.slice(0,u).map((a,h)=>k(a,i+h+1))}});

package/clis/indeed/utils.js

@@ -1,152 +1 @@
-/**
- * Indeed adapter utilities.
- *
- * Indeed sits behind Cloudflare and answers bare fetches with HTTP 403
- * (`cf-mitigated: challenge`). The whole adapter therefore runs through a
- * real browser session (Strategy.COOKIE), and DOM extraction lives inside
- * `page.evaluate` blocks. The helpers below are mostly arg-validation +
- * pure normalizers so they stay unit-testable without a browser.
- */
-
-import { ArgumentError } from '@jackwener/opencli/errors';
-
-export const INDEED_ORIGIN = 'https://www.indeed.com';
-
-/** Job key (jk) shape — 16-char lowercase hex. */
-const JK_PATTERN = /^[a-f0-9]{16}$/;
-
-const FROMAGE_VALUES = new Set(['1', '3', '7', '14']);
-
-const SORT_VALUES = new Set(['relevance', 'date']);
-
-/**
- * Coerce a value to a strict integer. Accepts numeric strings, rejects
- * floats / non-numeric / NaN. Returns NaN on invalid input so callers can
- * decide on the right typed error.
- */
-export function coerceInt(value) {
-    if (value === undefined || value === null || value === '') return NaN;
-    const n = typeof value === 'number' ? value : Number(value);
-    return Number.isFinite(n) && Number.isInteger(n) ? n : NaN;
-}
-
-export function requireBoundedInt(value, defaultValue, maxValue, label) {
-    const raw = value ?? defaultValue;
-    const n = coerceInt(raw);
-    if (!Number.isInteger(n) || n <= 0) {
-        throw new ArgumentError(`indeed ${label} must be a positive integer`);
-    }
-    if (n > maxValue) {
-        throw new ArgumentError(`indeed ${label} must be <= ${maxValue}`);
-    }
-    return n;
-}
-
-export function requireNonNegativeInt(value, defaultValue, label) {
-    const raw = value ?? defaultValue;
-    const n = coerceInt(raw);
-    if (!Number.isInteger(n) || n < 0) {
-        throw new ArgumentError(`indeed ${label} must be a non-negative integer`);
-    }
-    return n;
-}
-
-export function requireJobKey(value) {
-    const id = String(value ?? '').trim().toLowerCase();
-    if (!id) {
-        throw new ArgumentError('indeed job id is required');
-    }
-    if (!JK_PATTERN.test(id)) {
-        throw new ArgumentError(`indeed job id "${value}" is not a valid jk (expected 16-char lowercase hex)`);
-    }
-    return id;
-}
-
-export function requireQuery(value, label = 'query') {
-    const q = String(value ?? '').trim();
-    if (!q) {
-        throw new ArgumentError(`indeed ${label} cannot be empty`);
-    }
-    return q;
-}
-
-/** "1" / "3" / "7" / "14" — accepted by Indeed's `fromage` filter. */
-export function requireFromage(value) {
-    if (value === undefined || value === null || value === '') return '';
-    const v = String(value).trim();
-    if (!FROMAGE_VALUES.has(v)) {
-        throw new ArgumentError(`indeed fromage must be one of 1/3/7/14 (days), got "${value}"`);
-    }
-    return v;
-}
-
-export function requireSort(value, defaultValue = 'relevance') {
-    const v = String(value ?? defaultValue).trim().toLowerCase();
-    if (!SORT_VALUES.has(v)) {
-        throw new ArgumentError(`indeed sort must be "relevance" or "date", got "${value}"`);
-    }
-    return v;
-}
-
-/**
- * Build an Indeed search URL with only the user-supplied filters set.
- * Indeed treats absent params as defaults; we never pass empty strings
- * because the page will echo them back into the query and the URL
- * stays cleaner for round-tripping.
- */
-export function buildSearchUrl({ query, location, fromage, sort, start }) {
-    const params = new URLSearchParams();
-    params.set('q', query);
-    if (location) params.set('l', location);
-    if (fromage) params.set('fromage', fromage);
-    if (sort && sort !== 'relevance') params.set('sort', sort);
-    if (start && start > 0) params.set('start', String(start));
-    return `${INDEED_ORIGIN}/jobs?${params.toString()}`;
-}
-
-export function buildJobUrl(jk) {
-    return `${INDEED_ORIGIN}/viewjob?jk=${jk}`;
-}
-
-/** Strip a salary-snippet duplicate out of the metadata pill list. */
-export function dedupeTags(tags, salary) {
-    const out = [];
-    for (const t of tags) {
-        const trimmed = String(t || '').trim();
-        if (!trimmed) continue;
-        if (salary && trimmed === salary) continue;
-        if (out.includes(trimmed)) continue;
-        out.push(trimmed);
-    }
-    return out.join(' · ');
-}
-
-/**
- * Normalize a parsed search-card object into the row shape declared by
- * `SEARCH_COLUMNS`. Drops nulls into empty strings, defends against
- * Indeed surface drift by treating missing fields as empty rather than
- * silently mislabeling them.
- */
-export function searchCardToRow(card, rank) {
-    const jk = String(card?.jk ?? '').trim();
-    const salary = String(card?.salary ?? '').trim();
-    const tags = Array.isArray(card?.tags) ? card.tags : [];
-    return {
-        rank,
-        id: jk,
-        title: String(card?.title ?? '').replace(/\s+/g, ' ').trim(),
-        company: String(card?.company ?? '').replace(/\s+/g, ' ').trim(),
-        location: String(card?.location ?? '').replace(/\s+/g, ' ').trim(),
-        salary,
-        tags: dedupeTags(tags, salary),
-        url: jk ? buildJobUrl(jk) : '',
-    };
-}
-
-export const SEARCH_COLUMNS = [
-    'rank', 'id', 'title', 'company', 'location', 'salary', 'tags', 'url',
-];
-
-export const JOB_COLUMNS = [
-    'id', 'title', 'company', 'location', 'salary', 'job_type', 'description', 'url',
-];
+import{ArgumentError as $}from"@jackwener/opencli/errors";export const INDEED_ORIGIN="https://www.indeed.com";const z=/^[a-f0-9]{16}$/,F=new Set(["1","3","7","14"]),H=new Set(["relevance","date"]);export function coerceInt(B){if(B===void 0||B===null||B==="")return NaN;const Q=typeof B==="number"?B:Number(B);return Number.isFinite(Q)&&Number.isInteger(Q)?Q:NaN}export function requireBoundedInt(B,Q,W,Y){const Z=coerceInt(B??Q);if(!Number.isInteger(Z)||Z<=0)throw new $(`indeed ${Y} must be a positive integer`);if(Z>W)throw new $(`indeed ${Y} must be <= ${W}`);return Z}export function requireNonNegativeInt(B,Q,W){const X=coerceInt(B??Q);if(!Number.isInteger(X)||X<0)throw new $(`indeed ${W} must be a non-negative integer`);return X}export function requireJobKey(B){const Q=String(B??"").trim().toLowerCase();if(!Q)throw new $("indeed job id is required");if(!z.test(Q))throw new $(`indeed job id "${B}" is not a valid jk (expected 16-char lowercase hex)`);return Q}export function requireQuery(B,Q="query"){const W=String(B??"").trim();if(!W)throw new $(`indeed ${Q} cannot be empty`);return W}export function requireFromage(B){if(B===void 0||B===null||B==="")return"";const Q=String(B).trim();if(!F.has(Q))throw new $(`indeed fromage must be one of 1/3/7/14 (days), got "${B}"`);return Q}export function requireSort(B,Q="relevance"){const W=String(B??Q).trim().toLowerCase();if(!H.has(W))throw new $(`indeed sort must be "relevance" or "date", got "${B}"`);return W}export function buildSearchUrl({query:B,location:Q,fromage:W,sort:Y,start:X}){const Z=new URLSearchParams;Z.set("q",B);if(Q)Z.set("l",Q);if(W)Z.set("fromage",W);if(Y&&Y!=="relevance")Z.set("sort",Y);if(X&&X>0)Z.set("start",String(X));return`${INDEED_ORIGIN}/jobs?${Z.toString()}`}export function buildJobUrl(B){return`${INDEED_ORIGIN}/viewjob?jk=${B}`}export function dedupeTags(B,Q){const W=[];for(const Y of B){const X=String(Y||"").trim();if(!X)continue;if(Q&&X===Q)continue;if(W.includes(X))continue;W.push(X)}return W.join(" · ")}export function searchCardToRow(B,Q){const W=String(B?.jk??"").trim(),Y=String(B?.salary??"").trim(),X=Array.isArray(B?.tags)?B.tags:[];return{rank:Q,id:W,title:String(B?.title??"").replace(/\s+/g," ").trim(),company:String(B?.company??"").replace(/\s+/g," ").trim(),location:String(B?.location??"").replace(/\s+/g," ").trim(),salary:Y,tags:dedupeTags(X,Y),url:W?buildJobUrl(W):""}}export const SEARCH_COLUMNS=["rank","id","title","company","location","salary","tags","url"],JOB_COLUMNS=["id","title","company","location","salary","job_type","description","url"];