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

package/clis/12306/train.js

@@ -1,91 +1 @@
-/**
- * 12306 train stop details - list every station a train calls at,
- * with arrival / departure / stopover time.
- *
- * Requires the internal `train_no` returned by `12306 trains`
- * (`24000000G10L`), not the public train code (`G1`).
- */
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-import { fetchStationBundle, mintSession, resolveStation, validateDate } from './utils.js';
-
-const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36';
-const TRAIN_NO_RE = /^[0-9A-Za-z]{8,18}$/;
-
-async function queryStops(cookieHeader, trainNo, fromCode, toCode, date, fetchImpl = fetch) {
-    const url = `https://kyfw.12306.cn/otn/czxx/queryByTrainNo?train_no=${trainNo}&from_station_telecode=${fromCode}&to_station_telecode=${toCode}&depart_date=${date}`;
-    const resp = await fetchImpl(url, {
-        headers: {
-            'User-Agent': UA,
-            'Referer': 'https://kyfw.12306.cn/otn/leftTicket/init',
-            'Cookie': cookieHeader,
-        },
-    });
-    if (!resp.ok) {
-        throw new CommandExecutionError(`12306 queryByTrainNo returned HTTP ${resp.status}`);
-    }
-    let json;
-    try {
-        json = await resp.json();
-    } catch {
-        throw new CommandExecutionError('12306 queryByTrainNo returned non-JSON body');
-    }
-    if (json?.status !== true || !Array.isArray(json?.data?.data)) {
-        throw new CommandExecutionError(`12306 queryByTrainNo returned an unexpected payload shape`);
-    }
-    return json.data.data;
-}
-
-cli({
-    site: '12306',
-    name: 'train',
-    access: 'read',
-    description: 'List every station a 12306 train calls at, with arrival / departure / stopover time (anonymous, no login required)',
-    domain: 'kyfw.12306.cn',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'train-no', positional: true, required: true, help: 'Internal train_no from `12306 trains` (e.g. 24000000G10L), not the public code (G1)' },
-        { name: 'from', required: true, help: 'Origin station for the segment: Chinese name, telecode, or pinyin' },
-        { name: 'to', required: true, help: 'Destination station for the segment' },
-        { name: 'date', required: true, help: 'Departure date in YYYY-MM-DD' },
-    ],
-    columns: ['station_no', 'station_name', 'arrive_time', 'start_time', 'stopover_time'],
-    func: async (kwargs) => {
-        const trainNo = String(kwargs['train-no'] ?? '').trim();
-        if (!trainNo) throw new ArgumentError('<train-no> must not be empty');
-        if (!TRAIN_NO_RE.test(trainNo)) {
-            throw new ArgumentError(
-                `<train-no> "${trainNo}" does not look like a 12306 internal train_no`,
-                'Use the train_no field from `12306 trains` output (e.g. 24000000G10L), not the public code (G1).',
-            );
-        }
-        const fromArg = String(kwargs.from ?? '').trim();
-        const toArg = String(kwargs.to ?? '').trim();
-        if (!fromArg) throw new ArgumentError('--from station must not be empty');
-        if (!toArg) throw new ArgumentError('--to station must not be empty');
-        const date = validateDate(kwargs.date);
-
-        const stations = await fetchStationBundle();
-        const fromStation = resolveStation(stations, fromArg);
-        const toStation = resolveStation(stations, toArg);
-        if (fromStation.code === toStation.code) {
-            throw new ArgumentError(`--from and --to must differ; both resolved to ${fromStation.name} (${fromStation.code})`);
-        }
-
-        const cookieHeader = await mintSession();
-        const stops = await queryStops(cookieHeader, trainNo, fromStation.code, toStation.code, date);
-        if (stops.length === 0) {
-            throw new EmptyResultError(`No stops returned for train_no=${trainNo} on ${date}`);
-        }
-        return stops.map((s) => ({
-            station_no: s.station_no || '',
-            station_name: s.station_name || '',
-            arrive_time: s.arrive_time === '----' ? '' : (s.arrive_time || ''),
-            start_time: s.start_time === '----' ? '' : (s.start_time || ''),
-            stopover_time: s.stopover_time === '----' ? '' : (s.stopover_time || ''),
-        }));
-    },
-});
-
-export const __test__ = { queryStops, TRAIN_NO_RE };
+import{cli as h,Strategy as y}from"@jackwener/opencli/registry";import{ArgumentError as a,CommandExecutionError as u,EmptyResultError as w}from"@jackwener/opencli/errors";import{fetchStationBundle as v,mintSession as g,resolveStation as p,validateDate as S}from"./utils.js";const b="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36",f=/^[0-9A-Za-z]{8,18}$/;async function _(o,e,s,m,c,d=fetch){const r=`https://kyfw.12306.cn/otn/czxx/queryByTrainNo?train_no=${e}&from_station_telecode=${s}&to_station_telecode=${m}&depart_date=${c}`,n=await d(r,{headers:{"User-Agent":b,Referer:"https://kyfw.12306.cn/otn/leftTicket/init",Cookie:o}});if(!n.ok)throw new u(`12306 queryByTrainNo returned HTTP ${n.status}`);let i;try{i=await n.json()}catch{throw new u("12306 queryByTrainNo returned non-JSON body")}if(i?.status!==!0||!Array.isArray(i?.data?.data))throw new u("12306 queryByTrainNo returned an unexpected payload shape");return i.data.data}h({site:"12306",name:"train",access:"read",description:"List every station a 12306 train calls at, with arrival / departure / stopover time (anonymous, no login required)",domain:"kyfw.12306.cn",strategy:y.PUBLIC,browser:!1,args:[{name:"train-no",positional:!0,required:!0,help:"Internal train_no from `12306 trains` (e.g. 24000000G10L), not the public code (G1)"},{name:"from",required:!0,help:"Origin station for the segment: Chinese name, telecode, or pinyin"},{name:"to",required:!0,help:"Destination station for the segment"},{name:"date",required:!0,help:"Departure date in YYYY-MM-DD"}],columns:["station_no","station_name","arrive_time","start_time","stopover_time"],func:async(o)=>{const e=String(o["train-no"]??"").trim();if(!e)throw new a("<train-no> must not be empty");if(!f.test(e))throw new a(`<train-no> "${e}" does not look like a 12306 internal train_no`,"Use the train_no field from `12306 trains` output (e.g. 24000000G10L), not the public code (G1).");const s=String(o.from??"").trim(),m=String(o.to??"").trim();if(!s)throw new a("--from station must not be empty");if(!m)throw new a("--to station must not be empty");const c=S(o.date),d=await v(),r=p(d,s),n=p(d,m);if(r.code===n.code)throw new a(`--from and --to must differ; both resolved to ${r.name} (${r.code})`);const i=await g(),l=await _(i,e,r.code,n.code,c);if(l.length===0)throw new w(`No stops returned for train_no=${e} on ${c}`);return l.map((t)=>({station_no:t.station_no||"",station_name:t.station_name||"",arrive_time:t.arrive_time==="----"?"":t.arrive_time||"",start_time:t.start_time==="----"?"":t.start_time||"",stopover_time:t.stopover_time==="----"?"":t.stopover_time||""}))}});export const __test__={queryStops:_,TRAIN_NO_RE:f};

