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

package/clis/ctrip/hotel-suggest.js

@@ -1,45 +1 @@
-/**
- * 携程酒店 hotel-context suggest — public city/business-area/hotel lookup.
- *
- * Distinct from `ctrip/search` (destination): the same backing endpoint is
- * called with `searchType=H`, surfacing Hotel and BusinessArea rows that the
- * destination flavour does not return.
- */
-import { ArgumentError, EmptyResultError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { fetchSuggest, mapSuggestRow, parseLimit } from './utils.js';
-
-cli({
-    site: 'ctrip',
-    name: 'hotel-suggest',
-    access: 'read',
-    description: '搜索携程酒店上下文联想：城市、商圈、单酒店匹配',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', required: true, positional: true, help: 'Search keyword (city, business area, or hotel name)' },
-        { name: 'limit', type: 'int', default: 15, help: 'Number of results (1-50)' },
-    ],
-    columns: [
-        'rank', 'id', 'type', 'displayType', 'name', 'eName',
-        'cityId', 'cityName', 'provinceName', 'countryName',
-        'lat', 'lon', 'score', 'url',
-    ],
-    func: async (kwargs) => {
-        const query = String(kwargs.query || '').trim();
-        if (!query) {
-            throw new ArgumentError('Search keyword cannot be empty');
-        }
-        const limit = parseLimit(kwargs.limit);
-        const raw = await fetchSuggest(query, 'H');
-        const rows = raw
-            .filter((item) => !!item && typeof item === 'object')
-            .slice(0, limit)
-            .map(mapSuggestRow)
-            .filter((row) => row.name);
-        if (!rows.length) {
-            throw new EmptyResultError('ctrip hotel-suggest', 'Try a city, business area, or hotel keyword such as "陆家嘴" or "汉庭酒店"');
-        }
-        return rows;
-    },
-});
+import{ArgumentError as o,EmptyResultError as a}from"@jackwener/opencli/errors";import{cli as n,Strategy as c}from"@jackwener/opencli/registry";import{fetchSuggest as l,mapSuggestRow as u,parseLimit as m}from"./utils.js";n({site:"ctrip",name:"hotel-suggest",access:"read",description:"搜索携程酒店上下文联想：城市、商圈、单酒店匹配",strategy:c.PUBLIC,browser:!1,args:[{name:"query",required:!0,positional:!0,help:"Search keyword (city, business area, or hotel name)"},{name:"limit",type:"int",default:15,help:"Number of results (1-50)"}],columns:["rank","id","type","displayType","name","eName","cityId","cityName","provinceName","countryName","lat","lon","score","url"],func:async(t)=>{const r=String(t.query||"").trim();if(!r)throw new o("Search keyword cannot be empty");const i=m(t.limit),s=(await l(r,"H")).filter((e)=>!!e&&typeof e==="object").slice(0,i).map(u).filter((e)=>e.name);if(!s.length)throw new a("ctrip hotel-suggest",'Try a city, business area, or hotel keyword such as "陆家嘴" or "汉庭酒店"');return s}});

package/clis/ctrip/search.js

@@ -1,41 +1 @@
-/**
- * 携程旅行 destination suggest — public city/landmark/scenic-spot lookup.
- */
-import { ArgumentError, EmptyResultError } from '@jackwener/opencli/errors';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { fetchSuggest, mapSuggestRow, parseLimit } from './utils.js';
-
-cli({
-    site: 'ctrip',
-    name: 'search',
-    access: 'read',
-    description: '搜索携程目的地、景区、火车站和地标联想结果',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'query', required: true, positional: true, help: 'Search keyword (city, scenic spot, landmark)' },
-        { name: 'limit', type: 'int', default: 15, help: 'Number of results (1-50)' },
-    ],
-    columns: [
-        'rank', 'id', 'type', 'displayType', 'name', 'eName',
-        'cityId', 'cityName', 'provinceName', 'countryName',
-        'lat', 'lon', 'score', 'url',
-    ],
-    func: async (kwargs) => {
-        const query = String(kwargs.query || '').trim();
-        if (!query) {
-            throw new ArgumentError('Search keyword cannot be empty');
-        }
-        const limit = parseLimit(kwargs.limit);
-        const raw = await fetchSuggest(query, 'D');
-        const rows = raw
-            .filter((item) => !!item && typeof item === 'object')
-            .slice(0, limit)
-            .map(mapSuggestRow)
-            .filter((row) => row.name);
-        if (!rows.length) {
-            throw new EmptyResultError('ctrip search', 'Try a destination, scenic spot, or landmark keyword such as "苏州" or "故宫"');
-        }
-        return rows;
-    },
-});
+import{ArgumentError as o,EmptyResultError as s}from"@jackwener/opencli/errors";import{cli as n,Strategy as c}from"@jackwener/opencli/registry";import{fetchSuggest as m,mapSuggestRow as l,parseLimit as p}from"./utils.js";n({site:"ctrip",name:"search",access:"read",description:"搜索携程目的地、景区、火车站和地标联想结果",strategy:c.PUBLIC,browser:!1,args:[{name:"query",required:!0,positional:!0,help:"Search keyword (city, scenic spot, landmark)"},{name:"limit",type:"int",default:15,help:"Number of results (1-50)"}],columns:["rank","id","type","displayType","name","eName","cityId","cityName","provinceName","countryName","lat","lon","score","url"],func:async(r)=>{const t=String(r.query||"").trim();if(!t)throw new o("Search keyword cannot be empty");const a=p(r.limit),i=(await m(t,"D")).filter((e)=>!!e&&typeof e==="object").slice(0,a).map(l).filter((e)=>e.name);if(!i.length)throw new s("ctrip search",'Try a destination, scenic spot, or landmark keyword such as "苏州" or "故宫"');return i}});

