@danceiny/gotry 0.0.1-rc.15 → 0.0.1-rc.17

package/dist/src/bookable-facts.js

@@ -0,0 +1,349 @@
+import { createHash } from 'node:crypto';
+export const BOOKABLE_FACT_SCHEMA = 'gotry_bookable_fact.v1';
+function sha16(text) {
+    return createHash('sha256').update(text).digest('hex').slice(0, 16);
+}
+export function makeQueryId(source, kind, origin, destination, date) {
+    return `${source}:${kind}:${origin}-${destination}:${date}`;
+}
+export function makeFactId(parts) {
+    return sha16(parts.map((p)=>p ?? '').join('|'));
+}
+function iataOf(alias, city) {
+    return alias?.[city] ?? city;
+}
+const YMD = /^\d{4}-\d{2}-\d{2}$/;
+function hmOf(dateTime) {
+    const m = dateTime?.match(/T?(\d{2}:\d{2})/);
+    return m?.[1];
+}
+function dateOf(dateTime, fallback) {
+    const m = dateTime?.match(/^(\d{4}-\d{2}-\d{2})/);
+    return m?.[1] ?? fallback;
+}
+export function negativeFact(queryId, kind, origin, destination, date, source, fetchedAt, alias) {
+    return {
+        schema: BOOKABLE_FACT_SCHEMA,
+        fact_id: makeFactId([
+            'neg',
+            kind,
+            iataOf(alias, origin),
+            iataOf(alias, destination),
+            date,
+            queryId
+        ]),
+        kind,
+        route: {
+            origin: iataOf(alias, origin),
+            destination: iataOf(alias, destination)
+        },
+        date,
+        flight_no: '',
+        tier: 'live_inventory',
+        bookability: 'unavailable_exact_date',
+        source,
+        query_id: queryId,
+        fetched_at: fetchedAt,
+        as_of: fetchedAt.slice(0, 10)
+    };
+}
+export function factsFromFlyai(q, r, fetchedAt, alias) {
+    const source = 'flyai';
+    const queryId = makeQueryId(source, q.kind, q.origin, q.destination, q.date);
+    const origin = iataOf(alias, q.origin);
+    const destination = iataOf(alias, q.destination);
+    if (r.verdict === 'error') return [];
+    if (r.verdict === 'miss') return [
+        negativeFact(queryId, q.kind, q.origin, q.destination, q.date, source, fetchedAt, alias)
+    ];
+    const facts = [];
+    for (const o of r.options ?? []){
+        if (!o.no || !o.depDateTime) continue;
+        const numeric = typeof o.price === 'number' && Number.isFinite(o.price) && o.price > 0 ? o.price : undefined;
+        facts.push({
+            schema: BOOKABLE_FACT_SCHEMA,
+            fact_id: makeFactId([
+                q.kind,
+                origin,
+                destination,
+                q.date,
+                o.no,
+                queryId
+            ]),
+            kind: q.kind,
+            route: {
+                origin,
+                destination,
+                origin_airport: o.depStation,
+                dest_airport: o.arrStation
+            },
+            date: dateOf(o.depDateTime, q.date),
+            flight_no: o.no,
+            marketing_carrier: o.name || undefined,
+            operating_carrier: undefined,
+            dep_local: hmOf(o.depDateTime),
+            arr_local: hmOf(o.arrDateTime),
+            nonstop: o.nonstop !== false,
+            price: numeric,
+            currency: numeric !== undefined ? 'CNY' : undefined,
+            tier: 'live_inventory',
+            bookability: 'bookable_exact_date',
+            source,
+            query_id: queryId,
+            fetched_at: fetchedAt,
+            as_of: fetchedAt.slice(0, 10)
+        });
+    }
+    return facts.length > 0 ? facts : [
+        negativeFact(queryId, q.kind, q.origin, q.destination, q.date, source, fetchedAt, alias)
+    ];
+}
+export function factsFromSession(q, r, fetchedAt, alias) {
+    const source = 'session:ctrip-flight';
+    const queryId = makeQueryId(source, 'flight', q.origin, q.destination, q.date);
+    const origin = iataOf(alias, q.origin);
+    const destination = iataOf(alias, q.destination);
+    if (r.verdict !== 'hit') {
+        return r.verdict === 'miss' ? [
+            negativeFact(queryId, 'flight', q.origin, q.destination, q.date, source, fetchedAt, alias)
+        ] : [];
+    }
+    const facts = [];
+    for (const o of r.options ?? []){
+        if (!o.flightNo || !o.depDateTime) continue;
+        const numeric = typeof o.price === 'number' && Number.isFinite(o.price) && o.price > 0 ? o.price : undefined;
+        facts.push({
+            schema: BOOKABLE_FACT_SCHEMA,
+            fact_id: makeFactId([
+                'flight',
+                origin,
+                destination,
+                q.date,
+                o.flightNo,
+                queryId
+            ]),
+            kind: 'flight',
+            route: {
+                origin,
+                destination,
+                origin_airport: o.depAirport,
+                dest_airport: o.arrAirport
+            },
+            date: dateOf(o.depDateTime, q.date),
+            flight_no: o.flightNo,
+            marketing_carrier: o.airline || undefined,
+            operating_carrier: undefined,
+            dep_local: hmOf(o.depDateTime),
+            arr_local: hmOf(o.arrDateTime),
+            nonstop: true,
+            price: numeric,
+            currency: numeric !== undefined ? 'CNY' : undefined,
+            tier: 'live_inventory',
+            bookability: 'bookable_exact_date',
+            source,
+            query_id: queryId,
+            fetched_at: fetchedAt,
+            as_of: fetchedAt.slice(0, 10)
+        });
+    }
+    return facts;
+}
+export function dedupeFacts(facts) {
+    const byId = new Map();
+    for (const f of facts){
+        const prev = byId.get(f.fact_id);
+        if (!prev || prev.fetched_at <= f.fetched_at) byId.set(f.fact_id, f);
+    }
+    return [
+        ...byId.values()
+    ].sort((a, b)=>a.fetched_at.localeCompare(b.fetched_at) || a.fact_id.localeCompare(b.fact_id));
+}
+export function latestFactsForRouteDate(facts, origin, destination, date) {
+    const hits = facts.filter((f)=>f.kind !== 'policy' && f.route.origin === origin && f.route.destination === destination && f.date === date);
+    const latestQueryTs = new Map();
+    for (const f of hits){
+        const prev = latestQueryTs.get(f.query_id);
+        if (!prev || prev < f.fetched_at) latestQueryTs.set(f.query_id, f.fetched_at);
+    }
+    const latestTs = [
+        ...latestQueryTs.values()
+    ].sort().pop();
+    if (!latestTs) return [];
+    return hits.filter((f)=>f.fetched_at === latestTs);
+}
+export function flightClaimVerdict(facts, claim) {
+    const no = claim.flight_no.toUpperCase().replace(/\s+/g, '');
+    const sameNo = facts.filter((f)=>f.kind !== 'policy' && f.flight_no.toUpperCase() === no && f.bookability === 'bookable_exact_date');
+    const routeMatched = sameNo.filter((f)=>(!claim.origin || f.route.origin === claim.origin || f.route.origin_airport === claim.origin) && (!claim.destination || f.route.destination === claim.destination || f.route.dest_airport === claim.destination) && (!claim.date || f.date === claim.date));
+    if (routeMatched.length > 0) return {
+        verdict: 'traceable',
+        fact: routeMatched[0],
+        reason: `回溯 ${routeMatched[0].query_id}`
+    };
+    if (claim.origin && claim.destination && claim.date) {
+        const scoped = latestFactsForRouteDate(facts, claim.origin, claim.destination, claim.date);
+        if (scoped.length > 0) {
+            return {
+                verdict: 'not_in_source',
+                reason: scoped.some((f)=>f.bookability === 'unavailable_exact_date') ? `${claim.origin}→${claim.destination} ${claim.date} exact-date 源返回 0 条(${scoped[0].query_id})——不得用历史班期/相邻日期填充` : `${claim.origin}→${claim.destination} ${claim.date} exact-date 源在架 ${scoped.filter((f)=>f.bookability === 'bookable_exact_date').map((f)=>f.flight_no).join('/')}——无 ${no}`
+            };
+        }
+        return {
+            verdict: 'route_unqueried',
+            reason: `${claim.origin}→${claim.destination} ${claim.date} 从未经 exact-date 源核验`
+        };
+    }
+    return {
+        verdict: 'route_unqueried',
+        reason: `航班 ${no} 无可回溯的 exact-date 事实(缺 route/date 上下文)`
+    };
+}
+function hmToMin(hm) {
+    const [h, m] = hm.split(':').map(Number);
+    return (h ?? 0) * 60 + (m ?? 0);
+}
+function minToHm(min) {
+    return `${String(Math.floor(min / 60)).padStart(2, '0')}:${String(min % 60).padStart(2, '0')}`;
+}
+export function checkSameDayDeparture(facts, q, c) {
+    const earliest = hmToMin(c.errand_end_local) + c.airport_transit_min + c.checkin_deadline_min;
+    const scoped = latestFactsForRouteDate(facts, q.origin, q.destination, q.date);
+    const nonstopBookable = scoped.filter((f)=>f.bookability === 'bookable_exact_date' && f.nonstop !== false);
+    const feasible = [];
+    const excluded = [];
+    for (const f of nonstopBookable){
+        const dep = f.dep_local ? hmToMin(f.dep_local) : null;
+        if (dep === null) {
+            excluded.push({
+                flight_no: f.flight_no,
+                reason: '缺起飞时刻,不参与衔接判定'
+            });
+        } else if (dep >= earliest) {
+            feasible.push(f);
+        } else {
+            excluded.push({
+                flight_no: f.flight_no,
+                reason: `${f.dep_local} 起飞早于最早可接时刻 ${minToHm(earliest)}(${c.errand_end_local} 结束事务 + ${c.airport_transit_min}m 到机场 + ${c.checkin_deadline_min}m 值机)`
+            });
+        }
+    }
+    const ok = feasible.length > 0;
+    const suggestions = [];
+    if (!ok) {
+        const inStock = nonstopBookable.map((f)=>`${f.flight_no} ${f.dep_local ?? '?'}`).join('、');
+        suggestions.push(`增加 1 个${q.origin}住宿夜:改乘次日早班${inStock ? `(当日在架:${inStock})` : ''}`);
+        suggestions.push('或提前一天完成地面事务/提前一天出发,把同日衔接改为隔夜衔接');
+    }
+    return {
+        feasible: ok,
+        earliest_departure_local: minToHm(earliest),
+        feasible_flights: feasible,
+        excluded,
+        suggestions
+    };
+}
+function daysBetween(a, b) {
+    return Math.round((Date.parse(`${b}T00:00:00Z`) - Date.parse(`${a}T00:00:00Z`)) / 86_400_000);
+}
+export function itineraryInvariants(it) {
+    const violations = [];
+    const totalNights = daysBetween(it.trip_start, it.trip_end);
+    let hotelNights = 0;
+    for (const s of it.stays){
+        const n = daysBetween(s.check_in, s.check_out);
+        if (n <= 0) violations.push({
+            kind: 'date_order',
+            detail: `${s.place} 住宿 ${s.check_in}→${s.check_out} 晚数 ≤0`
+        });
+        else hotelNights += n;
+    }
+    if (hotelNights + it.onboard_nights !== totalNights) {
+        violations.push({
+            kind: 'nights_inconsistent',
+            detail: `酒店夜 ${hotelNights} + 机上夜 ${it.onboard_nights} = ${hotelNights + it.onboard_nights} ≠ 行程总夜数 ${totalNights}(${it.trip_start}→${it.trip_end})——夜数口径必须由结构化住宿反算,不许自然语言估算`
+        });
+    }
+    for (const seg of it.od_segments){
+        if (seg.mode === 'flight' && seg.legs < 1) {
+            violations.push({
+                kind: 'legs_inconsistent',
+                detail: `${seg.from}→${seg.to}(${seg.date})flight O&D 段 legs=${seg.legs}——每段至少 1 leg`
+            });
+        }
+        if (seg.date < it.trip_start || seg.date > it.trip_end) {
+            violations.push({
+                kind: 'date_order',
+                detail: `${seg.from}→${seg.to} 日期 ${seg.date} 落在行程窗 ${it.trip_start}→${it.trip_end} 之外`
+            });
+        }
+    }
+    const minSum = it.budget_items.reduce((acc, b)=>acc + b.min_cny, 0);
+    if (it.claimed_floor_cny !== undefined && it.claimed_floor_cny < minSum) {
+        violations.push({
+            kind: 'budget_floor_inconsistent',
+            detail: `预算分项最低合计 ¥${minSum.toLocaleString()} > 产物声称可压到 ¥${it.claimed_floor_cny.toLocaleString()}——下限话术不得低于分项最低合计`
+        });
+    }
+    return violations;
+}
+export function detectBacktrack(stops, nonstopEdges) {
+    const findings = [];
+    for(let i = 0; i + 2 < stops.length; i++){
+        const a = stops[i], b = stops[i + 1], c = stops[i + 2];
+        if (a !== c) continue;
+        const d = stops[i + 3];
+        const suggestion = d && nonstopEdges.has(`${b}-${d}`) ? `${b}→${d} 有直飞:改为 ${a}→${b} 后直接 ${b}→${d},消除 ${a}→${b}→${a} 回头路` : undefined;
+        findings.push({
+            kind: 'backtrack',
+            path: [
+                a,
+                b,
+                c
+            ],
+            suggestion
+        });
+    }
+    return findings;
+}
+export function defaultReviewBy(tripDate) {
+    const d = new Date(Date.parse(`${tripDate}T00:00:00Z`) - 30 * 86_400_000);
+    return d.toISOString().slice(0, 10);
+}
+export function renderFlightFact(f) {
+    const route = `${f.route.origin}→${f.route.destination}`;
+    const evidence = `[${f.source}@${f.fetched_at} #${f.query_id}]`;
+    if (f.bookability === 'unavailable_exact_date') {
+        const review = f.review_by ?? defaultReviewBy(f.date);
+        return `- ${route} ${f.date}:**未确认/当前不可售**——exact-date 源 ${f.source} 于 ${f.fetched_at.slice(0, 10)} 返回 0 条;到 ${review} 复核,不得用历史班期/相邻日期填充 ${evidence}`;
+    }
+    if (f.bookability !== 'bookable_exact_date') {
+        return `- ${route} ${f.date} ${f.flight_no || ''}:**未核验**(${f.bookability})——仅作参考,不得作为可下单方案呈现 ${evidence}`;
+    }
+    const carrier = f.operating_carrier && f.operating_carrier !== f.marketing_carrier ? `营销 ${f.marketing_carrier ?? '?'} / 实际承运 ${f.operating_carrier}` : f.marketing_carrier ?? '';
+    const times = f.dep_local && f.arr_local ? ` ${f.dep_local}→${f.arr_local}` : '';
+    const nonstop = f.nonstop === false ? '(中转)' : ' 直飞';
+    const airportNote = f.route.dest_airport && f.route.dest_airport !== f.route.destination ? `(落 ${f.route.dest_airport})` : '';
+    const price = f.price !== undefined ? ` ¥${f.price}` : ' 价待询';
+    const baggage = f.baggage_included === false ? ',不含托运行李' : '';
+    return `- ${route} ${f.date} ${f.flight_no}${carrier ? `(${carrier})` : ''}${times}${nonstop}${airportNote}${price}${baggage} ${evidence}`;
+}
+export function renderConnection(legA, legB) {
+    const through = legA.protected_connection === true && legB.protected_connection === true;
+    const head = `${legA.route.origin}→${legA.route.destination} ${legA.flight_no} + ${legB.route.origin}→${legB.route.destination} ${legB.flight_no}`;
+    return through ? `- ${head}:联程(同一票号/行李直挂/误机保护)` : `- ${head}:⚠️ **分票/自助转机**——两段接得上 ≠ 联程;无同一票号、行李需自取重挂、误机无保护,缓冲与风险自担`;
+}
+export function renderPolicyFact(p, tripStart) {
+    const review = p.review_by ?? (tripStart ? defaultReviewBy(tripStart) : undefined);
+    const reviewNote = review ? `;远期政策须复核——到 ${review} 再核验一次` : '';
+    return `- ${p.subject}:截至 ${p.as_of} 的现行政策——${p.statement}${reviewNote} [${p.source}@${p.fetched_at} #${p.query_id}]`;
+}
+export function renderNightsLine(it) {
+    const totalNights = daysBetween(it.trip_start, it.trip_end);
+    const hotelNights = it.stays.reduce((acc, s)=>acc + Math.max(0, daysBetween(s.check_in, s.check_out)), 0);
+    const flightOd = it.od_segments.filter((s)=>s.mode === 'flight').length;
+    const flightLegs = it.od_segments.filter((s)=>s.mode === 'flight').reduce((acc, s)=>acc + s.legs, 0);
+    return `共 ${daysBetween(it.trip_start, it.trip_end) + 1} 天 ${totalNights} 晚 = ${hotelNights} 个酒店夜 + ${it.onboard_nights} 个机上夜;航班按 O&D ${flightOd} 段(共 ${flightLegs} 个 flight legs)`;
+}
+
+
+//# sourceURL=ts/src/bookable-facts.ts

package/dist/src/booking-saga.js

@@ -150,4 +150,4 @@ export function sagaLegalPaths() {
 }
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/src/booking-saga.ts
+//# sourceURL=ts/src/booking-saga.ts