package/clis/12306/trains.js

@@ -1,166 +1 @@
-/**
- * 12306 train availability between two stations on a given date.
- *
- * Flow:
- *   1. Fetch the station bundle (cached implicitly via per-process module state).
- *   2. Mint anonymous session cookies via /otn/leftTicket/init.
- *   3. Query /otn/leftTicket/queryG; if 12306 returns
- *      `{c_url: "leftTicket/queryX"}` (endpoint rotation), retry once
- *      against the suggested name.
- *   4. Parse the `|`-separated train records.
- */
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-import { fetchStationBundle, mintSession, resolveStation, validateDate, parseTrainRecord } from './utils.js';
-
-const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36';
-const QUERY_ENDPOINTS = ['queryG', 'queryO', 'queryZ', 'queryA'];
-const MAX_LIMIT = 100;
-const QUERY_ENDPOINT_RE = /^query[A-Z]$/;
-
-function normalizeLimit(value, defaultValue, max) {
-    if (value === undefined || value === null || value === '') return defaultValue;
-    const n = Number(value);
-    if (!Number.isInteger(n) || n < 1) {
-        throw new ArgumentError(`limit must be a positive integer (1-${max})`);
-    }
-    if (n > max) {
-        throw new ArgumentError(`limit must be <= ${max}`);
-    }
-    return n;
-}
-
-function extractQueryEndpoint(value) {
-    const raw = String(value ?? '').trim();
-    if (!raw) return '';
-    const direct = raw.replace(/^leftTicket\//, '').trim();
-    if (QUERY_ENDPOINT_RE.test(direct)) return direct;
-    try {
-        const url = new URL(raw, 'https://kyfw.12306.cn');
-        if (url.hostname !== 'kyfw.12306.cn') return '';
-        const match = url.pathname.match(/\/leftTicket\/(query[A-Z])$/);
-        return match ? match[1] : '';
-    }
-    catch {
-        return '';
-    }
-}
-
-async function parseRotationEndpoint(resp, endpoint, bodyText) {
-    let json;
-    if (bodyText) {
-        try { json = JSON.parse(bodyText); } catch { /* body may be HTML on non-rotation redirects */ }
-    }
-    const bodyEndpoint = extractQueryEndpoint(json?.c_url);
-    if (bodyEndpoint) return bodyEndpoint;
-    const locationEndpoint = extractQueryEndpoint(resp.headers?.get?.('location'));
-    if (locationEndpoint) return locationEndpoint;
-    if (resp.status === 302) {
-        throw new CommandExecutionError(`12306 ${endpoint} redirected without a leftTicket query endpoint`);
-    }
-    if (json?.c_url) {
-        throw new CommandExecutionError(`12306 ${endpoint} returned an invalid rotation endpoint`);
-    }
-    return '';
-}
-
-async function queryLeftTickets(cookieHeader, fromCode, toCode, date) {
-    const headers = {
-        'User-Agent': UA,
-        'Referer': 'https://kyfw.12306.cn/otn/leftTicket/init',
-        'Cookie': cookieHeader,
-    };
-    const queryParams = `leftTicketDTO.train_date=${date}&leftTicketDTO.from_station=${fromCode}&leftTicketDTO.to_station=${toCode}&purpose_codes=ADULT`;
-    let lastResponseText = '';
-    const queue = [...QUERY_ENDPOINTS];
-    const tried = new Set();
-    while (queue.length > 0) {
-        const endpoint = queue.shift();
-        if (tried.has(endpoint)) continue;
-        tried.add(endpoint);
-        const url = `https://kyfw.12306.cn/otn/leftTicket/${endpoint}?${queryParams}`;
-        const resp = await fetch(url, { headers, redirect: 'manual' });
-        if (!resp.ok) {
-            if (resp.status === 302) {
-                const body = await resp.text();
-                const rotated = await parseRotationEndpoint(resp, endpoint, body);
-                if (rotated && !tried.has(rotated)) {
-                    queue.unshift(rotated);
-                }
-                continue;
-            }
-            throw new CommandExecutionError(`12306 ${endpoint} returned HTTP ${resp.status}`);
-        }
-        const text = await resp.text();
-        lastResponseText = text;
-        let json;
-        try { json = JSON.parse(text); } catch {
-            throw new CommandExecutionError(`12306 ${endpoint} returned non-JSON body`);
-        }
-        if (json?.c_url && typeof json.c_url === 'string') {
-            const rotated = await parseRotationEndpoint(resp, endpoint, text);
-            if (rotated && !tried.has(rotated)) {
-                queue.unshift(rotated);
-            }
-            continue;
-        }
-        if (Array.isArray(json?.data?.result)) {
-            return json.data.result;
-        }
-        throw new CommandExecutionError(`12306 ${endpoint} returned an unexpected payload shape`);
-    }
-    throw new CommandExecutionError(`12306 rejected every known query endpoint name (${QUERY_ENDPOINTS.join(', ')}); the wire protocol may have changed. Last body: ${lastResponseText.slice(0, 200)}`);
-}
-
-cli({
-    site: '12306',
-    name: 'trains',
-    access: 'read',
-    description: 'List trains between two 12306 stations on a given date (anonymous, no login required)',
-    domain: 'kyfw.12306.cn',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'from', positional: true, required: true, help: 'Origin station: Chinese name (北京), telecode (BJP), or pinyin (beijing)' },
-        { name: 'to', positional: true, required: true, help: 'Destination station: same forms as <from>' },
-        { name: 'date', required: true, help: 'Departure date in YYYY-MM-DD' },
-        { name: 'limit', type: 'int', default: 50, help: `Maximum rows (1-${MAX_LIMIT})` },
-    ],
-    columns: [
-        'code', 'from_station', 'to_station', 'start_time', 'arrive_time',
-        'duration', 'available', 'business_seat', 'first_seat', 'second_seat',
-        'soft_sleeper', 'hard_sleeper', 'hard_seat', 'no_seat', 'train_no',
-    ],
-    func: async (kwargs) => {
-        const fromArg = String(kwargs.from ?? '').trim();
-        const toArg = String(kwargs.to ?? '').trim();
-        if (!fromArg) throw new ArgumentError('<from> station must not be empty');
-        if (!toArg) throw new ArgumentError('<to> station must not be empty');
-        const date = validateDate(kwargs.date);
-        const limit = normalizeLimit(kwargs.limit, 50, MAX_LIMIT);
-
-        const stations = await fetchStationBundle();
-        const fromStation = resolveStation(stations, fromArg);
-        const toStation = resolveStation(stations, toArg);
-        if (fromStation.code === toStation.code) {
-            throw new ArgumentError(`<from> and <to> must differ; both resolved to ${fromStation.name} (${fromStation.code})`);
-        }
-        const stationByCode = new Map(stations.map((s) => [s.code, s]));
-
-        const cookieHeader = await mintSession();
-        const rawRows = await queryLeftTickets(cookieHeader, fromStation.code, toStation.code, date);
-        const decoded = rawRows
-            .map((line) => parseTrainRecord(decodeURIComponent(line.replace(/%0A/g, '')), stationByCode))
-            .filter(Boolean);
-
-        if (decoded.length === 0) {
-            throw new EmptyResultError(
-                `No trains found from ${fromStation.name} to ${toStation.name} on ${date}`,
-                'Try a different date or check whether the route is operated by 12306.',
-            );
-        }
-        return decoded.slice(0, limit);
-    },
-});
-
-export const __test__ = { normalizeLimit, extractQueryEndpoint, queryLeftTickets };
+import{cli as b,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentError as H,CommandExecutionError as Y,EmptyResultError as j}from"@jackwener/opencli/errors";import{fetchStationBundle as C,mintSession as A,resolveStation as N,validateDate as v,parseTrainRecord as w}from"./utils.js";const f="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36",Q=["queryG","queryO","queryZ","queryA"],_=100,k=/^query[A-Z]$/;function q(F,K,J){if(F===void 0||F===null||F==="")return K;const G=Number(F);if(!Number.isInteger(G)||G<1)throw new H(`limit must be a positive integer (1-${J})`);if(G>J)throw new H(`limit must be <= ${J}`);return G}function U(F){const K=String(F??"").trim();if(!K)return"";const J=K.replace(/^leftTicket\//,"").trim();if(k.test(J))return J;try{const G=new URL(K,"https://kyfw.12306.cn");if(G.hostname!=="kyfw.12306.cn")return"";const $=G.pathname.match(/\/leftTicket\/(query[A-Z])$/);return $?$[1]:""}catch{return""}}async function I(F,K,J){let G;if(J)try{G=JSON.parse(J)}catch{}const $=U(G?.c_url);if($)return $;const z=U(F.headers?.get?.("location"));if(z)return z;if(F.status===302)throw new Y(`12306 ${K} redirected without a leftTicket query endpoint`);if(G?.c_url)throw new Y(`12306 ${K} returned an invalid rotation endpoint`);return""}async function L(F,K,J,G){const $={"User-Agent":f,Referer:"https://kyfw.12306.cn/otn/leftTicket/init",Cookie:F},z=`leftTicketDTO.train_date=${G}&leftTicketDTO.from_station=${K}&leftTicketDTO.to_station=${J}&purpose_codes=ADULT`;let B="";const V=[...Q],O=new Set;while(V.length>0){const W=V.shift();if(O.has(W))continue;O.add(W);const M=`https://kyfw.12306.cn/otn/leftTicket/${W}?${z}`,Z=await fetch(M,{headers:$,redirect:"manual"});if(!Z.ok){if(Z.status===302){const D=await Z.text(),P=await I(Z,W,D);if(P&&!O.has(P))V.unshift(P);continue}throw new Y(`12306 ${W} returned HTTP ${Z.status}`)}const X=await Z.text();B=X;let h;try{h=JSON.parse(X)}catch{throw new Y(`12306 ${W} returned non-JSON body`)}if(h?.c_url&&typeof h.c_url==="string"){const D=await I(Z,W,X);if(D&&!O.has(D))V.unshift(D);continue}if(Array.isArray(h?.data?.result))return h.data.result;throw new Y(`12306 ${W} returned an unexpected payload shape`)}throw new Y(`12306 rejected every known query endpoint name (${Q.join(", ")}); the wire protocol may have changed. Last body: ${B.slice(0,200)}`)}b({site:"12306",name:"trains",access:"read",description:"List trains between two 12306 stations on a given date (anonymous, no login required)",domain:"kyfw.12306.cn",strategy:R.PUBLIC,browser:!1,args:[{name:"from",positional:!0,required:!0,help:"Origin station: Chinese name (北京), telecode (BJP), or pinyin (beijing)"},{name:"to",positional:!0,required:!0,help:"Destination station: same forms as <from>"},{name:"date",required:!0,help:"Departure date in YYYY-MM-DD"},{name:"limit",type:"int",default:50,help:`Maximum rows (1-${_})`}],columns:["code","from_station","to_station","start_time","arrive_time","duration","available","business_seat","first_seat","second_seat","soft_sleeper","hard_sleeper","hard_seat","no_seat","train_no"],func:async(F)=>{const K=String(F.from??"").trim(),J=String(F.to??"").trim();if(!K)throw new H("<from> station must not be empty");if(!J)throw new H("<to> station must not be empty");const G=v(F.date),$=q(F.limit,50,_),z=await C(),B=N(z,K),V=N(z,J);if(B.code===V.code)throw new H(`<from> and <to> must differ; both resolved to ${B.name} (${B.code})`);const O=new Map(z.map((X)=>[X.code,X])),W=await A(),Z=(await L(W,B.code,V.code,G)).map((X)=>w(decodeURIComponent(X.replace(/%0A/g,"")),O)).filter(Boolean);if(Z.length===0)throw new j(`No trains found from ${B.name} to ${V.name} on ${G}`,"Try a different date or check whether the route is operated by 12306.");return Z.slice(0,$)}});export const __test__={normalizeLimit:q,extractQueryEndpoint:U,queryLeftTickets:L};

package/clis/12306/utils.js

@@ -1,272 +1 @@
-/**
- * 12306 (中国铁路) shared helpers.
- *
- * - Station lookup: parses the public `station_name.js` bundle into
- *   structured records.
- * - Cookie session: 12306's query endpoints reject anonymous requests
- *   with `HTTP 302 -> error.html`, so callers must hit `/otn/leftTicket/init`
- *   first to mint the JSESSIONID / route / BIGipServerotn cookies.
- * - Query endpoint rotation: 12306 rotates the train-query endpoint
- *   name (queryO / queryZ / queryA / queryG / ...) every few weeks.
- *   When the wrong name is hit, the server returns
- *   `{"c_url":"leftTicket/queryG","c_name":"CLeftTicketUrl","status":false}`
- *   pointing to the current correct name; retry once with that name.
- */
-import { ArgumentError, CommandExecutionError } from '@jackwener/opencli/errors';
-
-const STATION_BUNDLE_URL = 'https://kyfw.12306.cn/otn/resources/js/framework/station_name.js';
-const INIT_URL = 'https://kyfw.12306.cn/otn/leftTicket/init';
-const UA = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36';
-
-const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-const STATION_CODE_RE = /^[A-Z]{2,4}$/;
-
-/**
- * Parse the `station_name.js` bundle into a station record array.
- *
- * Bundle format (single line, `@`-delimited records, each `|`-delimited):
- *   `var station_names ='@bjb|北京北|VAP|beijingbei|bjb|0|0357|北京|||...';`
- *
- * Per-record fields (positional):
- *   [0] short pinyin alias  (e.g. `bjb`)
- *   [1] Chinese station name (e.g. `北京北`)
- *   [2] telecode (3-4 uppercase letters, e.g. `VAP`) - this is the
- *       wire format 12306 uses for `from_station` / `to_station`.
- *   [3] full pinyin           (e.g. `beijingbei`)
- *   [4] short alias           (duplicate of [0] usually)
- *   [5] index/rank
- *   [6] city code
- *   [7] city name             (e.g. `北京`)
- */
-export function parseStationBundle(text) {
-    const match = text.match(/'([^']+)'/);
-    if (!match) {
-        throw new CommandExecutionError('Failed to parse 12306 station_name.js: source string not found');
-    }
-    const raw = match[1];
-    const records = raw.split('@').filter(Boolean);
-    const stations = [];
-    for (const r of records) {
-        const parts = r.split('|');
-        if (parts.length < 8 || !parts[2]) continue;
-        stations.push({
-            short: parts[0] || '',
-            name: parts[1] || '',
-            code: parts[2] || '',
-            pinyin: parts[3] || '',
-            abbr: parts[4] || '',
-            city: parts[7] || '',
-        });
-    }
-    if (stations.length === 0) {
-        throw new CommandExecutionError('Failed to parse 12306 station_name.js: no station records found');
-    }
-    return stations;
-}
-
-/**
- * Resolve a user-supplied station identifier to a telecode.
- *
- * Accepts Chinese name (`上海虹桥`), telecode (`AOH`), pinyin
- * (`shanghaihongqiao`), short alias (`shh`), or city name with a
- * preference for the city's main station.
- */
-export function resolveStation(stations, input) {
-    const trimmed = String(input ?? '').trim();
-    if (!trimmed) throw new ArgumentError('station must not be empty');
-    if (STATION_CODE_RE.test(trimmed)) {
-        const exact = stations.find((s) => s.code === trimmed);
-        if (exact) return exact;
-        throw new ArgumentError(`Unknown 12306 station telecode "${trimmed}"`);
-    }
-    const lower = trimmed.toLowerCase();
-    const exactName = stations.find((s) => s.name === trimmed);
-    if (exactName) return exactName;
-    const exactPinyin = stations.find((s) => s.pinyin === lower);
-    if (exactPinyin) return exactPinyin;
-    const exactAbbr = stations.find((s) => s.abbr === lower || s.short === lower);
-    if (exactAbbr) return exactAbbr;
-    throw new ArgumentError(`Unknown 12306 station "${trimmed}"`, 'Try the Chinese name (上海虹桥), the 3-4 letter telecode (AOH), or full pinyin (shanghaihongqiao).');
-}
-
-export function validateDate(value) {
-    if (!DATE_RE.test(String(value ?? ''))) {
-        throw new ArgumentError(`date must be YYYY-MM-DD, got "${value}"`);
-    }
-    const [y, m, d] = value.split('-').map(Number);
-    const date = new Date(Date.UTC(y, m - 1, d));
-    if (date.getUTCFullYear() !== y || date.getUTCMonth() !== m - 1 || date.getUTCDate() !== d) {
-        throw new ArgumentError(`date "${value}" is not a real calendar date`);
-    }
-    return value;
-}
-
-/** Extract Set-Cookie header values into a single `Cookie:` header string. */
-export function buildCookieHeader(setCookieHeaders) {
-    if (!Array.isArray(setCookieHeaders) || setCookieHeaders.length === 0) return '';
-    return setCookieHeaders
-        .map((line) => line.split(';')[0])
-        .filter(Boolean)
-        .join('; ');
-}
-
-export async function fetchStationBundle(fetchImpl = fetch) {
-    const resp = await fetchImpl(STATION_BUNDLE_URL, {
-        headers: { 'User-Agent': UA },
-    });
-    if (!resp.ok) {
-        throw new CommandExecutionError(`Failed to fetch 12306 station bundle: HTTP ${resp.status}`);
-    }
-    return parseStationBundle(await resp.text());
-}
-
-/** Mint a 12306 anonymous session by hitting /otn/leftTicket/init. */
-export async function mintSession(fetchImpl = fetch) {
-    const resp = await fetchImpl(INIT_URL, {
-        headers: { 'User-Agent': UA },
-        redirect: 'follow',
-    });
-    if (!resp.ok) {
-        throw new CommandExecutionError(`Failed to mint 12306 session: HTTP ${resp.status}`);
-    }
-    const setCookies = typeof resp.headers.getSetCookie === 'function'
-        ? resp.headers.getSetCookie()
-        : resp.headers.raw?.()['set-cookie'] || [];
-    const cookieHeader = buildCookieHeader(setCookies);
-    if (!cookieHeader) {
-        throw new CommandExecutionError('12306 init returned no session cookies');
-    }
-    return cookieHeader;
-}
-
-/**
- * Twelve-row train query record (LEFT_TICKET_DTO).
- *
- * 12306 returns each train as a `|`-separated string with ~36 fields.
- * Positions used here come from the public web client; unused
- * positions are documented inline so future maintainers can extend
- * the row shape without re-reverse-engineering.
- */
-export function parseTrainRecord(line, stationByCode) {
-    const f = line.split('|');
-    if (f.length < 33) return null;
-    return {
-        train_no: f[2] || '',
-        code: f[3] || '',
-        from_station: stationByCode.get(f[6])?.name || f[6] || '',
-        to_station: stationByCode.get(f[7])?.name || f[7] || '',
-        from_code: f[6] || '',
-        to_code: f[7] || '',
-        start_time: f[8] || '',
-        arrive_time: f[9] || '',
-        duration: f[10] || '',
-        available: (f[1] || '').trim() === '预订' || (f[11] || '').trim() === 'Y',
-        business_seat: f[32] || '',
-        first_seat: f[31] || '',
-        second_seat: f[30] || '',
-        soft_sleeper: f[23] || '',
-        hard_sleeper: f[28] || '',
-        hard_seat: f[29] || '',
-        no_seat: f[26] || '',
-    };
-}
-
-/**
- * Mask helpers for sensitive identity fields rendered by 12306.
- *
- * 12306 already masks ID numbers and mobile numbers server-side
- * (`xxxx***********xxx` / `138****xxxx`); these helpers handle the
- * remaining fields (email, real Chinese name) so the adapter never
- * leaks unmasked PII without an explicit `--include-sensitive` opt-in.
- */
-export function maskEmail(value) {
-    const v = String(value || '').trim();
-    if (!v) return '';
-    const at = v.indexOf('@');
-    if (at <= 0) return v;
-    const local = v.slice(0, at);
-    const domain = v.slice(at);
-    if (local.length <= 2) return local[0] + '*' + domain;
-    return local[0] + '*'.repeat(Math.max(1, local.length - 2)) + local.slice(-1) + domain;
-}
-
-export function maskMobile(value) {
-    const v = String(value || '').trim();
-    if (!v) return '';
-    if (/\*/.test(v)) return v;
-    if (v.length < 7) return v.replace(/.(?=.)/g, '*');
-    return v.slice(0, 3) + '*'.repeat(v.length - 7) + v.slice(-4);
-}
-
-export function maskChineseName(value) {
-    const v = String(value || '').trim();
-    if (!v) return '';
-    if (v.length === 1) return v;
-    if (v.length === 2) return v[0] + '*';
-    return v[0] + '*'.repeat(v.length - 2) + v.slice(-1);
-}
-
-export function unwrapEvaluateResult(value) {
-    if (
-        value
-        && typeof value === 'object'
-        && !Array.isArray(value)
-        && Object.prototype.hasOwnProperty.call(value, 'session')
-        && Object.prototype.hasOwnProperty.call(value, 'data')
-    ) {
-        return value.data;
-    }
-    return value;
-}
-
-export function requireEvaluateObject(value, label) {
-    const payload = unwrapEvaluateResult(value);
-    if (!payload || typeof payload !== 'object' || Array.isArray(payload)) {
-        throw new CommandExecutionError(`12306 ${label} returned a malformed browser payload`);
-    }
-    return payload;
-}
-
-export function isAuthLikePayload(payload) {
-    if (!payload || typeof payload !== 'object') return false;
-    const parts = [];
-    if (Array.isArray(payload.messages)) parts.push(...payload.messages);
-    if (payload.message) parts.push(payload.message);
-    if (payload.msg) parts.push(payload.msg);
-    if (payload.validateMessages && typeof payload.validateMessages === 'object') {
-        parts.push(...Object.values(payload.validateMessages).flat());
-    }
-    const text = parts.map((item) => String(item ?? '')).join(' ');
-    return /未登录|登录|请登录|身份|认证|session|Session|login/i.test(text);
-}
-
-/**
- * Detect the 12306 login marker by reading `document.cookie` from the
- * current adapter page. Cannot use `page.getCookies({url})` here:
- * 12306 sets the auth cookie `tk` and `JSESSIONID` with `Path=/otn`,
- * and CDP `Network.getCookies` with a bare URL filter excludes
- * cookies whose path does not match the URL path. `document.cookie`
- * returns all non-httponly cookies visible to the current page
- * regardless of path, which is what we need to confirm login.
- */
-export async function require12306Login(page, AuthRequiredErrorClass) {
-    const docCookie = unwrapEvaluateResult(await page.evaluate(`document.cookie || ''`));
-    const cookieStr = typeof docCookie === 'string' ? docCookie : '';
-    if (!/\btk=/.test(cookieStr) || !/JSESSIONID=/.test(cookieStr)) {
-        throw new AuthRequiredErrorClass('kyfw.12306.cn', 'Not logged into 12306. Sign in at https://kyfw.12306.cn first.');
-    }
-}
-
-export const __test__ = {
-    parseStationBundle,
-    resolveStation,
-    validateDate,
-    buildCookieHeader,
-    parseTrainRecord,
-    maskEmail,
-    maskMobile,
-    maskChineseName,
-    unwrapEvaluateResult,
-    requireEvaluateObject,
-    isAuthLikePayload,
-};
+import{ArgumentError as Y,CommandExecutionError as X}from"@jackwener/opencli/errors";const M="https://kyfw.12306.cn/otn/resources/js/framework/station_name.js",j="https://kyfw.12306.cn/otn/leftTicket/init",$="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/127.0 Safari/537.36",q=/^\d{4}-\d{2}-\d{2}$/,O=/^[A-Z]{2,4}$/;export function parseStationBundle(F){const z=F.match(/'([^']+)'/);if(!z)throw new X("Failed to parse 12306 station_name.js: source string not found");const K=z[1].split("@").filter(Boolean),Q=[];for(const Z of K){const V=Z.split("|");if(V.length<8||!V[2])continue;Q.push({short:V[0]||"",name:V[1]||"",code:V[2]||"",pinyin:V[3]||"",abbr:V[4]||"",city:V[7]||""})}if(Q.length===0)throw new X("Failed to parse 12306 station_name.js: no station records found");return Q}export function resolveStation(F,z){const G=String(z??"").trim();if(!G)throw new Y("station must not be empty");if(O.test(G)){const W=F.find((J)=>J.code===G);if(W)return W;throw new Y(`Unknown 12306 station telecode "${G}"`)}const K=G.toLowerCase(),Q=F.find((W)=>W.name===G);if(Q)return Q;const Z=F.find((W)=>W.pinyin===K);if(Z)return Z;const V=F.find((W)=>W.abbr===K||W.short===K);if(V)return V;throw new Y(`Unknown 12306 station "${G}"`,"Try the Chinese name (上海虹桥), the 3-4 letter telecode (AOH), or full pinyin (shanghaihongqiao).")}export function validateDate(F){if(!q.test(String(F??"")))throw new Y(`date must be YYYY-MM-DD, got "${F}"`);const[z,G,K]=F.split("-").map(Number),Q=new Date(Date.UTC(z,G-1,K));if(Q.getUTCFullYear()!==z||Q.getUTCMonth()!==G-1||Q.getUTCDate()!==K)throw new Y(`date "${F}" is not a real calendar date`);return F}export function buildCookieHeader(F){if(!Array.isArray(F)||F.length===0)return"";return F.map((z)=>z.split(";")[0]).filter(Boolean).join("; ")}export async function fetchStationBundle(F=fetch){const z=await F(M,{headers:{"User-Agent":$}});if(!z.ok)throw new X(`Failed to fetch 12306 station bundle: HTTP ${z.status}`);return parseStationBundle(await z.text())}export async function mintSession(F=fetch){const z=await F(j,{headers:{"User-Agent":$},redirect:"follow"});if(!z.ok)throw new X(`Failed to mint 12306 session: HTTP ${z.status}`);const G=typeof z.headers.getSetCookie==="function"?z.headers.getSetCookie():z.headers.raw?.()["set-cookie"]||[],K=buildCookieHeader(G);if(!K)throw new X("12306 init returned no session cookies");return K}export function parseTrainRecord(F,z){const G=F.split("|");if(G.length<33)return null;return{train_no:G[2]||"",code:G[3]||"",from_station:z.get(G[6])?.name||G[6]||"",to_station:z.get(G[7])?.name||G[7]||"",from_code:G[6]||"",to_code:G[7]||"",start_time:G[8]||"",arrive_time:G[9]||"",duration:G[10]||"",available:(G[1]||"").trim()==="预订"||(G[11]||"").trim()==="Y",business_seat:G[32]||"",first_seat:G[31]||"",second_seat:G[30]||"",soft_sleeper:G[23]||"",hard_sleeper:G[28]||"",hard_seat:G[29]||"",no_seat:G[26]||""}}export function maskEmail(F){const z=String(F||"").trim();if(!z)return"";const G=z.indexOf("@");if(G<=0)return z;const K=z.slice(0,G),Q=z.slice(G);if(K.length<=2)return K[0]+"*"+Q;return K[0]+"*".repeat(Math.max(1,K.length-2))+K.slice(-1)+Q}export function maskMobile(F){const z=String(F||"").trim();if(!z)return"";if(/\*/.test(z))return z;if(z.length<7)return z.replace(/.(?=.)/g,"*");return z.slice(0,3)+"*".repeat(z.length-7)+z.slice(-4)}export function maskChineseName(F){const z=String(F||"").trim();if(!z)return"";if(z.length===1)return z;if(z.length===2)return z[0]+"*";return z[0]+"*".repeat(z.length-2)+z.slice(-1)}export function unwrapEvaluateResult(F){if(F&&typeof F==="object"&&!Array.isArray(F)&&Object.prototype.hasOwnProperty.call(F,"session")&&Object.prototype.hasOwnProperty.call(F,"data"))return F.data;return F}export function requireEvaluateObject(F,z){const G=unwrapEvaluateResult(F);if(!G||typeof G!=="object"||Array.isArray(G))throw new X(`12306 ${z} returned a malformed browser payload`);return G}export function isAuthLikePayload(F){if(!F||typeof F!=="object")return!1;const z=[];if(Array.isArray(F.messages))z.push(...F.messages);if(F.message)z.push(F.message);if(F.msg)z.push(F.msg);if(F.validateMessages&&typeof F.validateMessages==="object")z.push(...Object.values(F.validateMessages).flat());const G=z.map((K)=>String(K??"")).join(" ");return/未登录|登录|请登录|身份|认证|session|Session|login/i.test(G)}export async function require12306Login(F,z){const G=unwrapEvaluateResult(await F.evaluate("document.cookie || ''")),K=typeof G==="string"?G:"";if(!/\btk=/.test(K)||!/JSESSIONID=/.test(K))throw new z("kyfw.12306.cn","Not logged into 12306. Sign in at https://kyfw.12306.cn first.")}export const __test__={parseStationBundle,resolveStation,validateDate,buildCookieHeader,parseTrainRecord,maskEmail,maskMobile,maskChineseName,unwrapEvaluateResult,requireEvaluateObject,isAuthLikePayload};

package/clis/1688/assets.js

@@ -1,7 +1,4 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { assertAuthenticatedState, buildDetailUrl, buildProvenance, cleanText, extractOfferId, gotoAndReadState, uniqueMediaSources, } from './shared.js';
-function scriptToReadAssets() {
-    return `
+import{cli as g,Strategy as f}from"@jackwener/opencli/registry";import{assertAuthenticatedState as h,buildDetailUrl as m,buildProvenance as y,cleanText as o,extractOfferId as v,gotoAndReadState as w,uniqueMediaSources as I}from"./shared.js";function k(){return`
     (() => {
       const root = window.context ?? {};
       const model = root.result?.global?.globalData?.model ?? null;
@@ -127,79 +124,4 @@ function scriptToReadAssets() {
         scannedAssets: assets,
       };
     })()
-  `;
-}
-function normalizeAssets(payload) {
-    const offerId = cleanText(String(payload.offerId ?? '')) || extractOfferId(cleanText(payload.href)) || null;
-    const itemUrl = offerId ? buildDetailUrl(offerId) : cleanText(payload.href);
-    const seededAssets = [
-        ...((payload.gallery?.mainImage ?? []).map((url) => ({ type: 'image', group: 'main', url, source: 'page_state:mainImage' }))),
-        ...((payload.gallery?.offerImgList ?? []).map((url) => ({ type: 'image', group: 'main', url, source: 'page_state:offerImgList' }))),
-        ...((payload.gallery?.wlImageInfos ?? []).map((item) => ({
-            type: 'image',
-            group: 'main',
-            url: item?.fullPathImageURI ?? '',
-            source: 'page_state:wlImageInfos',
-        }))),
-    ];
-    const assets = uniqueMediaSources([...seededAssets, ...(payload.scannedAssets ?? [])]);
-    const mainImages = assets.filter((item) => item.type === 'image' && item.group === 'main').map((item) => item.url);
-    const skuImages = assets.filter((item) => item.type === 'image' && item.group === 'sku').map((item) => item.url);
-    const detailImages = assets.filter((item) => item.type === 'image' && item.group === 'detail').map((item) => item.url);
-    const videos = assets.filter((item) => item.type === 'video').map((item) => item.url);
-    const otherImages = assets
-        .filter((item) => item.type === 'image' && !['main', 'sku', 'detail'].includes(item.group))
-        .map((item) => item.url);
-    return {
-        offer_id: offerId,
-        title: cleanText(payload.offerTitle) || cleanText(payload.title) || null,
-        item_url: itemUrl,
-        main_images: mainImages,
-        sku_images: skuImages,
-        detail_images: detailImages,
-        videos,
-        other_images: otherImages,
-        raw_assets: assets,
-        source: [...new Set(assets.map((item) => cleanText(item.source)).filter(Boolean))],
-        main_count: mainImages.length,
-        sku_count: skuImages.length,
-        detail_count: detailImages.length,
-        video_count: videos.length,
-        ...buildProvenance(cleanText(payload.href) || itemUrl),
-    };
-}
-async function readAssetsPayload(page, itemUrl) {
-    const state = await gotoAndReadState(page, itemUrl, 2500, 'assets');
-    assertAuthenticatedState(state, 'assets');
-    await page.autoScroll({ times: 3, delayMs: 400 });
-    await page.wait(1);
-    return await page.evaluate(scriptToReadAssets());
-}
-export async function extractAssetsForInput(page, input) {
-    const itemUrl = buildDetailUrl(String(input ?? ''));
-    const payload = await readAssetsPayload(page, itemUrl);
-    return normalizeAssets(payload);
-}
-cli({
-    site: '1688',
-    name: 'assets',
-    access: 'read',
-    description: '列出 1688 商品页可提取的图片/视频素材',
-    domain: 'www.1688.com',
-    strategy: Strategy.COOKIE,
-    args: [
-        {
-            name: 'input',
-            required: true,
-            positional: true,
-            help: '1688 商品 URL 或 offer ID（如 887904326744）',
-        },
-    ],
-    columns: ['offer_id', 'title', 'main_count', 'sku_count', 'detail_count', 'video_count'],
-    func: async (page, kwargs) => {
-        return [await extractAssetsForInput(page, String(kwargs.input ?? ''))];
-    },
-});
-export const __test__ = {
-    normalizeAssets,
-};
+  `}function p(t){const r=o(String(t.offerId??""))||v(o(t.href))||null,a=r?m(r):o(t.href),n=[...(t.gallery?.mainImage??[]).map((e)=>({type:"image",group:"main",url:e,source:"page_state:mainImage"})),...(t.gallery?.offerImgList??[]).map((e)=>({type:"image",group:"main",url:e,source:"page_state:offerImgList"})),...(t.gallery?.wlImageInfos??[]).map((e)=>({type:"image",group:"main",url:e?.fullPathImageURI??"",source:"page_state:wlImageInfos"}))],s=I([...n,...t.scannedAssets??[]]),l=s.filter((e)=>e.type==="image"&&e.group==="main").map((e)=>e.url),i=s.filter((e)=>e.type==="image"&&e.group==="sku").map((e)=>e.url),c=s.filter((e)=>e.type==="image"&&e.group==="detail").map((e)=>e.url),u=s.filter((e)=>e.type==="video").map((e)=>e.url),d=s.filter((e)=>e.type==="image"&&!["main","sku","detail"].includes(e.group)).map((e)=>e.url);return{offer_id:r,title:o(t.offerTitle)||o(t.title)||null,item_url:a,main_images:l,sku_images:i,detail_images:c,videos:u,other_images:d,raw_assets:s,source:[...new Set(s.map((e)=>o(e.source)).filter(Boolean))],main_count:l.length,sku_count:i.length,detail_count:c.length,video_count:u.length,...y(o(t.href)||a)}}async function S(t,r){const a=await w(t,r,2500,"assets");h(a,"assets");await t.autoScroll({times:3,delayMs:400});await t.wait(1);return await t.evaluate(k())}export async function extractAssetsForInput(t,r){const a=m(String(r??"")),n=await S(t,a);return p(n)}g({site:"1688",name:"assets",access:"read",description:"列出 1688 商品页可提取的图片/视频素材",domain:"www.1688.com",strategy:f.COOKIE,args:[{name:"input",required:!0,positional:!0,help:"1688 商品 URL 或 offer ID（如 887904326744）"}],columns:["offer_id","title","main_count","sku_count","detail_count","video_count"],func:async(t,r)=>{return[await extractAssetsForInput(t,String(r.input??""))]}});export const __test__={normalizeAssets:p};