package/clis/ctrip/utils.js

@@ -1,336 +1,4 @@
-/**
- * Shared helpers for ctrip public destination/hotel suggestion endpoints.
- *
- * The single backing endpoint `https://m.ctrip.com/restapi/soa2/21881/json/gaHotelSearchEngine`
- * accepts a `searchType` discriminator:
- *   - `D` → destination suggest (cities, scenic spots, railway stations, landmarks)
- *   - `H` → hotel-context suggest (cities, business areas, individual hotels)
- *
- * Response shape is identical; we surface every field the endpoint emits as a
- * stable column so callers do not silently lose geo / English / id metadata.
- */
-import { ArgumentError, CliError } from '@jackwener/opencli/errors';
-
-const ENDPOINT = 'https://m.ctrip.com/restapi/soa2/21881/json/gaHotelSearchEngine';
-const MIN_LIMIT = 1;
-const MAX_LIMIT = 50;
-
-export function parseLimit(raw, fallback = 15) {
-    if (raw === undefined || raw === null || raw === '') return fallback;
-    const parsed = Number(raw);
-    if (!Number.isFinite(parsed) || !Number.isInteger(parsed)) {
-        throw new ArgumentError(`--limit must be an integer between ${MIN_LIMIT} and ${MAX_LIMIT}, got ${JSON.stringify(raw)}`);
-    }
-    if (parsed < MIN_LIMIT || parsed > MAX_LIMIT) {
-        throw new ArgumentError(`--limit must be between ${MIN_LIMIT} and ${MAX_LIMIT}, got ${parsed}`);
-    }
-    return parsed;
-}
-
-export async function fetchSuggest(query, searchType) {
-    let response;
-    try {
-        response = await fetch(ENDPOINT, {
-            method: 'POST',
-            headers: { 'content-type': 'application/json' },
-            body: JSON.stringify({
-                keyword: query,
-                searchType,
-                platform: 'online',
-                pageID: '102001',
-                head: {
-                    Locale: 'zh-CN',
-                    LocaleController: 'zh_cn',
-                    Currency: 'CNY',
-                    PageId: '102001',
-                    clientID: 'opencli-ctrip',
-                    group: 'ctrip',
-                    Frontend: { sessionID: 1, pvid: 1 },
-                    HotelExtension: { group: 'CTRIP', WebpSupport: false },
-                },
-            }),
-        });
-    } catch (err) {
-        throw new CliError(
-            'FETCH_ERROR',
-            `ctrip suggest fetch failed: ${err instanceof Error ? err.message : String(err)}`,
-            'Check your network connection and retry',
-        );
-    }
-    if (!response.ok) {
-        throw new CliError(
-            'FETCH_ERROR',
-            `ctrip suggest failed with status ${response.status}`,
-            'Retry the command or verify ctrip.com is reachable',
-        );
-    }
-    let payload;
-    try {
-        payload = await response.json();
-    } catch (err) {
-        throw new CliError(
-            'COMMAND_EXEC',
-            `ctrip suggest returned invalid JSON: ${err instanceof Error ? err.message : String(err)}`,
-            'Ctrip may have changed the endpoint response format; retry later',
-        );
-    }
-    if (payload && payload.Result === false) {
-        const code = payload.ErrorCode ?? 'unknown';
-        throw new CliError(
-            'COMMAND_EXEC',
-            `ctrip suggest API returned Result=false (ErrorCode=${code})`,
-            'Verify keyword and retry; this typically means upstream rejected the query envelope',
-        );
-    }
-    return Array.isArray(payload?.Response?.searchResults) ? payload.Response.searchResults : [];
-}
-
-/**
- * Pick the best lat/lon pair available.
- *
- * Domestic Mainland China rows ship `gdLat`/`gdLon` (gaode); international rows
- * ship `gLat`/`gLon` (google/wgs84). `lat`/`lon` is the legacy flat field — fall
- * through to it last. Zero values are treated as "missing" since the endpoint
- * uses 0.0 as a sentinel for unknown coords.
- */
-export function pickCoords(item) {
-    const candidates = [
-        [item.gdLat, item.gdLon],
-        [item.gLat, item.gLon],
-        [item.lat, item.lon],
-    ];
-    for (const [la, lo] of candidates) {
-        if (Number.isFinite(la) && Number.isFinite(lo) && (la !== 0 || lo !== 0)) {
-            return { lat: la, lon: lo };
-        }
-    }
-    return { lat: null, lon: null };
-}
-
-/**
- * Build a canonical user-facing URL from the suggest item type + ids.
- * Unknown types return null (do not silently fabricate URLs).
- */
-export function buildUrl(item) {
-    const id = item?.id ? String(item.id) : '';
-    const cityId = item?.cityId ?? '';
-    const cityName = item?.cityName ? String(item.cityName) : '';
-    switch (item?.type) {
-        case 'City':
-            return cityId ? `https://you.ctrip.com/place/${encodeURIComponent(cityName)}${cityId}.html` : null;
-        case 'Markland':
-            return id && cityId
-                ? `https://you.ctrip.com/sight/${encodeURIComponent(cityName)}${cityId}/${id}.html`
-                : null;
-        case 'Hotel':
-            return id ? `https://hotels.ctrip.com/hotels/detail/?hotelid=${id}` : null;
-        case 'BusinessArea':
-        case 'Zone':
-            return cityId && id
-                ? `https://hotels.ctrip.com/hotels/list?city=${cityId}&zone=${id}`
-                : null;
-        case 'RailwayStation':
-            return id ? `https://trains.ctrip.com/trainstation/${id}.html` : null;
-        default:
-            return null;
-    }
-}
-
-function nz(v) {
-    return Number.isFinite(v) && v !== 0 ? v : null;
-}
-
-function firstNonZero(...values) {
-    for (const v of values) {
-        const n = Number(v);
-        if (Number.isFinite(n) && n !== 0) return n;
-    }
-    return null;
-}
-
-/**
- * Project a raw suggest row into the stable adapter column shape.
- * No silent fallbacks: every column has a deterministic value (string|number|null).
- */
-export function mapSuggestRow(item, index) {
-    const { lat, lon } = pickCoords(item);
-    return {
-        rank: index + 1,
-        id: item?.id ? String(item.id) : null,
-        type: item?.type ? String(item.type) : null,
-        displayType: item?.displayType ? String(item.displayType).trim() : null,
-        name: String(item?.displayName || item?.word || item?.cityName || '').replace(/\s+/g, ' ').trim() || null,
-        eName: item?.eName ? String(item.eName).trim() : null,
-        cityId: Number.isFinite(item?.cityId) && item.cityId !== 0 ? item.cityId : null,
-        cityName: item?.cityName ? String(item.cityName).trim() : null,
-        provinceName: item?.provinceName ? String(item.provinceName).trim() : null,
-        countryName: item?.countryName ? String(item.countryName).trim() : null,
-        lat,
-        lon,
-        score: firstNonZero(item?.commentScore, item?.cStar),
-        url: buildUrl(item),
-    };
-}
-
-/* --------- Helpers shared by hotel-search / flight (browser-context) ---------- */
-
-const ISO_DATE_RE = /^(\d{4})-(\d{2})-(\d{2})$/;
-
-/**
- * Validate YYYY-MM-DD and return the canonical string. Rejects out-of-range
- * month/day, malformed input, and silent NaN. Does NOT coerce or shift timezones.
- */
-export function parseIsoDate(name, raw) {
-    if (raw === undefined || raw === null || raw === '') {
-        throw new ArgumentError(`--${name} is required (YYYY-MM-DD)`);
-    }
-    const value = String(raw).trim();
-    const m = ISO_DATE_RE.exec(value);
-    if (!m) {
-        throw new ArgumentError(`--${name} must be YYYY-MM-DD, got ${JSON.stringify(raw)}`);
-    }
-    const year = Number(m[1]);
-    const month = Number(m[2]);
-    const day = Number(m[3]);
-    if (month < 1 || month > 12 || day < 1 || day > 31) {
-        throw new ArgumentError(`--${name} has invalid month/day: ${value}`);
-    }
-    // Cross-check via UTC date math so 2026-02-30 doesn't pass.
-    const parsed = new Date(Date.UTC(year, month - 1, day));
-    if (parsed.getUTCFullYear() !== year || parsed.getUTCMonth() !== month - 1 || parsed.getUTCDate() !== day) {
-        throw new ArgumentError(`--${name} is not a real calendar date: ${value}`);
-    }
-    return value;
-}
-
-/**
- * Validate a 3-letter IATA airport / metro code, return uppercase.
- * Ctrip URL accepts both single-airport (PEK / PVG) and metro-group (BJS / SHA) codes.
- */
-export function parseIataCode(name, raw) {
-    if (raw === undefined || raw === null || raw === '') {
-        throw new ArgumentError(`--${name} is required (3-letter IATA code, e.g. PEK, SHA)`);
-    }
-    const value = String(raw).trim().toUpperCase();
-    if (!/^[A-Z]{3}$/.test(value)) {
-        throw new ArgumentError(`--${name} must be a 3-letter IATA code, got ${JSON.stringify(raw)}`);
-    }
-    return value;
-}
-
-/**
- * Validate a numeric Ctrip city ID (returned by `ctrip search` / `ctrip hotel-suggest`).
- */
-export function parseCityId(raw) {
-    if (raw === undefined || raw === null || raw === '') {
-        throw new ArgumentError('--city is required (numeric city ID from `ctrip search` or `ctrip hotel-suggest`)');
-    }
-    const parsed = Number(raw);
-    if (!Number.isFinite(parsed) || !Number.isInteger(parsed) || parsed <= 0) {
-        throw new ArgumentError(`--city must be a positive integer city ID, got ${JSON.stringify(raw)}`);
-    }
-    return parsed;
-}
-
-/**
- * Pick the best lat/lon from a Ctrip hotel `positionInfo.mapCoordinate` array.
- *
- * Each entry has a `coordinateType` (1=WGS84, 2=GCJ02, 3=BD09 / Baidu). We prefer
- * WGS84 when present (most portable), then fall through. All coordinates are
- * strings in the API, so we Number() and reject NaN.
- */
-export function pickHotelMapCoords(mapCoordinate) {
-    if (!Array.isArray(mapCoordinate) || mapCoordinate.length === 0) {
-        return { lat: null, lon: null };
-    }
-    // Order: WGS84 (1) → GCJ02 (2) → BD09 (3) → whatever exists
-    const ranking = (entry) => {
-        const t = Number(entry?.coordinateType);
-        if (t === 1) return 0;
-        if (t === 2) return 1;
-        if (t === 3) return 2;
-        return 3;
-    };
-    const sorted = [...mapCoordinate].sort((a, b) => ranking(a) - ranking(b));
-    for (const entry of sorted) {
-        const lat = Number(entry?.latitude);
-        const lon = Number(entry?.longitude);
-        if (Number.isFinite(lat) && Number.isFinite(lon) && (lat !== 0 || lon !== 0)) {
-            return { lat, lon };
-        }
-    }
-    return { lat: null, lon: null };
-}
-
-/**
- * Project a single Ctrip hotel row from `__NEXT_DATA__.props.pageProps.initListData.hotelList[*]`
- * into stable adapter column shape.
- *
- * No silent fallbacks — every field is `string|number|null`, never `''` masquerading
- * as "no data" (see typed-errors.md §"scalar sentinels are anti-pattern").
- */
-export function mapHotelRow(entry, index) {
-    const hotelInfo = entry?.hotelInfo ?? {};
-    const rooms = Array.isArray(entry?.roomInfo) ? entry.roomInfo : [];
-    const summary = hotelInfo.summary ?? {};
-    const nameInfo = hotelInfo.nameInfo ?? {};
-    const hotelStar = hotelInfo.hotelStar ?? {};
-    const commentInfo = hotelInfo.commentInfo ?? {};
-    const positionInfo = hotelInfo.positionInfo ?? {};
-    const firstRoom = rooms[0] ?? {};
-    const priceInfo = firstRoom.priceInfo ?? {};
-
-    const hotelId = summary.hotelId ? String(summary.hotelId) : null;
-    const { lat, lon } = pickHotelMapCoords(positionInfo.mapCoordinate);
-
-    // commenterNumber arrives as "13,966条点评" — strip non-digits to int, else null.
-    let reviewCount = null;
-    if (commentInfo.commenterNumber) {
-        const digits = String(commentInfo.commenterNumber).replace(/[^\d]/g, '');
-        if (digits) reviewCount = Number(digits);
-    }
-    const score = commentInfo.commentScore ? Number(commentInfo.commentScore) : null;
-
-    const star = Number.isFinite(hotelStar.star) && hotelStar.star > 0 ? hotelStar.star : null;
-    const price = Number.isFinite(priceInfo.price) && priceInfo.price > 0 ? priceInfo.price : null;
-
-    return {
-        rank: index + 1,
-        hotelId,
-        name: nameInfo.name ? String(nameInfo.name).trim() : null,
-        enName: nameInfo.enName ? String(nameInfo.enName).trim() : null,
-        star,
-        score: Number.isFinite(score) && score > 0 ? score : null,
-        scoreLabel: commentInfo.commentDescription ? String(commentInfo.commentDescription).trim() : null,
-        reviewCount,
-        cityName: positionInfo.cityName ? String(positionInfo.cityName).trim() : null,
-        district: positionInfo.positionDesc ? String(positionInfo.positionDesc).trim() : null,
-        address: positionInfo.address ? String(positionInfo.address).trim() : null,
-        lat,
-        lon,
-        price,
-        currency: priceInfo.currency ? String(priceInfo.currency).trim() : null,
-        url: hotelId ? `https://hotels.ctrip.com/hotels/detail/?hotelid=${hotelId}` : null,
-    };
-}
-
-/**
- * Build the browser-context IIFE that extracts flight rows from `.flight-list`.
- *
- * Flights are rendered as `.flight-list > span > div` cards. Each card's innerText
- * has a stable ordering (verified 2026-05-12 on bjs→sha route):
- *
- *   [airline, flightNo, aircraft, lowPriceTag?, depTime, depAirport,
- *    arrTime, arrAirport, terminal?, savings?, promo?, currency, price,
- *    priceSuffix, cabin, cta]
- *
- * `lowPriceTag` (e.g. "当日低价") + `terminal` (e.g. "T2") + `savings` + `promo`
- * are optional — we use position-of-first-time-match to anchor and parse around it.
- *
- * The host is baked in so `normalizeUrl` for booking links resolves on the calling site.
- */
-export function buildFlightExtractJs() {
-    return `
+import{ArgumentError as Y,CliError as J}from"@jackwener/opencli/errors";const X="https://m.ctrip.com/restapi/soa2/21881/json/gaHotelSearchEngine",Z=1,j=50;export function parseLimit(z,K=15){if(z===void 0||z===null||z==="")return K;const G=Number(z);if(!Number.isFinite(G)||!Number.isInteger(G))throw new Y(`--limit must be an integer between ${Z} and ${j}, got ${JSON.stringify(z)}`);if(G<Z||G>j)throw new Y(`--limit must be between ${Z} and ${j}, got ${G}`);return G}export async function fetchSuggest(z,K){let G;try{G=await fetch(X,{method:"POST",headers:{"content-type":"application/json"},body:JSON.stringify({keyword:z,searchType:K,platform:"online",pageID:"102001",head:{Locale:"zh-CN",LocaleController:"zh_cn",Currency:"CNY",PageId:"102001",clientID:"opencli-ctrip",group:"ctrip",Frontend:{sessionID:1,pvid:1},HotelExtension:{group:"CTRIP",WebpSupport:!1}}})})}catch(V){throw new J("FETCH_ERROR",`ctrip suggest fetch failed: ${V instanceof Error?V.message:String(V)}`,"Check your network connection and retry")}if(!G.ok)throw new J("FETCH_ERROR",`ctrip suggest failed with status ${G.status}`,"Retry the command or verify ctrip.com is reachable");let Q;try{Q=await G.json()}catch(V){throw new J("COMMAND_EXEC",`ctrip suggest returned invalid JSON: ${V instanceof Error?V.message:String(V)}`,"Ctrip may have changed the endpoint response format; retry later")}if(Q&&Q.Result===!1){const V=Q.ErrorCode??"unknown";throw new J("COMMAND_EXEC",`ctrip suggest API returned Result=false (ErrorCode=${V})`,"Verify keyword and retry; this typically means upstream rejected the query envelope")}return Array.isArray(Q?.Response?.searchResults)?Q.Response.searchResults:[]}export function pickCoords(z){const K=[[z.gdLat,z.gdLon],[z.gLat,z.gLon],[z.lat,z.lon]];for(const[G,Q]of K)if(Number.isFinite(G)&&Number.isFinite(Q)&&(G!==0||Q!==0))return{lat:G,lon:Q};return{lat:null,lon:null}}export function buildUrl(z){const K=z?.id?String(z.id):"",G=z?.cityId??"",Q=z?.cityName?String(z.cityName):"";switch(z?.type){case"City":return G?`https://you.ctrip.com/place/${encodeURIComponent(Q)}${G}.html`:null;case"Markland":return K&&G?`https://you.ctrip.com/sight/${encodeURIComponent(Q)}${G}/${K}.html`:null;case"Hotel":return K?`https://hotels.ctrip.com/hotels/detail/?hotelid=${K}`:null;case"BusinessArea":case"Zone":return G&&K?`https://hotels.ctrip.com/hotels/list?city=${G}&zone=${K}`:null;case"RailwayStation":return K?`https://trains.ctrip.com/trainstation/${K}.html`:null;default:return null}}function x(z){return Number.isFinite(z)&&z!==0?z:null}function L(...z){for(const K of z){const G=Number(K);if(Number.isFinite(G)&&G!==0)return G}return null}export function mapSuggestRow(z,K){const{lat:G,lon:Q}=pickCoords(z);return{rank:K+1,id:z?.id?String(z.id):null,type:z?.type?String(z.type):null,displayType:z?.displayType?String(z.displayType).trim():null,name:String(z?.displayName||z?.word||z?.cityName||"").replace(/\s+/g," ").trim()||null,eName:z?.eName?String(z.eName).trim():null,cityId:Number.isFinite(z?.cityId)&&z.cityId!==0?z.cityId:null,cityName:z?.cityName?String(z.cityName).trim():null,provinceName:z?.provinceName?String(z.provinceName).trim():null,countryName:z?.countryName?String(z.countryName).trim():null,lat:G,lon:Q,score:L(z?.commentScore,z?.cStar),url:buildUrl(z)}}const _=/^(\d{4})-(\d{2})-(\d{2})$/;export function parseIsoDate(z,K){if(K===void 0||K===null||K==="")throw new Y(`--${z} is required (YYYY-MM-DD)`);const G=String(K).trim(),Q=_.exec(G);if(!Q)throw new Y(`--${z} must be YYYY-MM-DD, got ${JSON.stringify(K)}`);const V=Number(Q[1]),W=Number(Q[2]),B=Number(Q[3]);if(W<1||W>12||B<1||B>31)throw new Y(`--${z} has invalid month/day: ${G}`);const $=new Date(Date.UTC(V,W-1,B));if($.getUTCFullYear()!==V||$.getUTCMonth()!==W-1||$.getUTCDate()!==B)throw new Y(`--${z} is not a real calendar date: ${G}`);return G}export function parseIataCode(z,K){if(K===void 0||K===null||K==="")throw new Y(`--${z} is required (3-letter IATA code, e.g. PEK, SHA)`);const G=String(K).trim().toUpperCase();if(!/^[A-Z]{3}$/.test(G))throw new Y(`--${z} must be a 3-letter IATA code, got ${JSON.stringify(K)}`);return G}export function parseCityId(z){if(z===void 0||z===null||z==="")throw new Y("--city is required (numeric city ID from `ctrip search` or `ctrip hotel-suggest`)");const K=Number(z);if(!Number.isFinite(K)||!Number.isInteger(K)||K<=0)throw new Y(`--city must be a positive integer city ID, got ${JSON.stringify(z)}`);return K}export function pickHotelMapCoords(z){if(!Array.isArray(z)||z.length===0)return{lat:null,lon:null};const K=(Q)=>{const V=Number(Q?.coordinateType);if(V===1)return 0;if(V===2)return 1;if(V===3)return 2;return 3},G=[...z].sort((Q,V)=>K(Q)-K(V));for(const Q of G){const V=Number(Q?.latitude),W=Number(Q?.longitude);if(Number.isFinite(V)&&Number.isFinite(W)&&(V!==0||W!==0))return{lat:V,lon:W}}return{lat:null,lon:null}}export function mapHotelRow(z,K){const G=z?.hotelInfo??{},Q=Array.isArray(z?.roomInfo)?z.roomInfo:[],V=G.summary??{},W=G.nameInfo??{},B=G.hotelStar??{},$=G.commentInfo??{},F=G.positionInfo??{},H=(Q[0]??{}).priceInfo??{},q=V.hotelId?String(V.hotelId):null,{lat:D,lon:O}=pickHotelMapCoords(F.mapCoordinate);let P=null;if($.commenterNumber){const R=String($.commenterNumber).replace(/[^\d]/g,"");if(R)P=Number(R)}const U=$.commentScore?Number($.commentScore):null,b=Number.isFinite(B.star)&&B.star>0?B.star:null,k=Number.isFinite(H.price)&&H.price>0?H.price:null;return{rank:K+1,hotelId:q,name:W.name?String(W.name).trim():null,enName:W.enName?String(W.enName).trim():null,star:b,score:Number.isFinite(U)&&U>0?U:null,scoreLabel:$.commentDescription?String($.commentDescription).trim():null,reviewCount:P,cityName:F.cityName?String(F.cityName).trim():null,district:F.positionDesc?String(F.positionDesc).trim():null,address:F.address?String(F.address).trim():null,lat:D,lon:O,price:k,currency:H.currency?String(H.currency).trim():null,url:q?`https://hotels.ctrip.com/hotels/detail/?hotelid=${q}`:null}}export function buildFlightExtractJs(){return`
       (() => {
         const cleanText = (value) => (value || '').replace(/\\s+/g, ' ').trim();
         const isTime = (s) => /^([01]?\\d|2[0-3]):[0-5]\\d$/.test(s);
@@ -409,28 +77,9 @@ export function buildFlightExtractJs() {
         });
         return rows;
       })()
