googlemaps-kit 0.6.0 → 0.7.0

package/dist/youtube/client.js

@@ -0,0 +1,115 @@
+import { YouTubeError } from './errors.js';
+import { extractYouTubeClient, extractYouTubeJson, parseSearch, parseVideo, parseYouTubeVideoId, youtubeObject } from './parsers.js';
+/** Reads anonymous watch metadata, search results, continuations, and oEmbed responses. */
+export class YouTubeClient {
+    fetcher;
+    locale;
+    region;
+    timeoutMs;
+    constructor(config = {}) {
+        this.fetcher = config.fetch ?? globalThis.fetch;
+        this.locale = config.locale ?? 'en';
+        this.region = config.region ?? 'US';
+        this.timeoutMs = config.timeoutMs ?? 30_000;
+        if (!Number.isFinite(this.timeoutMs) || this.timeoutMs <= 0 || this.timeoutMs > 2_147_483_647)
+            throw new RangeError('timeoutMs must be positive and no greater than 2147483647');
+        if (!/^[A-Za-z]{2}$/.test(this.region))
+            throw new TypeError('region must be a two-letter country code');
+    }
+    /** Returns metadata and explicit playability status; it never fetches audio or video streams. */
+    async video(idOrUrl, options = {}) {
+        const id = parseYouTubeVideoId(idOrUrl);
+        const url = this.webUrl('/watch');
+        url.searchParams.set('v', id);
+        const html = await this.request(url, options);
+        const raw = extractYouTubeJson(html, 'ytInitialPlayerResponse');
+        if (!raw)
+            throw new YouTubeError('YouTube did not provide a player response', 'parse');
+        return parseVideo(raw, id, extractYouTubeJson(html, 'ytInitialData'));
+    }
+    async search(query, options = {}) {
+        if (typeof query !== 'string' || query.trim().length === 0)
+            throw new TypeError('query must be a nonempty string');
+        const url = this.webUrl('/results');
+        url.searchParams.set('search_query', query);
+        const html = await this.request(url, options);
+        const raw = extractYouTubeJson(html, 'ytInitialData');
+        if (!raw)
+            throw new YouTubeError('YouTube did not provide search data', 'parse');
+        return parseSearch(raw, extractYouTubeClient(html));
+    }
+    /** Uses the opaque continuation and anonymous client context returned by search. */
+    async continueSearch(cursor, options = {}) {
+        if (!cursor || typeof cursor.token !== 'string' || cursor.token.length === 0 || !cursor.client || cursor.client.clientName !== 'WEB' || typeof cursor.client.clientVersion !== 'string' || !cursor.client.clientVersion)
+            throw new TypeError('A search continuation with its client context is required');
+        const client = { clientName: cursor.client.clientName, clientVersion: cursor.client.clientVersion, hl: cursor.client.hl, gl: cursor.client.gl, visitorData: cursor.client.visitorData };
+        const text = await this.request(new URL('https://www.youtube.com/youtubei/v1/search?prettyPrint=false'), options, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', 'X-Youtube-Client-Name': '1', 'X-Youtube-Client-Version': client.clientVersion },
+            body: JSON.stringify({ context: { client }, continuation: cursor.token }),
+        });
+        return parseSearch(this.json(text), client);
+    }
+    async oembed(idOrUrl, options = {}) {
+        const id = parseYouTubeVideoId(idOrUrl);
+        const url = new URL('https://www.youtube.com/oembed');
+        url.searchParams.set('url', `https://www.youtube.com/watch?v=${id}`);
+        url.searchParams.set('format', 'json');
+        const raw = this.json(await this.request(url, options));
+        if (!youtubeObject(raw) || ['title', 'author_name', 'author_url', 'type', 'version', 'provider_name', 'provider_url', 'thumbnail_url', 'html'].some(key => typeof raw[key] !== 'string') || ['height', 'width', 'thumbnail_height', 'thumbnail_width'].some(key => typeof raw[key] !== 'number' || !Number.isFinite(raw[key])))
+            throw new YouTubeError('Malformed YouTube oEmbed response', 'parse');
+        return raw;
+    }
+    webUrl(path) {
+        const url = new URL(path, 'https://www.youtube.com');
+        url.searchParams.set('hl', this.locale);
+        url.searchParams.set('gl', this.region.toUpperCase());
+        return url;
+    }
+    json(text) {
+        try {
+            return JSON.parse(text.replace(/^\)\]\}'\s*/, ''));
+        }
+        catch (cause) {
+            throw new YouTubeError('Malformed YouTube JSON response', 'parse', undefined, undefined, { cause });
+        }
+    }
+    async request(url, options, init = {}) {
+        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 YouTubeError('YouTube request timed out', 'timeout')), this.timeoutMs);
+        timer.unref?.();
+        try {
+            const response = await this.fetcher(url.toString(), { ...init, signal: controller.signal });
+            const body = await response.text();
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            const retry = response.headers.get('retry-after');
+            const retryAfterMs = retry && /^\d+(?:\.\d+)?$/.test(retry) ? Number(retry) * 1000 : retry && Number.isFinite(Date.parse(retry)) ? Math.max(0, Date.parse(retry) - Date.now()) : undefined;
+            if (response.status === 429)
+                throw new YouTubeError('YouTube rate limited this request', 'rate-limit', 429, retryAfterMs);
+            if (/\/sorry\/|consent\.youtube\.com|consent\.google\.com/.test(response.url) || /<(?:form|div)[^>]+(?:captcha|consent)|<title[^>]*>[^<]*(?:unusual traffic|consent)/i.test(body))
+                throw new YouTubeError('YouTube returned a consent or traffic challenge', 'blocked', response.status);
+            if (response.status === 401)
+                throw new YouTubeError('YouTube requires authentication', 'auth-required', 401);
+            if (!response.ok)
+                throw new YouTubeError(`YouTube returned HTTP ${response.status}`, 'http', response.status, retryAfterMs);
+            return body;
+        }
+        catch (cause) {
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            if (cause instanceof YouTubeError)
+                throw cause;
+            throw new YouTubeError('YouTube request failed', 'network', undefined, undefined, { cause });
+        }
+        finally {
+            clearTimeout(timer);
+            options.signal?.removeEventListener('abort', abort);
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/youtube/client.js.map

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

package/dist/youtube/errors.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/youtube/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,eAAe,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AACrH,qBAAa,YAAa,SAAQ,KAAK;IACR,QAAQ,CAAC,IAAI,EAAE,gBAAgB;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM;gBAA1G,OAAO,EAAE,MAAM,EAAW,IAAI,EAAE,gBAAgB,EAAW,MAAM,CAAC,EAAE,MAAM,YAAA,EAAW,YAAY,CAAC,EAAE,MAAM,YAAA,EAAE,OAAO,CAAC,EAAE,YAAY;CAI/I"}

package/dist/youtube/errors.js

@@ -0,0 +1,13 @@
+export class YouTubeError 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 = 'YouTubeError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/youtube/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/youtube/errors.ts"],"names":[],"mappings":"AACA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACC;IAAiC;IAA0B;IAAjG,YAAY,OAAe,EAAW,IAAsB,EAAW,MAAe,EAAW,YAAqB,EAAE,OAAsB;QAC5I,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QADY,SAAI,GAAJ,IAAI,CAAkB;QAAW,WAAM,GAAN,MAAM,CAAS;QAAW,iBAAY,GAAZ,YAAY,CAAS;QAEpH,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/youtube/parsers.d.ts

@@ -0,0 +1,9 @@
+import type { YouTubeSearchCursor, YouTubeSearchPage, YouTubeVideo } from './types.js';
+export declare function youtubeObject(value: unknown): value is Record<string, unknown>;
+export declare function youtubeText(value: unknown): string | undefined;
+export declare function extractYouTubeJson(html: string, variable: string): Record<string, unknown> | undefined;
+export declare function parseVideo(raw: unknown, id: string, initialData?: Record<string, unknown>): YouTubeVideo;
+export declare function parseSearch(raw: unknown, client: YouTubeSearchCursor['client']): YouTubeSearchPage;
+export declare function extractYouTubeClient(html: string): YouTubeSearchCursor['client'];
+export declare function parseYouTubeVideoId(value: string): string;
+//# sourceMappingURL=parsers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../src/youtube/parsers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuB,mBAAmB,EAAqB,iBAAiB,EAAoB,YAAY,EAAE,MAAM,YAAY,CAAC;AAEjJ,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAUD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAM9D;AAOD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAwBtG;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAqBxG;AA6CD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,iBAAiB,CA+BlG;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAWhF;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUzD"}

package/dist/youtube/parsers.js

@@ -0,0 +1,213 @@
+import { YouTubeError } from './errors.js';
+export function youtubeObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function fail(label) { throw new YouTubeError(`Malformed YouTube ${label}`, 'parse'); }
+function optionalString(value) { return typeof value === 'string' ? value : undefined; }
+function requiredString(value, name) { return typeof value === 'string' && value.length > 0 ? value : fail(name); }
+function numeric(value) {
+    const result = typeof value === 'string' && /^\d+$/.test(value) ? Number(value) : value;
+    return typeof result === 'number' && Number.isFinite(result) && result >= 0 ? result : undefined;
+}
+export function youtubeText(value) {
+    if (!youtubeObject(value))
+        return undefined;
+    if (typeof value.simpleText === 'string')
+        return value.simpleText;
+    if (Array.isArray(value.runs))
+        return value.runs.map(run => youtubeObject(run) && typeof run.text === 'string' ? run.text : '').join('');
+    if (typeof value.content === 'string')
+        return value.content;
+    return undefined;
+}
+function thumbnails(value) {
+    if (!youtubeObject(value) || !Array.isArray(value.thumbnails))
+        return [];
+    return value.thumbnails.flatMap(item => youtubeObject(item) && typeof item.url === 'string' ? [{ url: item.url.startsWith('//') ? `https:${item.url}` : item.url, width: numeric(item.width), height: numeric(item.height) }] : []);
+}
+export function extractYouTubeJson(html, variable) {
+    const escaped = variable.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(`(?:var\\s+)?${escaped}\\s*=\\s*|window\\[["']${escaped}["']\\]\\s*=\\s*`, 'g');
+    let match;
+    while ((match = pattern.exec(html))) {
+        const start = pattern.lastIndex;
+        if (html[start] !== '{')
+            continue;
+        let depth = 0, quoted = false, escapedCharacter = false;
+        for (let index = start; index < html.length; index++) {
+            const character = html[index];
+            if (quoted) {
+                if (escapedCharacter)
+                    escapedCharacter = false;
+                else if (character === '\\')
+                    escapedCharacter = true;
+                else if (character === '"')
+                    quoted = false;
+            }
+            else if (character === '"')
+                quoted = true;
+            else if (character === '{')
+                depth++;
+            else if (character === '}' && --depth === 0) {
+                try {
+                    const value = JSON.parse(html.slice(start, index + 1));
+                    return youtubeObject(value) ? value : fail(variable);
+                }
+                catch (cause) {
+                    throw new YouTubeError(`Malformed YouTube ${variable} JSON`, 'parse', undefined, undefined, { cause });
+                }
+            }
+        }
+        return fail(variable);
+    }
+    return undefined;
+}
+export function parseVideo(raw, id, initialData) {
+    if (!youtubeObject(raw) || !youtubeObject(raw.playabilityStatus))
+        return fail('player response');
+    const playability = raw.playabilityStatus;
+    const details = youtubeObject(raw.videoDetails) ? raw.videoDetails : {};
+    if (details.videoId !== undefined && details.videoId !== id)
+        return fail('player video ID');
+    const captionContainer = youtubeObject(raw.captions) && youtubeObject(raw.captions.playerCaptionsTracklistRenderer) ? raw.captions.playerCaptionsTracklistRenderer : undefined;
+    const captions = !Array.isArray(captionContainer?.captionTracks) ? [] : captionContainer.captionTracks.map(value => {
+        if (!youtubeObject(value))
+            return fail('caption track');
+        return { languageCode: requiredString(value.languageCode, 'caption language'), name: youtubeText(value.name) ?? '', baseUrl: requiredString(value.baseUrl, 'caption URL'), kind: optionalString(value.kind), isTranslatable: typeof value.isTranslatable === 'boolean' ? value.isTranslatable : undefined, raw: value };
+    });
+    return {
+        id: optionalString(details.videoId) ?? id,
+        url: `https://www.youtube.com/watch?v=${id}`,
+        title: optionalString(details.title), author: optionalString(details.author), channelId: optionalString(details.channelId),
+        description: optionalString(details.shortDescription), lengthSeconds: numeric(details.lengthSeconds), viewCount: optionalString(details.viewCount),
+        keywords: Array.isArray(details.keywords) ? details.keywords.filter((value) => typeof value === 'string') : undefined,
+        isLiveContent: typeof details.isLiveContent === 'boolean' ? details.isLiveContent : undefined,
+        thumbnails: thumbnails(details.thumbnail),
+        playability: { status: requiredString(playability.status, 'playability status'), reason: optionalString(playability.reason), raw: playability },
+        captions, raw, initialData,
+    };
+}
+function ownerId(value) {
+    if (!youtubeObject(value) || !Array.isArray(value.runs))
+        return undefined;
+    for (const run of value.runs) {
+        if (youtubeObject(run) && youtubeObject(run.navigationEndpoint) && youtubeObject(run.navigationEndpoint.browseEndpoint))
+            return optionalString(run.navigationEndpoint.browseEndpoint.browseId);
+    }
+    return undefined;
+}
+function searchItem(type, raw) {
+    const id = requiredString(raw[type === 'video' ? 'videoId' : 'channelId'], 'search result ID');
+    const title = youtubeText(raw.title) ?? fail('search result title');
+    const owner = raw.ownerText ?? raw.longBylineText ?? raw.shortBylineText;
+    return {
+        type, id, title,
+        url: type === 'video' ? `https://www.youtube.com/watch?v=${id}` : `https://www.youtube.com/channel/${id}`,
+        description: youtubeText(raw.descriptionSnippet), author: youtubeText(owner), channelId: type === 'channel' ? id : ownerId(owner),
+        duration: youtubeText(raw.lengthText), viewCount: youtubeText(raw.viewCountText), publishedTime: youtubeText(raw.publishedTimeText),
+        thumbnails: thumbnails(raw.thumbnail ?? (Array.isArray(raw.thumbnails) ? raw.thumbnails[0] : undefined)), raw,
+    };
+}
+function path(value, ...keys) {
+    for (const key of keys)
+        value = typeof key === 'number' && Array.isArray(value) ? value[key] : typeof key === 'string' && youtubeObject(value) ? value[key] : undefined;
+    return value;
+}
+function playlistLockup(raw) {
+    const id = requiredString(raw.contentId, 'playlist ID');
+    const metadata = path(raw, 'metadata', 'lockupMetadataViewModel');
+    const rows = path(metadata, 'metadata', 'contentMetadataViewModel', 'metadataRows');
+    const byline = Array.isArray(rows) ? rows.find(row => path(row, 'lockupContentMetadataRowExtension', 'contentType') === 'METADATA_ROW_CONTENT_TYPE_BYLINE') : undefined;
+    const author = path(byline, 'metadataParts', 0, 'text');
+    return {
+        type: 'playlist', id,
+        title: requiredString(youtubeText(path(metadata, 'title')), 'playlist title'),
+        url: `https://www.youtube.com/playlist?list=${id}`,
+        author: youtubeText(author),
+        channelId: optionalString(path(author, 'commandRuns', 0, 'onTap', 'innertubeCommand', 'browseEndpoint', 'browseId')),
+        thumbnails: thumbnails({ thumbnails: path(raw, 'contentImage', 'collectionThumbnailViewModel', 'primaryThumbnail', 'thumbnailViewModel', 'image', 'sources') }),
+        raw,
+    };
+}
+export function parseSearch(raw, client) {
+    if (!youtubeObject(raw))
+        return fail('search response');
+    const primary = youtubeObject(raw.contents) && youtubeObject(raw.contents.twoColumnSearchResultsRenderer) ? raw.contents.twoColumnSearchResultsRenderer.primaryContents : undefined;
+    const actions = raw.onResponseReceivedCommands ?? raw.onResponseReceivedActions;
+    if (!youtubeObject(primary) && !Array.isArray(actions))
+        return fail('search results');
+    const items = [];
+    const seen = new Set();
+    let token;
+    const stack = [primary ?? actions];
+    while (stack.length) {
+        const value = stack.pop();
+        if (Array.isArray(value)) {
+            for (let i = value.length - 1; i >= 0; i--)
+                stack.push(value[i]);
+            continue;
+        }
+        if (!youtubeObject(value))
+            continue;
+        if (youtubeObject(value.continuationCommand) && typeof value.continuationCommand.token === 'string')
+            token ??= value.continuationCommand.token;
+        if (youtubeObject(value.lockupViewModel) && value.lockupViewModel.contentType === 'LOCKUP_CONTENT_TYPE_PLAYLIST') {
+            const item = playlistLockup(value.lockupViewModel);
+            if (!seen.has(`playlist:${item.id}`)) {
+                items.push(item);
+                seen.add(`playlist:${item.id}`);
+            }
+            continue;
+        }
+        const entry = ['video', 'channel'].find(type => youtubeObject(value[`${type}Renderer`]));
+        if (entry) {
+            const item = searchItem(entry, value[`${entry}Renderer`]);
+            const key = `${entry}:${item.id}`;
+            if (!seen.has(key)) {
+                items.push(item);
+                seen.add(key);
+            }
+            continue;
+        }
+        for (const [key, child] of Object.entries(value).reverse()) {
+            if (!/adSlotRenderer|promotedSparklesWebRenderer|searchPyvRenderer|adMetadata|loggingDirectives|trackingParams/.test(key))
+                stack.push(child);
+        }
+    }
+    return { items, estimatedResults: optionalString(raw.estimatedResults), continuation: token ? { token, client } : undefined, raw };
+}
+export function extractYouTubeClient(html) {
+    const pattern = /ytcfg\.set\s*\(/g;
+    let match;
+    while ((match = pattern.exec(html))) {
+        const config = extractYouTubeJson(`config=${html.slice(pattern.lastIndex).trimStart()}`, 'config');
+        if (!config || !youtubeObject(config.INNERTUBE_CONTEXT) || !youtubeObject(config.INNERTUBE_CONTEXT.client))
+            continue;
+        const client = config.INNERTUBE_CONTEXT.client;
+        if (client.clientName !== 'WEB')
+            return fail('unsupported anonymous client');
+        return { clientName: 'WEB', clientVersion: requiredString(client.clientVersion, 'client version'), hl: optionalString(client.hl), gl: optionalString(client.gl), visitorData: optionalString(client.visitorData) };
+    }
+    return fail('anonymous client configuration');
+}
+export function parseYouTubeVideoId(value) {
+    if (typeof value !== 'string')
+        throw new TypeError('A YouTube video ID or URL is required');
+    if (/^[A-Za-z0-9_-]{11}$/.test(value))
+        return value;
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new TypeError('Invalid YouTube video ID or URL');
+    }
+    if (!['https:', 'http:'].includes(url.protocol) || url.username || url.password || url.port)
+        throw new TypeError('Invalid YouTube video URL');
+    const host = url.hostname.toLowerCase();
+    const id = host === 'youtu.be' ? url.pathname.slice(1) : ['youtube.com', 'www.youtube.com', 'm.youtube.com', 'www.youtube-nocookie.com'].includes(host) ? url.pathname === '/watch' ? url.searchParams.get('v') : /^\/(?:shorts|embed|live)\/([A-Za-z0-9_-]{11})\/?$/.exec(url.pathname)?.[1] : undefined;
+    if (typeof id !== 'string' || !/^[A-Za-z0-9_-]{11}$/.test(id))
+        throw new TypeError('Invalid YouTube video URL');
+    return id;
+}
+//# sourceMappingURL=parsers.js.map

package/dist/youtube/parsers.js.map

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

package/dist/youtube/types.d.ts

@@ -0,0 +1,90 @@
+export interface YouTubeConfig {
+    fetch?: typeof globalThis.fetch;
+    locale?: string;
+    region?: string;
+    timeoutMs?: number;
+}
+export interface YouTubeRequestOptions {
+    signal?: AbortSignal;
+}
+export interface YouTubeThumbnail {
+    url: string;
+    width?: number;
+    height?: number;
+}
+export interface YouTubeCaptionTrack {
+    languageCode: string;
+    name: string;
+    baseUrl: string;
+    kind?: string;
+    isTranslatable?: boolean;
+    raw: Record<string, unknown>;
+}
+export interface YouTubeVideo {
+    id: string;
+    url: string;
+    title?: string;
+    author?: string;
+    channelId?: string;
+    description?: string;
+    lengthSeconds?: number;
+    viewCount?: string;
+    keywords?: string[];
+    isLiveContent?: boolean;
+    thumbnails: YouTubeThumbnail[];
+    playability: {
+        status: string;
+        reason?: string;
+        raw: Record<string, unknown>;
+    };
+    captions: YouTubeCaptionTrack[];
+    raw: Record<string, unknown>;
+    initialData?: Record<string, unknown>;
+}
+export interface YouTubeSearchItem {
+    type: 'video' | 'channel' | 'playlist';
+    id: string;
+    title: string;
+    url: string;
+    description?: string;
+    author?: string;
+    channelId?: string;
+    duration?: string;
+    viewCount?: string;
+    publishedTime?: string;
+    thumbnails: YouTubeThumbnail[];
+    raw: Record<string, unknown>;
+}
+export interface YouTubeSearchCursor {
+    token: string;
+    client: {
+        clientName: 'WEB';
+        clientVersion: string;
+        hl?: string;
+        gl?: string;
+        visitorData?: string;
+    };
+}
+export interface YouTubeSearchPage {
+    items: YouTubeSearchItem[];
+    estimatedResults?: string;
+    continuation?: YouTubeSearchCursor;
+    raw: Record<string, unknown>;
+}
+export interface YouTubeOEmbed {
+    title: string;
+    author_name: string;
+    author_url: string;
+    type: string;
+    height: number;
+    width: number;
+    version: string;
+    provider_name: string;
+    provider_url: string;
+    thumbnail_height: number;
+    thumbnail_width: number;
+    thumbnail_url: string;
+    html: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/youtube/types.d.ts.map

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

package/dist/youtube/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/youtube/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/youtube/types.ts"],"names":[],"mappings":""}

package/dist/youtube.d.ts

@@ -0,0 +1,9 @@
+export { YouTubeClient } from './youtube/client.js';
+export { YouTubeError } from './youtube/errors.js';
+export type { YouTubeErrorKind } from './youtube/errors.js';
+export { parseYouTubeVideoId } from './youtube/parsers.js';
+export type * from './youtube/types.js';
+import { YouTubeClient } from './youtube/client.js';
+import type { YouTubeConfig } from './youtube/types.js';
+export declare function youtube(config?: YouTubeConfig): YouTubeClient;
+//# sourceMappingURL=youtube.d.ts.map

package/dist/youtube.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.d.ts","sourceRoot":"","sources":["../src/youtube.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,mBAAmB,oBAAoB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,wBAAgB,OAAO,CAAC,MAAM,GAAE,aAAkB,GAAG,aAAa,CAAsC"}

package/dist/youtube.js

@@ -0,0 +1,6 @@
+export { YouTubeClient } from './youtube/client.js';
+export { YouTubeError } from './youtube/errors.js';
+export { parseYouTubeVideoId } from './youtube/parsers.js';
+import { YouTubeClient } from './youtube/client.js';
+export function youtube(config = {}) { return new YouTubeClient(config); }
+//# sourceMappingURL=youtube.js.map

package/dist/youtube.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.js","sourceRoot":"","sources":["../src/youtube.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,UAAU,OAAO,CAAC,SAAwB,EAAE,IAAmB,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC"}

package/docs/books.md

@@ -0,0 +1,18 @@
+# Google Books public metadata
+
+```ts
+import { googleBooks } from 'googlemaps-kit/books';
+
+const book = await googleBooks().get('zyTCAlFPjgYC');
+console.log(book.title, book.authors, book.identifiers, book.pageCount);
+```
+
+This client reads an observed public bibliographic page at `books.google.com/books?id=...&hl=en`. It returns the title, bibliographic title, authors, publisher/year, edition, ISBNs, page count, optional description, canonical link and original table values. Fields missing from the page remain undefined or empty. It does not retrieve book pages, full text, purchased content, account libraries or previews.
+
+The web metadata request succeeded anonymously on October 29, 2026. The documented Books v1 search and volume endpoints returned HTTP 429 quota errors from the same environment. This module uses the verified web surface; it is not a wrapper presented as successful v1 API access. Search by query, browsing bookshelves, v1 API operations and broad pagination are outside the current implementation.
+
+`googleBooks({ fetch?, timeoutMs? })` accepts an injected fetch and defaults to a 30-second request deadline including the response body. `get(id, { signal? })` accepts a Google volume ID, requests the English page, and makes no automatic retries. Unknown layouts, mismatched volume IDs and HTTP failures throw `GoogleWebError` rather than returning empty fabricated metadata. Regional redirects are handled by normal fetch behavior; bibliographic parsing is verified only for the captured page structure.
+
+`parseGoogleBooksHtml(html, id)` exposes the same parser for saved HTML. It never executes scripts. Sanitized actual fixture provenance is in `tests/fixtures/books/README.md`.
+
+See the [independent research ledger](./google-ai-books-research.md) for observed behavior and unresolved gaps.

package/docs/environment-research.md

@@ -0,0 +1,65 @@
+# Weather, Air Quality and Cloud Vision access boundaries
+
+Audited on 2026-10-29. These products have supported Google APIs with project
+identity and billing/quota rules. A public consumer widget is a different
+contract from those APIs.
+
+## Direct API observations
+
+Requests deliberately supplied no API key, OAuth token or account cookies:
+
+| API | Request | Observed result |
+| --- | --- | --- |
+| Weather current conditions | `GET weather.googleapis.com/v1/currentConditions:lookup` with location | HTTP 403, `PERMISSION_DENIED`, consumer identity required |
+| Air Quality current conditions | `POST airquality.googleapis.com/v1/currentConditions:lookup` with JSON location | HTTP 403, `PERMISSION_DENIED`, consumer identity required |
+| Vision text detection | `POST vision.googleapis.com/v1/images:annotate` with Google's public logo URL | HTTP 403, `PERMISSION_DENIED`, consumer identity required |
+
+These failures establish that the tested official routes do not accept
+unregistered callers. They do not establish successful access to the protected
+data. No project credential was borrowed or extracted and no supported API's
+paid feature is claimed anonymously available.
+
+## Existing consumer capabilities
+
+`maps.environment.weather.getCurrentConditions` parses the weather chip from a
+Maps viewport response. It requires a current in-page viewport `psi` supplied
+by the caller or a `psiProvider`. It does not produce a full forecast. A bare
+degree symbol has no established Celsius/Fahrenheit meaning, so the parser now
+preserves the value/display while leaving `unit` unset unless C or F is explicit.
+
+A fresh ordinary Maps viewport capture for HSR Layout on 2026-10-29 returned
+the expected cache-metadata stub followed by two populated responses. The
+existing parser extracted `HSR Layout`, `28°`, and `Sunny`. This revalidates the
+bounded current-condition chip contract, not a forecast or numerical AQI API.
+
+`maps.environment.airQuality.getHeatmapTile` reads the existing raster overlay
+surface. A tile is not a numerical point AQI lookup, and a returned placeholder
+does not prove meaningful overlay coverage. The existing batchexecute parser
+remains a separate partially established, session-dependent interface.
+
+## Corrected supported-API contracts
+
+The audit identified two existing request bugs and added offline regressions:
+
+- Air Quality `lookup` now sends Google's documented JSON POST location instead
+  of GET query parameters. It accepts only a caller-configured API key.
+- Weather `lookupForecast` now calls `forecast/days:lookup`, returning actual
+  daily records rather than calling current conditions. It accepts `days` and
+  `pageSize` from 1 to 10 and an optional `pageToken`, preserving Google's
+  pagination response. It still requires the caller's API credential.
+
+The shared Maps HTTP client now has `postJson`, which preserves scheduling,
+authentication options, error handling and statistics while parsing ordinary
+JSON objects. Automatic retries are disabled by default for JSON POSTs.
+These request fixes were tested offline; a successful authenticated/billable
+Weather/Air Quality response was not claimed or attempted in this pass.
+
+References: [Weather daily forecast](https://developers.google.com/maps/documentation/weather/reference/rest/v1/forecast.days/lookup),
+[Weather setup](https://developers.google.com/maps/documentation/weather/get-api-key),
+[Air Quality current conditions](https://developers.google.com/maps/documentation/air-quality/reference/rest/v1/currentConditions/lookup),
+[Air Quality authentication](https://developers.google.com/maps/documentation/air-quality/get-api-key),
+[Vision pricing](https://cloud.google.com/vision/pricing).
+
+Consumer Lens is investigated separately from Cloud Vision. Similar OCR or
+visual-search capabilities do not establish identical output, licensed data,
+throughput, model selection or paid API parity.