Files
wehub-resource-sync 9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:39:48 +08:00

357 lines
16 KiB
JavaScript

import { describe, expect, it } from 'vitest';
import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
import { getRegistry } from '@jackwener/opencli/registry';
import './search.js';
import { __test__ } from './search.js';
const {
normalizePositiveInt,
normalizeNonNegativeInt,
normalizeDate,
normalizeCurrency,
normalizeLang,
hasPositiveResultCount,
buildSearchUrl,
} = __test__;
describe('booking helpers — normalizePositiveInt (no silent clamp)', () => {
it('returns default when value is undefined/null/empty', () => {
expect(normalizePositiveInt(undefined, 2, 'adults', 30)).toBe(2);
expect(normalizePositiveInt(null, 2, 'adults', 30)).toBe(2);
});
it('accepts integers in range', () => {
expect(normalizePositiveInt(1, 2, 'adults', 30)).toBe(1);
expect(normalizePositiveInt(30, 2, 'adults', 30)).toBe(30);
});
it('rejects zero / negative / out-of-range / non-integer (no silent clamp)', () => {
expect(() => normalizePositiveInt(0, 2, 'adults', 30)).toThrow(ArgumentError);
expect(() => normalizePositiveInt(-1, 2, 'adults', 30)).toThrow(ArgumentError);
expect(() => normalizePositiveInt(31, 2, 'adults', 30)).toThrow(ArgumentError);
expect(() => normalizePositiveInt(1.5, 2, 'adults', 30)).toThrow(ArgumentError);
expect(() => normalizePositiveInt('abc', 2, 'adults', 30)).toThrow(ArgumentError);
});
});
describe('booking helpers — normalizeNonNegativeInt', () => {
it('accepts zero', () => {
expect(normalizeNonNegativeInt(0, 0, 'children', 10)).toBe(0);
});
it('rejects negative / out-of-range (no silent clamp)', () => {
expect(() => normalizeNonNegativeInt(-1, 0, 'children', 10)).toThrow(ArgumentError);
expect(() => normalizeNonNegativeInt(11, 0, 'children', 10)).toThrow(ArgumentError);
});
});
describe('booking helpers — normalizeDate', () => {
it('accepts YYYY-MM-DD', () => {
expect(normalizeDate('2026-06-15', 'checkin')).toBe('2026-06-15');
});
it('rejects bad format / nonsense dates with ArgumentError', () => {
expect(() => normalizeDate('', 'checkin')).toThrow(ArgumentError);
expect(() => normalizeDate('06/15/2026', 'checkin')).toThrow(ArgumentError);
expect(() => normalizeDate('2026-13-40', 'checkin')).toThrow(ArgumentError);
expect(() => normalizeDate('2026-02-31', 'checkin')).toThrow(ArgumentError);
});
});
describe('booking helpers — normalizeCurrency', () => {
it('passes 3-letter codes uppercased', () => {
expect(normalizeCurrency('usd')).toBe('USD');
expect(normalizeCurrency('JPY')).toBe('JPY');
});
it('returns empty for unset', () => {
expect(normalizeCurrency(undefined)).toBe('');
expect(normalizeCurrency('')).toBe('');
});
it('rejects non-3-letter codes', () => {
expect(() => normalizeCurrency('US')).toThrow(ArgumentError);
expect(() => normalizeCurrency('US$')).toThrow(ArgumentError);
expect(() => normalizeCurrency('USDX')).toThrow(ArgumentError);
});
});
describe('booking helpers — normalizeLang whitelist', () => {
it('lowercases supported langs', () => {
expect(normalizeLang('EN-US')).toBe('en-us');
expect(normalizeLang('zh-cn')).toBe('zh-cn');
});
it('rejects unknown langs', () => {
expect(() => normalizeLang('xx-yy')).toThrow(ArgumentError);
expect(() => normalizeLang('en')).toThrow(ArgumentError);
});
});
describe('booking helpers — buildSearchUrl', () => {
it('constructs canonical search URL with required params', () => {
const url = buildSearchUrl({
destination: 'Tokyo',
checkin: '2026-06-15',
checkout: '2026-06-17',
adults: 2,
rooms: 1,
children: 0,
offset: 0,
currency: 'USD',
lang: 'en-us',
});
expect(url).toContain('https://www.booking.com/searchresults.en-us.html');
expect(url).toContain('ss=Tokyo');
expect(url).toContain('checkin=2026-06-15');
expect(url).toContain('checkout=2026-06-17');
expect(url).toContain('group_adults=2');
expect(url).toContain('no_rooms=1');
expect(url).toContain('group_children=0');
expect(url).toContain('selected_currency=USD');
expect(url).not.toContain('offset=');
});
it('omits lang file segment when lang is empty', () => {
const url = buildSearchUrl({
destination: 'Paris', checkin: '2026-06-15', checkout: '2026-06-17',
adults: 2, rooms: 1, children: 0, offset: 0, currency: '', lang: '',
});
expect(url).toMatch(/booking\.com\/searchresults\.html\?/);
});
it('emits offset only when > 0', () => {
const url = buildSearchUrl({
destination: 'Paris', checkin: '2026-06-15', checkout: '2026-06-17',
adults: 2, rooms: 1, children: 0, offset: 25, currency: '', lang: '',
});
expect(url).toContain('offset=25');
});
});
describe('booking helpers — hasPositiveResultCount', () => {
it('detects positive Booking result-count evidence', () => {
expect(hasPositiveResultCount('Tokyo: 1,234 properties found')).toBe(true);
expect(hasPositiveResultCount('1 stay found')).toBe(true);
});
it('does not treat no-results text as positive evidence', () => {
expect(hasPositiveResultCount('No properties found')).toBe(false);
expect(hasPositiveResultCount('0 properties found')).toBe(false);
});
});
describe('booking adapter registry shape', () => {
it('search is registered as read with id-shaped column for round-trip', () => {
const search = getRegistry().get('booking/search');
expect(search).toBeDefined();
expect(search.access).toBe('read');
expect(search.browser).toBe(true);
// slug + country together form the round-trip identity (URL: /hotel/<country>/<slug>.html)
expect(search.columns).toContain('slug');
expect(search.columns).toContain('country');
expect(search.columns).toContain('url');
});
it('search columns stay <= 12 to honor agent-native row shape', () => {
const search = getRegistry().get('booking/search');
expect(search.columns.length).toBeLessThanOrEqual(12);
});
});
describe('booking search — typed errors (no silent fallback)', () => {
const fakePage = { goto: () => { throw new Error('should not navigate'); } };
it('rejects empty destination with ArgumentError', async () => {
const search = getRegistry().get('booking/search');
await expect(search.func(fakePage, { destination: ' ', checkin: '2026-06-15', checkout: '2026-06-17' })).rejects.toThrow(ArgumentError);
});
it('rejects missing checkin/checkout with ArgumentError', async () => {
const search = getRegistry().get('booking/search');
await expect(search.func(fakePage, { destination: 'Tokyo' })).rejects.toThrow(ArgumentError);
await expect(search.func(fakePage, { destination: 'Tokyo', checkin: '2026-06-15' })).rejects.toThrow(ArgumentError);
});
it('rejects checkout <= checkin with ArgumentError', async () => {
const search = getRegistry().get('booking/search');
await expect(search.func(fakePage, { destination: 'Tokyo', checkin: '2026-06-17', checkout: '2026-06-15' })).rejects.toThrow(ArgumentError);
await expect(search.func(fakePage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-15' })).rejects.toThrow(ArgumentError);
});
it('rejects out-of-range --limit with ArgumentError (no silent clamp to 100)', async () => {
const search = getRegistry().get('booking/search');
await expect(search.func(fakePage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17', limit: 999 })).rejects.toThrow(ArgumentError);
});
it('rejects negative --offset with ArgumentError', async () => {
const search = getRegistry().get('booking/search');
await expect(search.func(fakePage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17', offset: -1 })).rejects.toThrow(ArgumentError);
});
it('rejects unsupported --lang with ArgumentError', async () => {
const search = getRegistry().get('booking/search');
await expect(search.func(fakePage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17', lang: 'xx-yy' })).rejects.toThrow(ArgumentError);
});
it('rejects malformed --currency with ArgumentError', async () => {
const search = getRegistry().get('booking/search');
await expect(search.func(fakePage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17', currency: 'US$' })).rejects.toThrow(ArgumentError);
});
it('wraps browser navigation failures as CommandExecutionError', async () => {
const search = getRegistry().get('booking/search');
const downPage = { goto: () => Promise.reject(new Error('browser down')) };
await expect(search.func(downPage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17' })).rejects.toThrow(CommandExecutionError);
});
it('throws EmptyResultError when extractor returns no cards', async () => {
const search = getRegistry().get('booking/search');
const emptyPage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({ ok: true, items: [], blocked: false, totalText: 'No properties found' }),
};
await expect(search.func(emptyPage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17' })).rejects.toThrow(EmptyResultError);
});
it('throws CommandExecutionError when result-count evidence exists but no cards were parsed', async () => {
const search = getRegistry().get('booking/search');
const driftPage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({ ok: true, items: [], blocked: false, totalText: 'Tokyo: 1,234 properties found' }),
};
await expect(search.func(driftPage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17' })).rejects.toThrow(CommandExecutionError);
});
it('throws CommandExecutionError when captcha is detected', async () => {
const search = getRegistry().get('booking/search');
const blockedPage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({ ok: true, items: [], blocked: true, totalText: 'Verify you are human' }),
};
await expect(search.func(blockedPage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17' })).rejects.toThrow(CommandExecutionError);
});
it('throws CommandExecutionError when extractor payload is malformed instead of treating it as empty', async () => {
const search = getRegistry().get('booking/search');
const malformedPage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({ ok: true, blocked: false, totalText: 'Tokyo hotels' }),
};
await expect(search.func(malformedPage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17' })).rejects.toThrow(CommandExecutionError);
});
it('throws CommandExecutionError when rendered cards lack stable hotel URL identity', async () => {
const search = getRegistry().get('booking/search');
const driftPage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({
ok: true,
blocked: false,
totalText: 'Tokyo hotels',
items: [{
name: 'Unlinked Hotel',
country: '',
slug: '',
url: '',
distance: '',
review_score: null,
review_count: null,
star_rating: null,
price_currency: '',
price_amount: null,
recommended_room: '',
}],
}),
};
await expect(search.func(driftPage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17' })).rejects.toThrow(CommandExecutionError);
});
it('unwraps {session, data} envelope from CDP bridge before validating', async () => {
const search = getRegistry().get('booking/search');
const envelopePage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({
session: 1,
data: {
ok: true,
blocked: false,
totalText: '',
items: [{
name: 'Test Hotel',
country: 'jp',
slug: 'test-hotel',
url: 'https://www.booking.com/hotel/jp/test-hotel.html',
distance: '1 km from centre',
review_score: 8.6,
review_count: 100,
star_rating: 4,
price_currency: 'USD',
price_amount: 120,
recommended_room: 'Standard double',
}],
},
}),
};
const rows = await search.func(envelopePage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17' });
expect(rows).toHaveLength(1);
expect(rows[0].rank).toBe(1);
expect(rows[0].slug).toBe('test-hotel');
expect(rows[0].url).toBe('https://www.booking.com/hotel/jp/test-hotel.html');
});
it('uses requested selected_currency as the output source when price is present', async () => {
const search = getRegistry().get('booking/search');
const currencyPage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({
ok: true,
blocked: false,
totalText: '',
items: [{
name: 'Currency Hotel',
country: 'cn',
slug: 'currency-hotel',
url: 'https://www.booking.com/hotel/cn/currency-hotel.html',
distance: '',
review_score: null,
review_count: null,
star_rating: null,
price_currency: 'JPY',
price_amount: 880,
recommended_room: '',
}],
}),
};
const rows = await search.func(currencyPage, { destination: 'Shanghai', checkin: '2026-06-15', checkout: '2026-06-17', currency: 'CNY' });
expect(rows[0].price_currency).toBe('CNY');
});
it('respects offset for rank numbering when paginating', async () => {
const search = getRegistry().get('booking/search');
const pagedPage = {
goto: async () => {},
wait: async () => {},
evaluate: async () => ({
ok: true,
blocked: false,
totalText: '',
items: [
{ name: 'A', country: 'jp', slug: 'a', url: 'https://www.booking.com/hotel/jp/a.html', distance: '', review_score: null, review_count: null, star_rating: null, price_currency: '', price_amount: null, recommended_room: '' },
{ name: 'B', country: 'jp', slug: 'b', url: 'https://www.booking.com/hotel/jp/b.html', distance: '', review_score: null, review_count: null, star_rating: null, price_currency: '', price_amount: null, recommended_room: '' },
],
}),
};
const rows = await search.func(pagedPage, { destination: 'Tokyo', checkin: '2026-06-15', checkout: '2026-06-17', offset: 50 });
expect(rows[0].rank).toBe(51);
expect(rows[1].rank).toBe(52);
});
});