-    `;
-}
-
-/**
- * Build a scroll-until-enough IIFE for flights/hotels DOM-card pagination.
- *
- * Mirrors `clis/xiaohongshu/search.js#buildScrollUntilJs` (PR #1487) — counts a
- * caller-supplied row selector, scrolls until count >= target / DOM plateau /
- * maxScrolls. Returns final row count so the caller can decide whether to
- * surface an EmptyResultError. (xiaohongshu's helper hardcodes
- * `section.note-item`; this generic version takes a selector.)
- */
-export function buildScrollUntilJs(rowSelector, targetCount, maxScrolls = 8) {
-    if (!Number.isInteger(targetCount) || targetCount < 1 || targetCount > 100) {
-        throw new ArgumentError(`targetCount must be an integer between 1 and 100, got ${JSON.stringify(targetCount)}`);
-    }
-    if (!Number.isInteger(maxScrolls) || maxScrolls < 1 || maxScrolls > 30) {
-        throw new ArgumentError(`maxScrolls must be an integer between 1 and 30, got ${JSON.stringify(maxScrolls)}`);
-    }
-    return `
+    `}export function buildScrollUntilJs(z,K,G=8){if(!Number.isInteger(K)||K<1||K>100)throw new Y(`targetCount must be an integer between 1 and 100, got ${JSON.stringify(K)}`);if(!Number.isInteger(G)||G<1||G>30)throw new Y(`maxScrolls must be an integer between 1 and 30, got ${JSON.stringify(G)}`);return`
       (async () => {
-        const sel = ${JSON.stringify(rowSelector)};
+        const sel = ${JSON.stringify(z)};
         const isVisible = (el) => {
           const style = window.getComputedStyle(el);
           if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity) === 0) return false;
@@ -440,8 +89,8 @@ export function buildScrollUntilJs(rowSelector, targetCount, maxScrolls = 8) {
         const countItems = () => Array.from(document.querySelectorAll(sel)).filter(isVisible).length;
         let lastCount = countItems();
         let plateauRounds = 0;
-        for (let i = 0; i < ${maxScrolls}; i++) {
-          if (countItems() >= ${targetCount}) break;
+        for (let i = 0; i < ${G}; i++) {
+          if (countItems() >= ${K}) break;
           const lastHeight = document.body.scrollHeight;
           window.scrollTo(0, lastHeight);
           await new Promise((resolve) => {
@@ -467,7 +116,4 @@ export function buildScrollUntilJs(rowSelector, targetCount, maxScrolls = 8) {
         }
         return countItems();
       })()
-    `;
-}
-
-export const __test__ = { ENDPOINT, MIN_LIMIT, MAX_LIMIT };
+    `}export const __test__={ENDPOINT:X,MIN_LIMIT:Z,MAX_LIMIT:j};

package/clis/cursor/ask.js

@@ -1,47 +1,12 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, selectorError } from '@jackwener/opencli/errors';
-export const askCommand = cli({
-    site: 'cursor',
-    name: 'ask',
-    access: 'write',
-    description: 'Send a prompt and wait for the AI response (send + wait + read)',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [
-        { name: 'text', required: true, positional: true, help: 'Prompt to send' },
-        { name: 'timeout', type: 'int', required: false, help: 'Max seconds to wait for response (default: 30)', default: 30 },
-    ],
-    columns: ['Role', 'Text'],
-    func: async (page, kwargs) => {
-        const text = kwargs.text;
-        const timeout = kwargs.timeout;
-        if (!Number.isInteger(timeout) || timeout < 1) {
-            throw new ArgumentError('--timeout must be a positive integer (seconds)');
-        }
-        // Count existing messages before sending
-        const beforeCount = await page.evaluate(`
+import{cli as L,Strategy as M}from"@jackwener/opencli/registry";import{ArgumentError as N,selectorError as O}from"@jackwener/opencli/errors";export const askCommand=L({site:"cursor",name:"ask",access:"write",description:"Send a prompt and wait for the AI response (send + wait + read)",domain:"localhost",strategy:M.UI,browser:!0,args:[{name:"text",required:!0,positional:!0,help:"Prompt to send"},{name:"timeout",type:"int",required:!1,help:"Max seconds to wait for response (default: 30)",default:30}],columns:["Role","Text"],func:async(h,D)=>{const{text:z,timeout:q}=D;if(!Number.isInteger(q)||q<1)throw new N("--timeout must be a positive integer (seconds)");const J=await h.evaluate(`
       document.querySelectorAll('[data-message-role]').length
-    `);
-        // Inject text into the active editor and submit
-        const injected = await page.evaluate(`(function(text) {
+    `);if(!await h.evaluate(`(function(text) {
         let editor = document.querySelector('.aislash-editor-input, [data-lexical-editor="true"], [contenteditable="true"]');
         if (!editor) return false;
         editor.focus();
         document.execCommand('insertText', false, text);
         return true;
-      })(${JSON.stringify(text)})`);
-        if (!injected)
-            throw selectorError('Cursor input element');
-        await page.wait(0.5);
-        await page.pressKey('Enter');
-        // Poll until a new assistant message appears or timeout
-        const pollInterval = 2; // seconds
-        const maxPolls = Math.ceil(timeout / pollInterval);
-        let response = '';
-        for (let i = 0; i < maxPolls; i++) {
-            await page.wait(pollInterval);
-            const result = await page.evaluate(`
+      })(${JSON.stringify(z)})`))throw O("Cursor input element");await h.wait(0.5);await h.pressKey("Enter");const F=2,K=Math.ceil(q/F);let B="";for(let G=0;G<K;G++){await h.wait(F);const H=await h.evaluate(`
         (function(prevCount) {
           const msgs = document.querySelectorAll('[data-message-role]');
           if (msgs.length <= prevCount) return null;
@@ -53,22 +18,5 @@ export const askCommand = cli({
           const root = lastMsg.querySelector('.markdown-root');
           const text = root ? root.innerText : lastMsg.innerText;
           return text ? text.trim() : null;
-        })(${beforeCount})
-      `);
-            if (result) {
-                response = result;
-                break;
-            }
-        }
-        if (!response) {
-            return [
-                { Role: 'User', Text: text },
-                { Role: 'System', Text: `No response received within ${timeout}s. The AI may still be generating.` },
-            ];
-        }
-        return [
-            { Role: 'User', Text: text },
-            { Role: 'Assistant', Text: response },
-        ];
-    },
-});
+        })(${J})
+      `);if(H){B=H;break}}if(!B)return[{Role:"User",Text:z},{Role:"System",Text:`No response received within ${q}s. The AI may still be generating.`}];return[{Role:"User",Text:z},{Role:"Assistant",Text:B}]}});

package/clis/cursor/composer.js

@@ -1,21 +1,4 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { selectorError } from '@jackwener/opencli/errors';
-export const composerCommand = cli({
-    site: 'cursor',
-    name: 'composer',
-    access: 'write',
-    description: 'Send a prompt directly into Cursor Composer (Cmd+I shortcut)',
-    domain: 'localhost',
-    strategy: Strategy.UI,
-    browser: true,
-    args: [{ name: 'text', required: true, positional: true, help: 'Text to send into Composer' }],
-    columns: ['Status', 'InjectedText'],
-    func: async (page, kwargs) => {
-        const textToInsert = kwargs.text;
-        // Open/Focus Composer via shortcut — always works regardless of current state
-        await page.pressKey('Meta+I');
-        await page.wait(1);
-        const typed = await page.evaluate(`(function(text) {
+import{cli as A,Strategy as B}from"@jackwener/opencli/registry";import{selectorError as D}from"@jackwener/opencli/errors";export const composerCommand=A({site:"cursor",name:"composer",access:"write",description:"Send a prompt directly into Cursor Composer (Cmd+I shortcut)",domain:"localhost",strategy:B.UI,browser:!0,args:[{name:"text",required:!0,positional:!0,help:"Text to send into Composer"}],columns:["Status","InjectedText"],func:async(b,z)=>{const q=z.text;await b.pressKey("Meta+I");await b.wait(1);if(!await b.evaluate(`(function(text) {
         let composer = document.activeElement;
         if (!composer || !composer.isContentEditable) {
             composer = document.querySelector('.composer-bar [data-lexical-editor="true"], [id*="composer"] [contenteditable="true"], .aislash-editor-input');
@@ -26,18 +9,4 @@ export const composerCommand = cli({
         composer.focus();
         document.execCommand('insertText', false, text);
         return true;
-      })(${JSON.stringify(textToInsert)})`);
-        if (!typed) {
-            throw selectorError('Cursor Composer input element', 'Could not find Cursor Composer input element after pressing Cmd+I.');
-        }
-        await page.wait(0.5);
-        await page.pressKey('Enter');
-        await page.wait(1);
-        return [
-            {
-                Status: 'Success',
-                InjectedText: textToInsert,
-            },
-        ];
-    },
-});
+      })(${JSON.stringify(q)})`))throw D("Cursor Composer input element","Could not find Cursor Composer input element after pressing Cmd+I.");await b.wait(0.5);await b.pressKey("Enter");await b.wait(1);return[{Status:"Success",InjectedText:q}]}});

package/clis/cursor/dump.js

@@ -1,2 +1 @@
-import { makeDumpCommand } from '../_shared/desktop-commands.js';
-export const dumpCommand = makeDumpCommand('cursor');
+import{makeDumpCommand as m}from"../_shared/desktop-commands.js";export const dumpCommand=m("cursor");

package/clis/cursor/export.js

@@ -1,23 +1,6 @@
-import * as fs from 'node:fs';
-import { cli, Strategy } from '@jackwener/opencli/registry';
-function makeExportCommand(site, readSelector) {
-    return cli({
-        site,
-        name: 'export',
-    access: 'read',
-        description: `Export the current ${site} conversation to a Markdown file`,
-        domain: 'localhost',
-        strategy: Strategy.UI,
-        browser: true,
-        args: [
-            { name: 'output', required: false, help: `Output file (default: /tmp/${site}-export.md)` },
-        ],
-        columns: ['Status', 'File', 'Messages'],
-        func: async (page, kwargs) => {
-            const outputPath = kwargs.output || `/tmp/${site}-export.md`;
-            const md = await page.evaluate(`
+import*as a from"node:fs";import{cli as m,Strategy as i}from"@jackwener/opencli/registry";function l(e,n){return m({site:e,name:"export",access:"read",description:`Export the current ${e} conversation to a Markdown file`,domain:"localhost",strategy:i.UI,browser:!0,args:[{name:"output",required:!1,help:`Output file (default: /tmp/${e}-export.md)`}],columns:["Status","File","Messages"],func:async(o,r)=>{const t=r.output||`/tmp/${e}-export.md`,s=await o.evaluate(`
         (function() {
-          const selectors = ${JSON.stringify(readSelector)}.split(',');
+          const selectors = ${JSON.stringify(n)}.split(',');
           let messages = [];
           
           for (const sel of selectors) {
@@ -37,16 +20,4 @@ function makeExportCommand(site, readSelector) {
           
           return messages.map((m, i) => '## Message ' + (i + 1) + '\\n\\n' + m.trim()).join('\\n\\n---\\n\\n');
         })()
-      `);
-            fs.writeFileSync(outputPath, `# ${site} Conversation Export\\n\\n` + md);
-            return [
-                {
-                    Status: 'Success',
-                    File: outputPath,
-                    Messages: md.split('## Message').length - 1,
-                },
-            ];
-        },
-    });
-}
-export const cursorExport = makeExportCommand('cursor', '[data-message-role]');
+      `);a.writeFileSync(t,`# ${e} Conversation Export\\n\\n`+s);return[{Status:"Success",File:t,Messages:s.split("## Message").length-1}]}})}export const cursorExport=l("cursor","[data-message-role]");