googlemaps-kit 0.6.0 → 0.7.0

package/dist/translate.d.ts

@@ -0,0 +1,75 @@
+import { type GoogleWebConfig, type GoogleWebRequestOptions } from './utils/google-web.js';
+export { GoogleWebError } from './utils/google-web.js';
+export interface TranslateConfig extends GoogleWebConfig {
+    locale?: string;
+}
+export interface TranslateOptions extends GoogleWebRequestOptions {
+    from?: string;
+    to: string;
+}
+export interface TranslationSegment {
+    text: string;
+    originalText?: string;
+    spaceBefore: boolean;
+    raw: unknown[];
+}
+export interface TranslationGroup {
+    text: string;
+    segments: TranslationSegment[];
+    raw: unknown[];
+}
+export interface TranslationResult {
+    text: string;
+    detectedLanguage?: string;
+    targetLanguage: string;
+    groups: TranslationGroup[];
+    raw: unknown[];
+}
+export interface TranslationSuggestion {
+    text: string;
+    translation: string;
+    raw: unknown[];
+}
+export interface TranslationSuggestions {
+    suggestions: TranslationSuggestion[];
+    sourceLanguage?: string;
+    targetLanguage?: string;
+    raw: unknown[];
+}
+export interface TranslationSpeech {
+    audio: Uint8Array;
+    mimeType: 'audio/mpeg';
+    raw: unknown[];
+}
+export interface TranslateLanguage {
+    code: string;
+    name: string;
+    raw: unknown[];
+}
+export declare function parseTranslation(raw: unknown): TranslationResult;
+export declare function parseTranslationSuggestions(raw: unknown): TranslationSuggestions;
+/** Public Translate text, suggestion and speech calls, separate from Google Cloud Translation. */
+export declare class TranslateClient {
+    private readonly fetcher;
+    private readonly timeoutMs;
+    private readonly locale;
+    private session?;
+    private requestId;
+    constructor(config?: TranslateConfig);
+    translate(text: string, options: TranslateOptions): Promise<TranslationResult>;
+    suggest(text: string, options: TranslateOptions): Promise<TranslationSuggestions>;
+    speech(text: string, options: GoogleWebRequestOptions & {
+        language: string;
+    }): Promise<TranslationSpeech>;
+    languages(options?: GoogleWebRequestOptions): Promise<{
+        languages: TranslateLanguage[];
+        raw: unknown[];
+    }>;
+    speechLanguages(options?: GoogleWebRequestOptions): Promise<{
+        languages: string[];
+        raw: unknown[];
+    }>;
+    private rpc;
+}
+export declare function googleTranslate(config?: TranslateConfig): TranslateClient;
+//# sourceMappingURL=translate.d.ts.map

package/dist/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"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"}

package/dist/translate.js

