@danceiny/gotry 0.0.1-rc.9 → 0.2.0-rc.28

package/dist/capabilities/session/adapters/dida-portal.js

@@ -0,0 +1,274 @@
+/**
+ * Dida 供应商门户站点适配器(2026-09-09 实装;hotel-be portal integration 迁移线:
+ * 员工子账号免知凭据访问供应商 portal——登录经 hotel-be portal 自动填充跳板在
+ * dida 官网由人完成,gotry 只在用户本人 Chrome 登录态里被动嗅探检索回包)。
+ *
+ *   - entry:https://portal.dida.com/hotel/find(SPA,页内交互触发检索;深链参数
+ *     形态未知——D-13 同款边界,首个真会话后校准)
+ *   - networkHints:portal-webapi.dida.com 实时价/价格监控 XHR(接口名取自
+ *     hotel-be supplier/integration/dida/portal 已捕获端点,2026-07 抓包校准);
+ *     URL hint 未命中时由 content-main 的形状嗅探兜底(响应 JSON 含报价签名即
+ *     转发),对接口改名免疫
+ *   - 解析:SearchRealTime 信封(Envelope{Data.HotelPriceList[].RoomTypeList[]
+ *     .RatePlanList[]})逐报价展平;SearchMonitor 响应形状未捕获前不猜测——
+ *     只按 URL 命中转发、解析留给首个真会话校准(D-13)
+ *
+ * 只读:适配器不含任何提交/预订语义;预订面(PriceConfirm 等)URL 属 hotel-be
+ * 适配器边界,gotry 侧不存在对应原语;登录语义红线同全局:gotry 永不读取/存储/
+ * 回传 cookie 值,只读票据 cookie 名(CN_M_DidaTravel)存在性。
+ */
+/** 票据 cookie 名(hotel-be portal 会话同款 HttpOnly cookie;只读名字,永不读值) */
+export const DIDA_LOGIN_COOKIE_NAMES = ['CN_M_DidaTravel'];
+/** page 域(content_scripts 注入面与 background 白名单的对账源) */
+export const DIDA_SITE_HOST = 'portal.dida.com';
+/** cookie 域(chrome.cookies 过滤器与登录票据检查;did a 站点 cookie 挂 .dida.com 域 cookie) */
+export const DIDA_SITE_DOMAIN = 'dida.com';
+/** 默认检索入口(酒店 find 页;SPA 加载后由页面自身代码发起价格检索) */
+export const DIDA_ENTRY_URL = 'https://portal.dida.com/hotel/find';
+/** entry 构造(v1:固定 find 页 + 显式覆盖守白名单域;URL 直开即零 DOM 交互) */
+export function buildDidaEntryUrl(q = {}) {
+    const url = (q.entryUrl ?? '').trim() || DIDA_ENTRY_URL;
+    if (!/^https:\/\/portal\.dida\.com\//.test(url))
+        return { ok: false };
+    return { ok: true, url };
+}
+/** networkHints:portal-webapi.dida.com 实时价/价格监控 XHR(2026-07 抓包口径;
+ * 首个真会话后按现行接口校准——D-13 同款边界) */
+export const DIDA_NETWORK_HINTS = [
+    /portal-webapi\.dida\.com\/HotelPriceAPI\/SearchRealTime/i,
+    /portal-webapi\.dida\.com\/HotelPriceAPI\/SearchMonitor/i,
+    // 2026-09-21 实测:/hotel/list(按城市+日期的搜索结果页)的价格面是 SearchCache,
+    // Data.HotelPriceList[] = 每家酒店 + 该查询下的总价(房间级明细不在此面)。
+    /portal-webapi\.dida\.com\/HotelPriceAPI\/SearchCache/i,
+    // 2026-09-10 UAT 实测校准:find 页加载态自发的是推荐流(非 SearchRealTime——
+    // 那是用户点「预订」后的实时价接口)。推荐酒店 + 推荐价格两个接口成对出现。
+    /portal-webapi\.dida\.com\/HotelRecommendAPI\/SearchHomepageRecommendHotels/i,
+    /portal-webapi\.dida\.com\/HotelRecommendAPI\/SearchHomepageRecommendPrices/i,
+    /portal-webapi\.dida\.com\/PopularDestinationAPI\/SearchHotels/i,
+    /portal-webapi\.dida\.com\/PopularDestinationAPI\/SearchHotelPrices/i,
+];
+/** 形状嗅探签名:URL hint 未命中时的兜底(实时价信封报价签名,对接口改名免疫);
+ * 大小上限由调用方先把关 */
+export function looksLikeDidaRatesBody(body) {
+    if (!body || body.length > 2_000_000)
+        return false;
+    return /"HotelPriceList"|"RatePlanList"/.test(body);
+}
+/**
+ * SearchCache(列表页价格面,2026-09-21 实测) → 报价列表。
+ *
+ * 形态:Data.HotelPriceList[].{Hotel:{HotelID,Name,Name_EN,StarRating,Address,CityName},
+ * TotalPrice, Currency, RatePlanPriceList(列表页为空)}——**每家酒店只给该查询下的总价**,
+ * 房间级明细要详情面(SearchRealTime)。用于「按城市+日期」比价,正好是比价需要的最小信息。
+ *
+ * nights > 1 时按晚均摊出 price(nights 由调用方按查询给出;缺省视为 1 晚)。
+ */
+export function parseDidaSearchCache(body, opts = {}) {
+    let raw;
+    try {
+        raw = JSON.parse(body);
+    }
+    catch {
+        return [];
+    }
+    const list = raw?.Data?.HotelPriceList;
+    if (!Array.isArray(list))
+        return [];
+    const maxItems = opts.maxItems ?? 60;
+    const nights = Math.max(1, Math.floor(opts.nights ?? 1));
+    const out = [];
+    for (const item of list) {
+        if (out.length >= maxItems || item == null || typeof item !== 'object')
+            continue;
+        const row = item;
+        const hotel = (row.Hotel != null && typeof row.Hotel === 'object' ? row.Hotel : {});
+        const hotelId = hotel.HotelID != null ? String(hotel.HotelID) : '';
+        if (!hotelId)
+            continue;
+        const total = typeof row.TotalPrice === 'number' ? row.TotalPrice : 0;
+        const nameCn = typeof hotel.Name === 'string' ? hotel.Name.trim() : '';
+        const nameEn = typeof hotel.Name_EN === 'string' ? hotel.Name_EN.trim() : '';
+        const perNight = total > 0 && nights > 1 ? Math.round(total / nights) : total;
+        const num = (v) => (typeof v === 'number' && Number.isFinite(v) ? v : undefined);
+        const str = (v) => {
+            const t = typeof v === 'string' ? v.trim() : '';
+            return t || undefined;
+        };
+        const images = Array.isArray(hotel.HotelImageList) ? hotel.HotelImageList : [];
+        const firstImage = images.map((i) => str(i?.ImageUrl)).find((u) => Boolean(u));
+        out.push({
+            hotelId,
+            hotelName: nameCn || nameEn || undefined,
+            price: perNight,
+            ...(total > 0 ? { totalPrice: total } : {}),
+            ...(typeof row.Currency === 'string' ? { currency: row.Currency } : {}),
+            ...(nameEn && nameEn !== nameCn ? { hotelNameEn: nameEn } : {}),
+            ...(num(hotel.StarRating) !== undefined ? { starRating: num(hotel.StarRating) } : {}),
+            ...(str(hotel.AddressFull) || str(hotel.Address) ? { address: str(hotel.AddressFull) ?? str(hotel.Address) } : {}),
+            ...(str(hotel.CityName) ? { cityName: str(hotel.CityName) } : {}),
+            ...(str(hotel.CountryCode) ? { countryCode: str(hotel.CountryCode) } : {}),
+            ...(str(hotel.ChainName) ? { chainName: str(hotel.ChainName) } : {}),
+            ...(num(hotel.Latitude) !== undefined ? { latitude: num(hotel.Latitude) } : {}),
+            ...(num(hotel.Longitude) !== undefined ? { longitude: num(hotel.Longitude) } : {}),
+            ...(firstImage ? { imageUrl: firstImage } : {}),
+        });
+    }
+    return out;
+}
+/** 解析推荐酒店列表(Data.Hotels[]:HotelID/Name/Name_CN/Name_EN;Current 页加载态无价) */
+export function parseDidaRecommendHotels(body, opts = {}) {
+    let raw;
+    try {
+        raw = JSON.parse(body);
+    }
+    catch {
+        return [];
+    }
+    const hotels = raw?.Data?.Hotels;
+    if (!Array.isArray(hotels))
+        return [];
+    const out = [];
+    for (const item of hotels.slice(0, opts.maxItems ?? 60)) {
+        if (item == null || typeof item !== 'object')
+            continue;
+        const h = item;
+        const hotelId = h.HotelID != null ? String(h.HotelID) : '';
+        const name = typeof h.Name_CN === 'string' && h.Name_CN.trim() ? h.Name_CN : (typeof h.Name === 'string' ? h.Name : '');
+        if (!hotelId || !name)
+            continue;
+        out.push({ hotelId, name, nameEN: typeof h.Name_EN === 'string' ? h.Name_EN : undefined });
+    }
+    return out;
+}
+// (parser types continue below)
+/** 解析价格列表:兼容 Recommend Prices(HotelId/Date)与 PopularDestination(HotelID/CheckInDate)两种键形 */
+export function parseDidaPrices(body) {
+    let raw;
+    try {
+        raw = JSON.parse(body);
+    }
+    catch {
+        return [];
+    }
+    const prices = raw?.Data?.Prices;
+    if (!Array.isArray(prices))
+        return [];
+    const out = [];
+    for (const item of prices) {
+        if (item == null || typeof item !== 'object')
+            continue;
+        const p = item;
+        const hotelId = p.HotelId != null ? String(p.HotelId) : (p.HotelID != null ? String(p.HotelID) : '');
+        const price = typeof p.Price === 'number' ? p.Price : NaN;
+        if (!hotelId || !Number.isFinite(price) || price <= 0)
+            continue;
+        const dateOf = (v) => (typeof v === 'string' && v.length >= 10 ? v.slice(0, 10) : undefined);
+        out.push({
+            hotelId,
+            price,
+            originalPrice: typeof p.OriginalPrice === 'number' ? p.OriginalPrice : undefined,
+            currency: typeof p.Currency === 'string' ? p.Currency : undefined,
+            priceDate: dateOf(p.Date),
+            checkInDate: dateOf(p.CheckInDate),
+            checkOutDate: dateOf(p.CheckOutDate),
+        });
+    }
+    return out;
+}
+/** 从 RoomTypePrice 展平一条报价候选(RatePlanList 元素为 dida 已知形态);
+ * 酒店字段取 HotelPriceItem.Hotel 嵌套(HotelStatic),容忍旧式扁平形态 */
+function rateCandidate(hotel, room, plan) {
+    if (plan == null || typeof plan !== 'object')
+        return null;
+    const ratePlanId = plan.RatePlanID;
+    const price = plan.Price;
+    const totalPrice = plan.TotalPrice;
+    if (typeof ratePlanId !== 'string' || !ratePlanId.trim())
+        return null;
+    if (typeof price !== 'number' && typeof totalPrice !== 'number')
+        return null;
+    const hotelStatic = (hotel.Hotel != null && typeof hotel.Hotel === 'object' ? hotel.Hotel : hotel);
+    const hotelId = hotelStatic.HotelID;
+    const roomTypeId = room.DidaRoomTypeID;
+    return {
+        hotelId: hotelId != null ? String(hotelId) : undefined,
+        hotelName: typeof hotelStatic.Name === 'string' ? hotelStatic.Name : undefined,
+        roomTypeId: roomTypeId != null ? String(roomTypeId) : undefined,
+        roomName: typeof room.DidaRoomTypeName_CN === 'string' && room.DidaRoomTypeName_CN.trim()
+            ? room.DidaRoomTypeName_CN
+            : (typeof room.DidaRoomTypeName_EN === 'string' ? room.DidaRoomTypeName_EN : undefined),
+        roomNameEn: typeof room.DidaRoomTypeName_EN === 'string' && room.DidaRoomTypeName_EN.trim()
+            ? room.DidaRoomTypeName_EN
+            : undefined,
+        plan,
+    };
+}
+/** 走形:SearchRealTime 信封 → 展平报价列表(纯函数,fixture 测试锚点);
+ * malformed 一律返空,不抛错——页面/接口 JSON 是不可信输入(RFC §3.5) */
+export function parseDidaRates(body, opts = {}) {
+    let raw;
+    try {
+        raw = JSON.parse(body);
+    }
+    catch {
+        return [];
+    }
+    const maxItems = opts.maxItems ?? 40;
+    const out = [];
+    // 定位 HotelPriceList:信封顶层 Data 下;无信封时容忍裸数组形态
+    let hotelList;
+    if (raw != null && typeof raw === 'object' && !Array.isArray(raw)) {
+        const data = raw.Data;
+        if (data != null && typeof data === 'object')
+            hotelList = data.HotelPriceList;
+    }
+    else if (Array.isArray(raw)) {
+        hotelList = raw;
+    }
+    if (!Array.isArray(hotelList))
+        return out;
+    for (const item of hotelList) {
+        if (out.length >= maxItems || item == null || typeof item !== 'object')
+            continue;
+        const hotel = item;
+        // RoomTypeList 与 RoomList 是合并关系(hotel-be converter 两表都吃),不是二选一
+        const rooms = [
+            ...(Array.isArray(hotel.RoomTypeList) ? hotel.RoomTypeList : []),
+            ...(Array.isArray(hotel.RoomList) ? hotel.RoomList : []),
+        ];
+        for (const room of rooms) {
+            if (out.length >= maxItems || room == null || typeof room !== 'object')
+                continue;
+            const plans = room.RatePlanList;
+            if (!Array.isArray(plans))
+                continue;
+            for (const plan of plans) {
+                if (out.length >= maxItems)
+                    return out;
+                const cand = rateCandidate(hotel, room, plan);
+                if (!cand)
+                    continue;
+                const p = cand.plan;
+                out.push({
+                    hotelId: cand.hotelId,
+                    hotelName: cand.hotelName,
+                    roomTypeId: cand.roomTypeId,
+                    roomName: cand.roomName,
+                    roomNameEn: cand.roomNameEn,
+                    ratePlanId: typeof p.RatePlanID === 'string' ? p.RatePlanID : undefined,
+                    price: typeof p.Price === 'number' ? p.Price : 0,
+                    totalPrice: typeof p.TotalPrice === 'number' ? p.TotalPrice : undefined,
+                    currency: typeof p.Currency === 'string' ? p.Currency : undefined,
+                    mealType: typeof p.MealType === 'string' ? p.MealType : undefined,
+                    breakfastType: typeof p.BreakfastType === 'string' ? p.BreakfastType : undefined,
+                    bedType: typeof p.BedType === 'string' ? p.BedType : undefined,
+                    paymentType: typeof p.PaymentType === 'string' ? p.PaymentType : undefined,
+                    inventory: typeof p.Inventory === 'number' ? p.Inventory : (typeof p.RoomCount === 'number' ? p.RoomCount : undefined),
+                    referenceNo: typeof p.ReferenceNo === 'string' ? p.ReferenceNo : undefined,
+                    jumpUrl: cand.hotelId ? `https://portal.dida.com/hotel/find` : undefined,
+                });
+            }
+        }
+    }
+    return out;
+}

package/dist/capabilities/session/adapters/meituan-local.js

@@ -1,73 +1,54 @@
+/**
+ * 美团本地适配器骨架(民宿/门票——官方通道盲区,RFC §3.1)。
+ *
+ * 实测边界(2026-08-28 tick):匿名实例 hotel.meituan.com 直接 403——三站中最强反爬,
+ * **登录态是硬前置**(founder 纠偏「不能匿名实例」在美团侧是 403 级事实,非策略偏好)。
+ * 本骨架:entry 城市拼音表 + 登录票据名单 + networkHint 占位;live 接口形状待用户登录态
+ * (profile 内用户自登美团)后由心跳轮实测回填——在此之前 parse 返回空、verdict=miss。
+ */
+/** 城市拼音表(美团 URL 路径段;与 ctrip-flight 城市码表同界:词表外 unresolved 不猜) */
 const CITY_SLUGS = {
-    上海: 'shanghai',
-    北京: 'beijing',
-    广州: 'guangzhou',
-    深圳: 'shenzhen',
-    成都: 'chengdu',
-    昆明: 'kunming',
-    大理: 'dali',
-    丽江: 'lijiang',
-    西安: 'xian',
-    杭州: 'hangzhou',
-    三亚: 'sanya',
-    厦门: 'xiamen',
-    重庆: 'chongqing',
-    青岛: 'qingdao',
-    长沙: 'changsha',
-    武汉: 'wuhan',
-    南京: 'nanjing',
-    郑州: 'zhengzhou',
-    贵阳: 'guiyang',
-    桂林: 'guilin'
+    上海: 'shanghai', 北京: 'beijing', 广州: 'guangzhou', 深圳: 'shenzhen', 成都: 'chengdu',
+    昆明: 'kunming', 大理: 'dali', 丽江: 'lijiang', 西安: 'xian', 杭州: 'hangzhou',
+    三亚: 'sanya', 厦门: 'xiamen', 重庆: 'chongqing', 青岛: 'qingdao', 长沙: 'changsha',
+    武汉: 'wuhan', 南京: 'nanjing', 郑州: 'zhengzhou', 贵阳: 'guiyang', 桂林: 'guilin',
 };
 export const SITE_DOMAIN = 'meituan.com';
-export const LOGIN_COOKIE_NAMES = [
-    'lt',
-    'u',
-    'token',
-    'n'
-];
+/** 登录票据 cookie 名单(公开常识:lt=login ticket/u=uid/token;登录后校准,同 ctrip 侧做法) */
+export const LOGIN_COOKIE_NAMES = ['lt', 'u', 'token', 'n'];
 export function buildMeituanEntry(city, vertical, keyword) {
     const slug = CITY_SLUGS[city];
-    if (!slug) return {
-        ok: false,
-        unresolved: [
-            city
-        ]
-    };
+    if (!slug)
+        return { ok: false, unresolved: [city] };
     const base = vertical === 'hotel' ? `https://hotel.meituan.com/${slug}/` : `https://minsu.meituan.com/${slug}/`;
-    return {
-        ok: true,
-        url: keyword ? base + `?q=${encodeURIComponent(keyword)}` : base
-    };
+    return { ok: true, url: keyword ? base + `?q=${encodeURIComponent(keyword)}` : base };
 }
+/** networkHint 占位:登录态实测后回填真实搜索接口 pattern(当前为空=嗅探层不命中,a11y 兜底接管) */
 export const NETWORK_HINTS = [];
+/** XHR JSON 解析占位:接口形状实测回填前恒返空(调用方走 a11y 兜底) */
 export function parseMeituanSearch(_body) {
     void _body;
     return [];
 }
+/**
+ * a11y 兜底:从快照条目抽「名称+价格」候选(纯函数;供 extract.ts 条目流消费)。
+ * 形状规则:名称=非空 heading/listitem/link;价格=条目名内 ¥\d+(宽松元级);不做语义猜测。
+ */
 export function extractListings(entries, opts = {}) {
     const out = [];
-    const roles = new Set([
-        'heading',
-        'listitem',
-        'link',
-        'article'
-    ]);
-    for (const e of entries){
-        if (out.length >= (opts.max ?? 30)) break;
-        if (!roles.has(e.role) || !e.name) continue;
+    const roles = new Set(['heading', 'listitem', 'link', 'article']);
+    for (const e of entries) {
+        if (out.length >= (opts.max ?? 30))
+            break;
+        if (!roles.has(e.role) || !e.name)
+            continue;
         const pm = /¥\s*(\d+)/.exec(e.name);
-        if (!pm) continue;
+        if (!pm)
+            continue;
         const name = e.name.replace(/¥\s*\d+.*$/, '').trim().slice(0, 80);
-        if (!name) continue;
-        out.push({
-            name,
-            price: Number(pm[1])
-        });
+        if (!name)
+            continue;
+        out.push({ name, price: Number(pm[1]) });
     }
     return out;
 }
-
-
-//# sourceURL=/Users/bytedance/work/gotry/ts/capabilities/session/adapters/meituan-local.ts