googlemaps-kit 0.5.0 → 0.7.0

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.

package/docs/finance-research.md

@@ -0,0 +1,153 @@
+# Google Finance consumer client
+
+Investigated and verified on **2026-10-29**, build
+`boq_finhub-uiserver_20261026.07_p0`. This client implements the public consumer
+quote, instrument-suggestion, and sampled-price chart surfaces. It does not
+claim to reproduce all of Google Finance, provide a licensed market-data feed,
+or expose paid/AI research features.
+
+```ts
+import { finance } from 'googlemaps-kit/finance';
+
+const client = finance();
+const quote = await client.quote('GOOGL:NASDAQ');
+const suggestions = await client.search('Microsoft');
+const chart = await client.chart('GOOGL:NASDAQ', { range: '1M' });
+
+console.log(quote.price, quote.currency, quote.time);
+console.log(quote.extendedMarket);
+console.log(suggestions.matches);
+console.log(chart.sessions.flatMap(session => session.points));
+```
+
+Instrument strings use **symbol:exchange** order, as Google Finance URLs do.
+Objects `{ symbol: 'GOOGL', exchange: 'NASDAQ' }` are also accepted. `search`
+returns identifiable instrument suggestions, deduplicating repeated UI groups;
+it does not return an arbitrary natural-language or AI answer.
+
+Configuration supports `fetch`, `timeoutMs`, `language`, and `userAgent`.
+Methods accept an `AbortSignal`. Requests have a body-read deadline and do not
+automatically retry a block or failure. `FinanceError` exports the shared
+`GoogleWebError` class with `kind`, optional HTTP `status`, `rpcCode`, and
+`retryAfterMs`. Rate-limit/automated-query responses remain errors.
+
+## Runtime and static evidence
+
+- Ordinary headless Chromium rendered a complete GOOGL quote page. A generic
+  non-browser user agent had previously received an unsupported-client page.
+  The client therefore uses the exact captured browser user-agent family for
+  device negotiation; users may override it. Runtime browser evidence:
+  `ev_8b8ce4e3adf9f17541b4db84cde49b10828e312435ad8735c6596efac93c2ccd`.
+- REA analyzed **66 observed scripts**, providing static descriptors and field
+  access evidence:
+  `ev_681d6f6b8601b800f9884383e2c34fd76024911ff6b8305bd91f61b0f7c97950`.
+  Static analysis does not establish endpoint execution; direct HTTP replay
+  below supplies the runtime verification.
+- Direct anonymous HTTP replay returned 200 with real data for quote summary,
+  search suggestions, pricing details, and all eight chart ranges. No API key
+  or signed-in cookies were supplied. The complete client also passed an
+  opted-in live test for quote, search, and monthly chart.
+- Original runtime HTML, requests, responses, and scripts remain in untracked
+  scratch storage. Offline tests use copied public-data payloads under
+  `tests/fixtures/finance/`; shipped code has no dependency on scratch files.
+
+## Verified protocol
+
+Bootstrap `https://www.google.com/finance/?hl=en` and read `WIZ_global_data`:
+`eptZe=/finance/_/FinHubUi/`, `FdrFJe` session, and `cfb2h` build. Calls POST
+form-encoded `f.req` to
+`https://www.google.com/finance/_/FinHubUi/data/batchexecute`, passing `rpcids`,
+`source-path`, `f.sid`, `bl`, `hl`, and `rt=c`. Responses contain XSSI-prefixed,
+framed `wrb.fr` JSON payloads. Captured anonymous requests omitted `at`.
+
+| RPC | Shipped descriptor | Verified arguments | Client method |
+| --- | --- | --- | --- |
+| `gCvqoe` | `/FinanceHubService.ListEntitySummary` | `[[[null,[symbol,exchange]]]]` | `quote` |
+| `XB3kn` | `/FinanceHubService.GetSearchSuggestions` | `[query,null,1]` | `search` |
+| `c2u4wc` | `/FinanceHubService.ListHistoricalPricingData` | `[[[null,[symbol,exchange]]],rangeEnum]` | `chart` |
+| `dlNq8b` | Pricing-detail surface | `[[[null,[symbol,exchange]]],1,1,1]` | Captured and replayed; not exposed by this client |
+
+Browser traffic also registered and sometimes executed earnings/research RPCs,
+including `Xs5i3b` (GetEarningsTranscriptHighlights), `Iaiw6c` (GetEarningsFiles),
+and `TNo8E` (GetRelatedEarnings). Those are not the quote/search endpoints and
+are not part of the public SDK contract. No claim of paid research parity is
+made from their presence in a bundle.
+
+### Quote fields
+
+`gCvqoe` response field 1 is repeated EntitySummary; each entry's field 1 is a
+security node. The following are one-based security field numbers:
+
+| Field | Meaning established by capture and renderer |
+| --- | --- |
+| 1 | Entity ID |
+| 2 | `[symbol,exchange]` |
+| 3 | Display name |
+| 5 | Currency |
+| 6 | Regular price tuple `[price,change,changePercent,...]` |
+| 8 | Previous close |
+| 12 | Reported data timestamp `[seconds,nanos]` |
+| 13 | Exchange time-zone name |
+| 14 | UTC offset seconds |
+| 17 | Extended-session price tuple |
+| 18 | Regular price timestamp |
+| 19 | Extended-session price timestamp |
+| 25 | Source enum; returned as an opaque code when present |
+
+The successful GOOGL capture contained regular price **324.89 USD** and
+extended price **292.50 USD**. These are fixture observations, not current
+recommendations or promised live prices. The parser keeps them separate and
+preserves zero prices/changes and original precision.
+
+`reportedTime`, `time`, and `extendedMarket.time` are distinct source values.
+The payload does not establish a guaranteed delay interval, so `delayStatus`
+is `not-disclosed`; the SDK does not label every quote real-time. Some exchanges
+or instruments can be delayed, missing, or unsupported. See Google's
+[Finance data disclaimer](https://www.google.com/googlefinance/disclaimer/) and
+[GOOGLEFINANCE limitations](https://support.google.com/docs/answer/3093281?hl=en).
+The Sheets function and this consumer web transport are separate interfaces.
+
+### Historical charts
+
+The UI's range enum is statically explicit and each range was replayed
+successfully for GOOGL:
+
+| Range | Enum | Observed interval seconds | Observed points |
+| --- | --- | --- | --- |
+| `1D` | 1 | 60 | 632 across regular and extended sessions |
+| `5D` | 2 | 1800 | 70 |
+| `1M` | 3 | 86400 | 23 |
+| `6M` | 4 | 86400 | 128 |
+| `YTD` | 5 | 86400 | 209 |
+| `1Y` | 6 | 86400 | 252 |
+| `5Y` | 7 | 604800 | 262 |
+| `MAX` | 8 | 604800 | 1159 |
+
+These intervals/counts describe the captured responses and may vary. `MAX`
+does not imply a complete daily trading history. The response's field 4 groups
+session headers and points. Each point is `[DateTime,priceTuple,volume]`.
+DateTime months are one-based, and field 8 contains a UTC-offset message;
+converting to ISO time must apply that offset rather than the execution host's
+time zone. Session codes remain numeric: `1` and `3` were observed for regular
+and extended data in the day capture.
+
+Only verified price, time, and volume are normalized for chart points. Other
+price-tuple values vary with the selected chart baseline and remain available
+in `raw`, avoiding an incorrect “percent change” interpretation.
+
+## Validation and limits
+
+Sixteen offline unit tests cover captured layouts, duplicate suggestions,
+regular/extended separation, zero values, UTC offsets, malformed/missing data,
+the request envelope, blocking, cancellation, and local validation.
+
+```sh
+npx vitest run tests/unit/finance
+GMAPS_LIVE=1 FINANCE_LIVE=1 npx vitest run tests/live/finance.test.ts
+npm run type-check
+```
+
+All passed during implementation. Live tests require explicit opt-in and are
+excluded from the ordinary unit suite. Authentication-gated portfolios,
+watchlists, premium research, AI generation, and undocumented tuple fields
+remain outside this client's verified scope.

package/docs/finance.md

@@ -0,0 +1,43 @@
+# Google Finance
+
+```ts
+import { finance } from 'googlemaps-kit/finance';
+
+const market = finance();
+const quote = await market.quote('GOOGL:NASDAQ');
+console.log(quote.name, quote.price, quote.currency, quote.time);
+console.log(quote.extendedMarket);
+
+const matches = await market.search('Microsoft');
+const chart = await market.chart('GOOGL:NASDAQ', { range: '1M' });
+console.log(matches.matches, chart.sessions);
+```
+
+Instrument strings use `symbol:exchange`, matching the website's quote URL.
+Objects `{ symbol, exchange }` are also accepted. Charts support `1D`, `5D`,
+`1M`, `6M`, `YTD`, `1Y`, `5Y`, and `MAX`. Their sampling interval and available
+session groups come from Google, not a locally reconstructed price history.
+
+Quote results separate regular and extended-session prices and timestamps.
+They also preserve currency, previous close, source-reported time, exchange
+timezone and UTC offset where returned. `delayStatus` is `not-disclosed`;
+the client does not infer that a quote is real-time. Raw positional payloads
+remain available on all results.
+
+Configuration accepts `fetch`, `timeoutMs` (default 30 seconds), `language`
+(default `en`) and `userAgent`. The default user agent is the ordinary browser
+used for the successful capture, because Google served an unsupported-device
+page to a generic HTTP client. All methods accept `signal`; requests are not
+automatically retried. `FinanceError` exposes `kind`, HTTP `status`, RPC code
+and `retryAfterMs` where available. A captured missing-instrument status is
+reported with RPC code 5.
+
+This is a public quote/search/chart interface, with no API key or browser
+runtime dependency. It does not implement portfolios, account operations,
+AI investment answers, every asset type, fundamentals or exchange-data
+licensing. See Google's [data information](https://www.google.com/googlefinance/disclaimer/)
+and the [protocol research](finance-research.md) for exact contracts, live
+evidence and remaining limits.
+
+Run all public-client probes with `npm run test:google-public:live` or Finance
+alone with `GMAPS_LIVE=1 FINANCE_LIVE=1 npx vitest run tests/live/finance.test.ts`.