@@ -0,0 +1,126 @@
+import { googleBatchBody, googleBatchResponse, googleBootstrap, googleWebText, GoogleWebError, positiveTimeout } from './utils/google-web.js';
+export { GoogleWebError } from './utils/google-web.js';
+function language(value, allowAuto = false) {
+    if (typeof value !== 'string' || !/^[a-zA-Z]{2,8}(?:-[a-zA-Z0-9]{1,8})*$/.test(value) || (!allowAuto && value === 'auto'))
+        throw new TypeError('Expected a language code');
+    return value;
+}
+function textInput(value) {
+    if (typeof value !== 'string' || !value.trim())
+        throw new TypeError('Translation text must not be empty');
+    return value;
+}
+function array(value, name) {
+    if (!Array.isArray(value))
+        throw new GoogleWebError(`Malformed Translate ${name}`, 'parse');
+    return value;
+}
+export function parseTranslation(raw) {
+    const data = array(raw, 'response');
+    const translation = array(data[1], 'translation');
+    if (typeof translation[1] !== 'string')
+        throw new GoogleWebError('Translate response has no target language', 'parse');
+    const groups = array(translation[0], 'groups').map(value => {
+        const group = array(value, 'group');
+        const segments = array(group[5] ?? [], 'segments').map(item => {
+            const segment = array(item, 'segment');
+            if (typeof segment[0] !== 'string')
+                throw new GoogleWebError('Translate segment has no text', 'parse');
+            return { text: segment[0], originalText: typeof segment[6] === 'string' ? segment[6] : undefined, spaceBefore: segment[2] === true, raw: segment };
+        });
+        const text = segments.length > 0 ? segments.map(segment => `${segment.spaceBefore ? ' ' : ''}${segment.text}`).join('') : group[0];
+        if (typeof text !== 'string')
+            throw new GoogleWebError('Translate group has no text or segments', 'parse');
+        return { text, segments, raw: group };
+    });
+    if (groups.length === 0 || groups.every(group => group.text.length === 0))
+        throw new GoogleWebError('Translate response has no translated text', 'parse');
+    return {
+        text: groups.map(group => group.text).join('\n'),
+        detectedLanguage: typeof data[2] === 'string' ? data[2] : undefined,
+        targetLanguage: translation[1], groups, raw: data,
+    };
+}
+export function parseTranslationSuggestions(raw) {
+    const data = array(raw, 'suggestions response');
+    const suggestions = array(data[0] ?? [], 'suggestions').map(value => {
+        const pair = array(value, 'suggestion');
+        if (typeof pair[0] !== 'string' || typeof pair[1] !== 'string')
+            throw new GoogleWebError('Malformed Translate suggestion pair', 'parse');
+        return { text: pair[0], translation: pair[1], raw: pair };
+    });
+    return { suggestions, sourceLanguage: typeof data[1] === 'string' ? data[1] : undefined, targetLanguage: typeof data[2] === 'string' ? data[2] : undefined, raw: data };
+}
+/** Public Translate text, suggestion and speech calls, separate from Google Cloud Translation. */
+export class TranslateClient {
+    fetcher;
+    timeoutMs;
+    locale;
+    session;
+    requestId = Math.floor(Math.random() * 90_000) + 10_000;
+    constructor(config = {}) {
+        this.fetcher = config.fetch ?? globalThis.fetch;
+        this.timeoutMs = positiveTimeout(config.timeoutMs ?? 30_000);
+        this.locale = language(config.locale ?? 'en');
+    }
+    async translate(text, options) {
+        textInput(text);
+        const from = options.from === 'auto' || options.from === undefined ? 'auto' : language(options.from);
+        const to = language(options.to);
+        // Current TranslateWebserverUi sends engine flags 1 in request fields [0][3] and [0][5].
+        return parseTranslation(await this.rpc('MkEWBc', [[text, from, to, 1, null, 1], []], options));
+    }
+    async suggest(text, options) {
+        textInput(text);
+        const from = options.from === 'auto' || options.from === undefined ? 'auto' : language(options.from);
+        return parseTranslationSuggestions(await this.rpc('AVdN8', [text, from, language(options.to)], options));
+    }
+    async speech(text, options) {
+        textInput(text);
+        const data = array(await this.rpc('jQ1olc', [text, language(options.language), null, null, [0]], options), 'speech');
+        if (typeof data[0] !== 'string' || !data[0] || !/^[A-Za-z0-9+/]+={0,2}$/.test(data[0]) || data[0].length % 4 !== 0)
+            throw new GoogleWebError('Malformed Translate speech audio', 'parse');
+        const audio = new Uint8Array(Buffer.from(data[0], 'base64'));
+        if (audio.length < 3 || !((audio[0] === 0xff && (audio[1] & 0xe0) === 0xe0) || (audio[0] === 0x49 && audio[1] === 0x44 && audio[2] === 0x33)))
+            throw new GoogleWebError('Translate speech did not return MP3 audio', 'parse');
+        return { audio, mimeType: 'audio/mpeg', raw: data };
+    }
+    async languages(options = {}) {
+        const data = array(await this.rpc('n9wk7', [], options), 'languages response');
+        const languages = array(data[0], 'languages').map(value => {
+            const row = array(value, 'language');
+            if (typeof row[0] !== 'string' || typeof row[1] !== 'string')
+                throw new GoogleWebError('Malformed Translate language', 'parse');
+            return { code: row[0], name: row[1], raw: row };
+        });
+        return { languages, raw: data };
+    }
+    async speechLanguages(options = {}) {
+        const data = array(await this.rpc('ycyxUb', [], options), 'speech languages response');
+        const languages = array(data[0], 'speech languages').map(value => {
+            const row = array(value, 'speech language');
+            if (typeof row[0] !== 'string')
+                throw new GoogleWebError('Malformed Translate speech language', 'parse');
+            return row[0];
+        });
+        return { languages, raw: data };
+    }
+    async rpc(id, args, options) {
+        if (options.signal?.aborted)
+            throw options.signal.reason;
+        if (!this.session) {
+            const url = new URL('https://translate.google.com/');
+            url.searchParams.set('hl', this.locale);
+            const bootstrap = googleBootstrap(await googleWebText(this.fetcher, url, { method: 'GET' }, this.timeoutMs, options.signal));
+            if (typeof bootstrap.cfb2h !== 'string' || typeof bootstrap.FdrFJe !== 'string')
+                throw new GoogleWebError('Translate bootstrap is missing build or session ID', 'parse');
+            this.session = { build: bootstrap.cfb2h, id: bootstrap.FdrFJe, token: typeof bootstrap.SNlM0e === 'string' ? bootstrap.SNlM0e : undefined };
+        }
+        const url = new URL('https://translate.google.com/_/TranslateWebserverUi/data/batchexecute');
+        for (const [key, value] of Object.entries({ rpcids: id, 'source-path': '/', 'f.sid': this.session.id, bl: this.session.build, hl: this.locale, _reqid: String(this.requestId += 100_000), rt: 'c' }))
+            url.searchParams.set(key, value);
+        return googleBatchResponse(await googleWebText(this.fetcher, url, { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8' }, body: googleBatchBody(id, args, this.session.token) }, this.timeoutMs, options.signal), id);
+    }
+}
+export function googleTranslate(config = {}) { return new TranslateClient(config); }
+//# sourceMappingURL=translate.js.map

package/dist/translate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.js","sourceRoot":"","sources":["../src/translate.ts"],"names":[],"mappings":"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"}

package/dist/travel-google/common.d.ts

@@ -0,0 +1,24 @@
+import type { GoogleWebConfig, GoogleWebRequestOptions } from '../utils/google-web.js';
+export interface GoogleTravelConfig extends GoogleWebConfig {
+    currency?: string;
+    language?: string;
+    userAgent?: string;
+}
+export type GoogleTravelRequestOptions = GoogleWebRequestOptions;
+export declare const array: (value: unknown) => unknown[];
+export declare const numeric: (value: unknown) => number | undefined;
+export declare const text: (value: unknown) => string | undefined;
+export declare function travelDate(value: string): number[];
+export declare function dateFromWire(value: unknown): string | undefined;
+export declare class TravelRpc {
+    private readonly app;
+    readonly currency: string;
+    readonly language: string;
+    private readonly fetcher;
+    private readonly timeoutMs;
+    private readonly userAgent;
+    private wiz?;
+    constructor(app: 'flights' | 'hotels', config?: GoogleTravelConfig);
+    call(id: string, args: unknown[], options: GoogleTravelRequestOptions): Promise<unknown>;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/travel-google/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/travel-google/common.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAEvF,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,CAAC;AACjE,eAAO,MAAM,KAAK,GAAI,OAAO,OAAO,KAAG,OAAO,EAAuC,CAAC;AACtF,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAAoF,CAAC;AACvI,eAAO,MAAM,IAAI,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAA8E,CAAC;AAE9H,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK/D;AAED,qBAAa,SAAS;IAQR,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPhC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,GAAG,CAAC,CAA0B;gBAET,GAAG,EAAE,SAAS,GAAG,QAAQ,EAAE,MAAM,GAAE,kBAAuB;IAWjF,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,OAAO,CAAC;CAqB/F"}

package/dist/travel-google/common.js

@@ -0,0 +1,72 @@
+import { GoogleWebError, googleBatchBody, googleBatchResponse, googleBootstrap, googleWebText, positiveTimeout, } from '../utils/google-web.js';
+export const array = (value) => Array.isArray(value) ? value : [];
+export const numeric = (value) => typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+export const text = (value) => typeof value === 'string' && value.length > 0 ? value : undefined;
+export function travelDate(value) {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        throw new TypeError('Travel dates must use YYYY-MM-DD');
+    const date = new Date(`${value}T00:00:00Z`);
+    if (!Number.isFinite(date.getTime()) || date.toISOString().slice(0, 10) !== value)
+        throw new RangeError('Invalid travel date');
+    return value.split('-').map(Number);
+}
+export function dateFromWire(value) {
+    const node = array(value);
+    if (node.length < 3 || !node.slice(0, 3).every(Number.isInteger))
+        return undefined;
+    const result = `${String(node[0]).padStart(4, '0')}-${String(node[1]).padStart(2, '0')}-${String(node[2]).padStart(2, '0')}`;
+    try {
+        travelDate(result);
+        return result;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class TravelRpc {
+    app;
+    currency;
+    language;
+    fetcher;
+    timeoutMs;
+    userAgent;
+    wiz;
+    constructor(app, config = {}) {
+        this.app = app;
+        this.fetcher = config.fetch ?? globalThis.fetch;
+        this.timeoutMs = positiveTimeout(config.timeoutMs ?? 30_000);
+        this.currency = config.currency?.toUpperCase() ?? 'USD';
+        this.language = config.language ?? 'en';
+        if (!/^[A-Z]{3}$/.test(this.currency))
+            throw new TypeError('Travel currency must use a three-letter code');
+        if (!/^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/.test(this.language))
+            throw new TypeError('Invalid travel language');
+        this.userAgent = config.userAgent ?? 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/156.0.0.0 Safari/537.36';
+        if (!this.userAgent.trim() || /[\r\n]/.test(this.userAgent))
+            throw new TypeError('Invalid travel user agent');
+    }
+    async call(id, args, options) {
+        const app = this.app === 'flights' ? 'FlightsFrontendUi' : 'TravelFrontendUi';
+        if (!this.wiz) {
+            const url = new URL(`https://www.google.com/travel/${this.app}`);
+            url.searchParams.set('hl', this.language);
+            url.searchParams.set('curr', this.currency);
+            const html = await googleWebText(this.fetcher, url, { headers: { 'User-Agent': this.userAgent, Accept: 'text/html' } }, this.timeoutMs, options.signal);
+            const wiz = googleBootstrap(html);
+            if (wiz.eptZe !== `/_/${app}/`)
+                throw new GoogleWebError('Google returned an unsupported travel application', 'parse');
+            this.wiz = wiz;
+        }
+        const url = new URL(`https://www.google.com/_/${app}/data/batchexecute`);
+        for (const [key, value] of Object.entries({ rpcids: id, 'source-path': this.app === 'flights' ? '/travel/flights' : '/travel/search', 'f.sid': this.wiz.FdrFJe, bl: this.wiz.cfb2h, hl: this.language, curr: this.currency, rt: 'c' })) {
+            if (value != null)
+                url.searchParams.set(key, String(value));
+        }
+        const body = await googleWebText(this.fetcher, url, {
+            method: 'POST', headers: { 'User-Agent': this.userAgent, 'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8', Origin: 'https://www.google.com', Referer: 'https://www.google.com/travel/' },
+            body: googleBatchBody(id, args, typeof this.wiz.SNlM0e === 'string' ? this.wiz.SNlM0e : undefined),
+        }, this.timeoutMs, options.signal);
+        return googleBatchResponse(body, id);
+    }
+}
+//# sourceMappingURL=common.js.map

package/dist/travel-google/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/travel-google/common.ts"],"names":[],"mappings":"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"}

package/dist/trends/client.d.ts

@@ -0,0 +1,17 @@
+import type { TrendsConfig, TrendsEmbedType, TrendsExploreOptions, TrendsFeed, TrendsRequestOptions, TrendsSuggestions, TrendingOptions } from './types.js';
+/** Anonymous Trends topic suggestions and the public Trending now RSS feed. */
+export declare class TrendsClient {
+    private readonly fetcher;
+    private readonly locale;
+    private readonly timezone;
+    private readonly timeoutMs;
+    constructor(config?: TrendsConfig);
+    /** Resolves search terms to suggested topic IDs, titles, and topic types. */
+    suggestions(keyword: string, options?: TrendsRequestOptions): Promise<TrendsSuggestions>;
+    /** Reads the public feed; approximateTraffic retains Google's bucketed display value. */
+    trending(options?: TrendingOptions): Promise<TrendsFeed>;
+    exploreUrl(options: TrendsExploreOptions): string;
+    embedUrl(type: TrendsEmbedType, options: TrendsExploreOptions): string;
+    private get;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/trends/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/trends/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAc5J,+EAA+E;AAC/E,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,YAAiB;IAOrC,6EAA6E;IACvE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOlG,yFAAyF;IACnF,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMlE,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAIjD,QAAQ,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM;YAIxD,GAAG;CA0BlB"}

package/dist/trends/client.js

@@ -0,0 +1,86 @@
+import { TrendsError } from './errors.js';
+import { buildTrendsEmbedUrl, buildTrendsExploreUrl, trendsGeo, trendsTimezone } from './links.js';
+import { parseSuggestions, parseTrendingRss, parseTrendsJson } from './parsers.js';
+function timeout(value) {
+    if (!Number.isFinite(value) || value <= 0 || value > 2_147_483_647)
+        throw new RangeError('timeoutMs must be positive and no greater than 2147483647');
+    return value;
+}
+function retryAfter(value) {
+    if (!value)
+        return undefined;
+    if (/^\d+(?:\.\d+)?$/.test(value))
+        return Number(value) * 1000;
+    const date = Date.parse(value);
+    return Number.isFinite(date) ? Math.max(0, date - Date.now()) : undefined;
+}
+/** Anonymous Trends topic suggestions and the public Trending now RSS feed. */
+export class TrendsClient {
+    fetcher;
+    locale;
+    timezone;
+    timeoutMs;
+    constructor(config = {}) {
+        this.fetcher = config.fetch ?? globalThis.fetch;
+        this.locale = config.locale ?? 'en-US';
+        this.timezone = trendsTimezone(config.timezone ?? 0);
+        this.timeoutMs = timeout(config.timeoutMs ?? 30_000);
+    }
+    /** Resolves search terms to suggested topic IDs, titles, and topic types. */
+    async suggestions(keyword, options = {}) {
+        if (typeof keyword !== 'string' || keyword.trim().length === 0)
+            throw new TypeError('keyword must be a nonempty string');
+        const url = new URL(`https://trends.google.com/trends/api/autocomplete/${encodeURIComponent(keyword)}`);
+        url.searchParams.set('hl', this.locale);
+        return parseSuggestions(parseTrendsJson(await this.get(url, options)));
+    }
+    /** Reads the public feed; approximateTraffic retains Google's bucketed display value. */
+    async trending(options = {}) {
+        const url = new URL('https://trends.google.com/trending/rss');
+        url.searchParams.set('geo', trendsGeo(options.geo ?? 'US'));
+        return parseTrendingRss(await this.get(url, options));
+    }
+    exploreUrl(options) {
+        return buildTrendsExploreUrl(options, { locale: this.locale });
+    }
+    embedUrl(type, options) {
+        return buildTrendsEmbedUrl(type, options, { locale: this.locale, timezone: this.timezone });
+    }
+    async get(url, options) {
+        if (options.signal?.aborted)
+            throw options.signal.reason ?? new DOMException('The operation was aborted', 'AbortError');
+        const controller = new AbortController();
+        const abort = () => controller.abort(options.signal?.reason ?? new DOMException('The operation was aborted', 'AbortError'));
+        options.signal?.addEventListener('abort', abort, { once: true });
+        const timer = setTimeout(() => controller.abort(new TrendsError('Google Trends request timed out', 'timeout')), this.timeoutMs);
+        timer.unref?.();
+        try {
+            const response = await this.fetcher(url.toString(), { signal: controller.signal, headers: { Accept: 'application/json, application/rss+xml, application/xml, text/xml' } });
+            const body = await response.text();
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            if (response.status === 429)
+                throw new TrendsError('Google Trends rate limited this request', 'rate-limit', 429, retryAfter(response.headers.get('retry-after')));
+            const html = response.headers.get('content-type')?.includes('text/html') || /^\s*<!doctype html|^\s*<html/i.test(body);
+            if (html && /unusual traffic|g-recaptcha|recaptcha\/api|\/sorry\/index/i.test(body))
+                throw new TrendsError('Google Trends returned a traffic challenge', 'blocked', response.status);
+            if (!response.ok)
+                throw new TrendsError(`Google Trends returned HTTP ${response.status}`, 'http', response.status, retryAfter(response.headers.get('retry-after')));
+            if (html)
+                throw new TrendsError('Google Trends returned an HTML access page', 'blocked', response.status);
+            return body;
+        }
+        catch (cause) {
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            if (cause instanceof TrendsError)
+                throw cause;
+            throw new TrendsError('Google Trends request failed', 'network', undefined, undefined, { cause });
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', abort);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/trends/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/trends/client.ts"],"names":[],"mappings":"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"}

package/dist/trends/errors.d.ts

@@ -0,0 +1,8 @@
+export type TrendsErrorKind = 'http' | 'rate-limit' | 'blocked' | 'parse' | 'timeout' | 'network';
+export declare class TrendsError extends Error {
+    readonly kind: TrendsErrorKind;
+    readonly status?: number | undefined;
+    readonly retryAfterMs?: number | undefined;
+    constructor(message: string, kind: TrendsErrorKind, status?: number | undefined, retryAfterMs?: number | undefined, options?: ErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/trends/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/trends/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAElG,qBAAa,WAAY,SAAQ,KAAK;IAGlC,QAAQ,CAAC,IAAI,EAAE,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;gBAH9B,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,eAAe,EACrB,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,YAAY,CAAC,EAAE,MAAM,YAAA,EAC9B,OAAO,CAAC,EAAE,YAAY;CAKzB"}

package/dist/trends/errors.js

@@ -0,0 +1,13 @@
+export class TrendsError extends Error {
+    kind;
+    status;
+    retryAfterMs;
+    constructor(message, kind, status, retryAfterMs, options) {
+        super(message, options);
+        this.kind = kind;
+        this.status = status;
+        this.retryAfterMs = retryAfterMs;
+        this.name = 'TrendsError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/trends/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/trends/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGzB;IACA;IACA;IAJX,YACE,OAAe,EACN,IAAqB,EACrB,MAAe,EACf,YAAqB,EAC9B,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QALf,SAAI,GAAJ,IAAI,CAAiB;QACrB,WAAM,GAAN,MAAM,CAAS;QACf,iBAAY,GAAZ,YAAY,CAAS;QAI9B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}

package/dist/trends/links.d.ts

@@ -0,0 +1,8 @@
+import type { TrendsEmbedType, TrendsExploreOptions, TrendsLinkOptions } from './types.js';
+export declare function trendsTimezone(value: number): number;
+export declare function trendsGeo(value: string): string;
+/** Builds a website link for comparisons sharing one location and time range. */
+export declare function buildTrendsExploreUrl(options: TrendsExploreOptions, link?: TrendsLinkOptions): string;
+/** Builds an iframe URL using the request structure in Google's shipped embed loader. */
+export declare function buildTrendsEmbedUrl(type: TrendsEmbedType, options: TrendsExploreOptions, link?: TrendsLinkOptions): string;
+//# sourceMappingURL=links.d.ts.map

package/dist/trends/links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../src/trends/links.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAK3F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAmBD,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAgBzG;AAED,yFAAyF;AACzF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,oBAAoB,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAO9H"}

package/dist/trends/links.js

@@ -0,0 +1,71 @@
+const PROPERTIES = new Set(['', 'images', 'news', 'froogle', 'youtube']);
+const EMBEDS = new Set(['TIMESERIES', 'GEO_MAP', 'RELATED_TOPICS', 'RELATED_QUERIES']);
+export function trendsTimezone(value) {
+    if (!Number.isInteger(value) || Math.abs(value) > 1440)
+        throw new RangeError('timezone must be integer minutes west of UTC between -1440 and 1440');
+    return value;
+}
+export function trendsGeo(value) {
+    if (!/^[A-Z]{2}(?:-[A-Z0-9]+)*$/.test(value))
+        throw new TypeError('geo must be a country or subdivision code such as US or US-CA');
+    return value;
+}
+function request(options) {
+    if (!Array.isArray(options.comparisonItem) || options.comparisonItem.length === 0)
+        throw new TypeError('comparisonItem must contain at least one keyword');
+    const comparisonItem = options.comparisonItem.map(item => {
+        if (typeof item.keyword !== 'string' || item.keyword.trim().length === 0)
+            throw new TypeError('keyword must be a nonempty search term or topic ID');
+        const geo = item.geo ?? '';
+        if (geo !== '')
+            trendsGeo(geo);
+        const time = item.time ?? 'today 12-m';
+        if (typeof time !== 'string' || time.trim().length === 0)
+            throw new TypeError('time must be a nonempty Trends range expression');
+        return { keyword: item.keyword, geo, time };
+    });
+    const category = options.category ?? 0;
+    if (!Number.isSafeInteger(category) || category < 0)
+        throw new RangeError('category must be a nonnegative integer');
+    const property = options.property ?? '';
+    if (!PROPERTIES.has(property))
+        throw new TypeError('property must be empty, images, news, froogle, or youtube');
+    return { comparisonItem, category, property };
+}
+/** Builds a website link for comparisons sharing one location and time range. */
+export function buildTrendsExploreUrl(options, link = {}) {
+    const value = request(options);
+    const items = value.comparisonItem;
+    if (new Set(items.map(item => item.geo)).size > 1 || new Set(items.map(item => item.time)).size > 1)
+        throw new TypeError('Explore links require a shared geo and time; use an embed URL for per-item settings');
+    if (items.some(item => item.keyword.includes(',')))
+        throw new TypeError('Explore links cannot preserve commas inside keywords; use an embed URL');
+    const url = new URL('https://trends.google.com/trends/explore');
+    url.searchParams.set('q', items.map(item => item.keyword).join(','));
+    const geos = items.map(item => item.geo);
+    const times = items.map(item => item.time);
+    if (geos.some(Boolean))
+        url.searchParams.set('geo', new Set(geos).size === 1 ? geos[0] : geos.join(','));
+    url.searchParams.set('date', new Set(times).size === 1 ? times[0] : times.join(','));
+    if (value.category !== 0)
+        url.searchParams.set('cat', String(value.category));
+    if (value.property !== '')
+        url.searchParams.set('gprop', String(value.property));
+    if (link.locale)
+        url.searchParams.set('hl', link.locale);
+    if (link.legacy)
+        url.searchParams.set('legacy', '');
+    return url.toString();
+}
+/** Builds an iframe URL using the request structure in Google's shipped embed loader. */
+export function buildTrendsEmbedUrl(type, options, link = {}) {
+    if (!EMBEDS.has(type))
+        throw new TypeError('Unsupported Trends embed type');
+    const url = new URL(`https://trends.google.com/trends/embed/explore/${type}`);
+    url.searchParams.set('req', JSON.stringify(request(options)));
+    url.searchParams.set('tz', String(trendsTimezone(link.timezone ?? 0)));
+    if (link.locale)
+        url.searchParams.set('hl', link.locale.replace(/[^a-z]/ig, ''));
+    return url.toString();
+}
+//# sourceMappingURL=links.js.map

package/dist/trends/links.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/trends/links.ts"],"names":[],"mappings":"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"}

package/dist/trends/parsers.d.ts

@@ -0,0 +1,5 @@
+import type { TrendsFeed, TrendsSuggestions } from './types.js';
+export declare function parseTrendsJson(text: string): Record<string, unknown>;
+export declare function parseSuggestions(raw: unknown): TrendsSuggestions;
+export declare function parseTrendingRss(raw: string): TrendsFeed;
+//# sourceMappingURL=parsers.d.ts.map

package/dist/trends/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/trends/parsers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiC,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAc/F,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQrE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAYhE;AA6CD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAuCxD"}