googlemaps-kit 0.1.0

package/dist/auth/session.js

@@ -0,0 +1,104 @@
+/**
+ * Session bootstrap for Google Maps internal APIs (raw HTTP, no browser).
+ *
+ * Follows the google.com → consent.google.com → maps cookie chain used by
+ * production scrapers to obtain NID/AEC session cookies.
+ */
+const USER_AGENTS = [
+    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/133.0.0.0 Safari/537.36',
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36',
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36',
+];
+export function randomUserAgent() {
+    return USER_AGENTS[Math.floor(Math.random() * USER_AGENTS.length)];
+}
+let cachedSession = null;
+function parseSetCookieHeader(setCookie) {
+    const part = setCookie.split(';')[0];
+    const eq = part?.indexOf('=');
+    if (!eq || eq <= 0)
+        return null;
+    return { name: part.slice(0, eq), value: part.slice(eq + 1) };
+}
+function mergeSetCookies(jar, headers) {
+    const setCookies = headers.getSetCookie?.() ?? [];
+    for (const raw of setCookies) {
+        const parsed = parseSetCookieHeader(raw);
+        if (parsed)
+            jar[parsed.name] = parsed.value;
+    }
+}
+export function cookiesToHeader(jar) {
+    return Object.entries(jar)
+        .map(([k, v]) => `${k}=${v}`)
+        .join('; ');
+}
+export function buildBrowserHeaders(options) {
+    const mode = options?.mode ?? 'cors';
+    const headers = {
+        'User-Agent': options?.userAgent ?? randomUserAgent(),
+        Accept: mode === 'document' ? 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8' : '*/*',
+        'Accept-Language': 'en-US,en;q=0.9',
+        'Accept-Encoding': 'gzip, deflate, br',
+        'Cache-Control': 'no-cache',
+        Pragma: 'no-cache',
+    };
+    if (mode === 'document') {
+        headers['Upgrade-Insecure-Requests'] = '1';
+        headers['Sec-Fetch-Dest'] = 'document';
+        headers['Sec-Fetch-Mode'] = 'navigate';
+        headers['Sec-Fetch-Site'] = 'none';
+        headers['Sec-Fetch-User'] = '?1';
+    }
+    else {
+        headers.Referer = options?.referer ?? 'https://www.google.com/maps/';
+        headers['Sec-Fetch-Dest'] = 'empty';
+        headers['Sec-Fetch-Mode'] = 'cors';
+        headers['Sec-Fetch-Site'] = 'same-origin';
+    }
+    if (options?.cookies) {
+        headers.Cookie =
+            typeof options.cookies === 'string' ? options.cookies : cookiesToHeader(options.cookies);
+    }
+    return headers;
+}
+/** Default SOCS consent cookie for anonymous Maps sessions. */
+export const DEFAULT_SOCS = 'CAISNQgEEitib3FfaWRlbnRpdHlmcm9udGVuZHVpc2VydmVyXzIwMjYwMTE4LjA5X3AwGgJlbiACGgYIgIu7ywY';
+/**
+ * Bootstrap cookies via the 3-step chain. Returns a cookie jar with NID when successful.
+ */
+export async function bootstrapSession(force = false, fetchImpl = fetch) {
+    if (!force && cachedSession && Date.now() - cachedSession.fetchedAt < 30 * 60 * 1000) {
+        return cachedSession;
+    }
+    const userAgent = randomUserAgent();
+    const jar = {
+        SOCS: DEFAULT_SOCS,
+        '__Secure-BUCKET': 'CGA',
+    };
+    const navHeaders = buildBrowserHeaders({ userAgent, mode: 'document' });
+    for (const url of [
+        'https://www.google.com/',
+        'https://consent.google.com/',
+        'https://www.google.com/maps',
+    ]) {
+        const response = await fetchImpl(url, {
+            headers: { ...navHeaders, Cookie: cookiesToHeader(jar) },
+            redirect: 'follow',
+        });
+        mergeSetCookies(jar, response.headers);
+    }
+    cachedSession = {
+        cookies: jar,
+        userAgent,
+        fetchedAt: Date.now(),
+    };
+    return cachedSession;
+}
+export function clearSessionCache() {
+    cachedSession = null;
+}
+export function getCachedSession() {
+    return cachedSession;
+}
+//# sourceMappingURL=session.js.map

package/dist/auth/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../src/auth/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,GAAG;IAClB,iHAAiH;IACjH,uHAAuH;IACvH,uHAAuH;CACxH,CAAC;AAEF,MAAM,UAAU,eAAe;IAC7B,OAAO,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAE,CAAC;AACtE,CAAC;AAQD,IAAI,aAAa,GAA0B,IAAI,CAAC;AAEhD,SAAS,oBAAoB,CAAC,SAAiB;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,EAAE,IAAI,EAAE,IAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,IAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,GAA2B,EAAE,OAAgB;IACpE,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC;IAClD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,MAAM;YAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAA2B;IACzD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;SACvB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;SAC5B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAKnC;IACC,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,MAAM,CAAC;IACrC,MAAM,OAAO,GAA2B;QACtC,YAAY,EAAE,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE;QACrD,MAAM,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,iEAAiE,CAAC,CAAC,CAAC,KAAK;QACvG,iBAAiB,EAAE,gBAAgB;QACnC,iBAAiB,EAAE,mBAAmB;QACtC,eAAe,EAAE,UAAU;QAC3B,MAAM,EAAE,UAAU;KACnB,CAAC;IAEF,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,CAAC,2BAA2B,CAAC,GAAG,GAAG,CAAC;QAC3C,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAAC;QACvC,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAAC;QACvC,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC;QACnC,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,8BAA8B,CAAC;QACrE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC;QACpC,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC;QACnC,OAAO,CAAC,gBAAgB,CAAC,GAAG,aAAa,CAAC;IAC5C,CAAC;IAED,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM;YACZ,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7F,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,YAAY,GACvB,yFAAyF,CAAC;AAE5F;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAK,GAAG,KAAK,EACb,YAA0B,KAAK;IAE/B,IAAI,CAAC,KAAK,IAAI,aAAa,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACrF,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,MAAM,GAAG,GAA2B;QAClC,IAAI,EAAE,YAAY;QAClB,iBAAiB,EAAE,KAAK;KACzB,CAAC;IAEF,MAAM,UAAU,GAAG,mBAAmB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAExE,KAAK,MAAM,GAAG,IAAI;QAChB,yBAAyB;QACzB,6BAA6B;QAC7B,6BAA6B;KAC9B,EAAE,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;YACpC,OAAO,EAAE,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,EAAE;YACxD,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;QACH,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,aAAa,GAAG;QACd,OAAO,EAAE,GAAG;QACZ,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACtB,CAAC;IAEF,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/client/gmaps-client.d.ts

@@ -0,0 +1,92 @@
+import { GMapsRpcClient } from '../rpc/rpc-client.js';
+import { BatchUrlService } from '../services/batch-url.js';
+import { CategoriesService } from '../services/categories.js';
+import { DirectionsService } from '../services/directions.js';
+import { DistanceMatrixService } from '../services/distance-matrix.js';
+import { ElevationService } from '../services/elevation.js';
+import { GeocodeService } from '../services/geocode.js';
+import { KnowledgeService } from '../services/knowledge.js';
+import { LinksService } from '../services/links.js';
+import { ListsService } from '../services/lists.js';
+import { LocalPostsService } from '../services/local-posts.js';
+import { PanoramaService } from '../services/panorama.js';
+import { PhotosService } from '../services/photos.js';
+import { PassiveAssistService } from '../services/passiveassist.js';
+import { PlacesService } from '../services/places.js';
+import { ReviewsService } from '../services/reviews.js';
+import { RevealService } from '../services/reveal.js';
+import { SearchService } from '../services/search.js';
+import { StaticMapService } from '../services/static-map.js';
+import { SuggestService } from '../services/suggest.js';
+import { TilesService } from '../services/tiles.js';
+import { TimezoneService } from '../services/timezone.js';
+import { TrafficService } from '../services/traffic.js';
+import { TransitService } from '../services/transit.js';
+import { UgcAggregatesService } from '../services/ugc-aggregates.js';
+import type { DirectionsOptions, DirectionsResult, EnrichedSearchResult, GetPlaceCompleteOptions, GetPlaceFullOptions, GMapsConfig, PlaceCompleteResult, PlaceFullResult, SearchOptions } from '../types/common.js';
+export interface EnrichSearchOptions extends SearchOptions {
+    /**
+     * Prefer search-row fields only (Places Text Search Enterprise parity in 1 RPC).
+     * When true, skips place-preview round-trips unless includeReviews is also set.
+     */
+    fromSearchOnly?: boolean;
+    /** Fetch full place details for each result (gallery-scale photos, stub-retry). */
+    includeDetails?: boolean;
+    /** Fetch reviews for each result */
+    includeReviews?: boolean;
+    /** Max Boq review pages per place when includeReviews is true */
+    maxReviewPages?: number;
+    /** Max parallel enrichment requests (default 10) */
+    concurrency?: number;
+}
+/**
+ * Main Google Maps SDK client.
+ */
+export declare class GMapsClient {
+    readonly search: SearchService;
+    readonly places: PlacesService;
+    readonly reviews: ReviewsService;
+    readonly reveal: RevealService;
+    readonly passiveAssist: PassiveAssistService;
+    readonly localPosts: LocalPostsService;
+    readonly knowledge: KnowledgeService;
+    readonly directions: DirectionsService;
+    readonly suggest: SuggestService;
+    readonly panorama: PanoramaService;
+    readonly tiles: TilesService;
+    readonly lists: ListsService;
+    readonly photos: PhotosService;
+    readonly links: LinksService;
+    readonly traffic: TrafficService;
+    readonly transit: TransitService;
+    readonly categories: CategoriesService;
+    readonly ugcAggregates: UgcAggregatesService;
+    readonly batchUrl: BatchUrlService;
+    readonly distanceMatrix: DistanceMatrixService;
+    readonly elevation: ElevationService;
+    readonly timezone: TimezoneService;
+    readonly staticMap: StaticMapService;
+    readonly geocode: GeocodeService;
+    private http;
+    private config;
+    private rpcClient;
+    private rpcInitPromise;
+    private runtimePromise;
+    constructor(config?: GMapsConfig);
+    rpc(): Promise<GMapsRpcClient>;
+    features(): Promise<import('../rpc/feature-rpc.js').FeatureRpcService>;
+    runtime(): Promise<import('../rpc/maps-runtime.js').MapsRuntime>;
+    getPlaceFull(options: GetPlaceFullOptions): Promise<PlaceFullResult>;
+    /**
+     * Fetch maximum available place data: rich preview, paginated Boq reviews,
+     * local posts, and knowledge entity (when available).
+     */
+    getPlaceComplete(options: GetPlaceCompleteOptions): Promise<PlaceCompleteResult>;
+    getDirections(options: DirectionsOptions): Promise<DirectionsResult>;
+    /** Request/session counters for harness scripts (no secrets). */
+    getHttpStats(): import("../client/http-client.js").HttpClientStats;
+    searchEnriched(options: EnrichSearchOptions): Promise<EnrichedSearchResult[]>;
+    private enrichSingle;
+}
+export declare function createGMapsClient(config?: GMapsConfig): GMapsClient;
+//# sourceMappingURL=gmaps-client.d.ts.map

package/dist/client/gmaps-client.d.ts.map

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

package/dist/client/gmaps-client.js

@@ -0,0 +1,254 @@
+import { HttpClient } from '../client/http-client.js';
+import { loadProjectEnv } from '../utils/load-env.js';
+import { GMapsRpcClient } from '../rpc/rpc-client.js';
+import { BatchUrlService } from '../services/batch-url.js';
+import { CategoriesService } from '../services/categories.js';
+import { DirectionsService } from '../services/directions.js';
+import { DistanceMatrixService } from '../services/distance-matrix.js';
+import { ElevationService } from '../services/elevation.js';
+import { GeocodeService } from '../services/geocode.js';
+import { KnowledgeService } from '../services/knowledge.js';
+import { LinksService } from '../services/links.js';
+import { ListsService } from '../services/lists.js';
+import { LocalPostsService } from '../services/local-posts.js';
+import { PanoramaService } from '../services/panorama.js';
+import { PhotosService } from '../services/photos.js';
+import { PassiveAssistService } from '../services/passiveassist.js';
+import { PlacesService } from '../services/places.js';
+import { ReviewsService } from '../services/reviews.js';
+import { RevealService } from '../services/reveal.js';
+import { SearchService, searchResultToPlaceDetails } from '../services/search.js';
+import { StaticMapService } from '../services/static-map.js';
+import { SuggestService } from '../services/suggest.js';
+import { TilesService } from '../services/tiles.js';
+import { TimezoneService } from '../services/timezone.js';
+import { TrafficService } from '../services/traffic.js';
+import { TransitService } from '../services/transit.js';
+import { UgcAggregatesService } from '../services/ugc-aggregates.js';
+loadProjectEnv();
+/**
+ * Main Google Maps SDK client.
+ */
+export class GMapsClient {
+    search;
+    places;
+    reviews;
+    reveal;
+    passiveAssist;
+    localPosts;
+    knowledge;
+    directions;
+    suggest;
+    panorama;
+    tiles;
+    lists;
+    photos;
+    links;
+    traffic;
+    transit;
+    categories;
+    ugcAggregates;
+    batchUrl;
+    distanceMatrix;
+    elevation;
+    timezone;
+    staticMap;
+    geocode;
+    http;
+    config;
+    rpcClient = null;
+    rpcInitPromise = null;
+    runtimePromise = null;
+    constructor(config = {}) {
+        this.config = {
+            hl: config.hl ?? process.env.GMAPS_HL ?? 'en',
+            gl: config.gl ?? process.env.GMAPS_GL ?? 'us',
+            buildLabel: config.buildLabel ?? process.env.GMAPS_BUILD_LABEL,
+            sessionId: config.sessionId ?? process.env.GMAPS_SESSION_ID,
+            debug: config.debug ?? false,
+            maxRetries: config.maxRetries ?? 2,
+            retryDelay: config.retryDelay ?? 500,
+            retryMaxDelay: config.retryMaxDelay ?? 30_000,
+            requestDelayMs: config.requestDelayMs ?? Number(process.env.GMAPS_REQUEST_DELAY_MS ?? 0),
+            concurrency: config.concurrency ?? Number(process.env.GMAPS_CONCURRENCY ?? 6),
+        };
+        this.http = new HttpClient({ config: this.config });
+        this.search = new SearchService(this.http, this.config);
+        this.places = new PlacesService(this.http, this.config);
+        this.reviews = new ReviewsService(this.http, this.config);
+        this.reveal = new RevealService(this.http, this.config);
+        this.passiveAssist = new PassiveAssistService(this.http, this.config);
+        this.localPosts = new LocalPostsService(this.http, this.config);
+        this.knowledge = new KnowledgeService(this.http, this.config);
+        this.directions = new DirectionsService(this.http, this.config);
+        this.suggest = new SuggestService(this.http, this.config);
+        this.panorama = new PanoramaService(this.http, this.config);
+        this.tiles = new TilesService(this.http, this.config);
+        this.lists = new ListsService(this.http, this.config);
+        this.photos = new PhotosService(this.http, this.config);
+        this.links = new LinksService(this.http, this.config);
+        this.traffic = new TrafficService(this.http, this.config);
+        this.transit = new TransitService(this.http, this.config);
+        this.categories = new CategoriesService(this.http, this.config);
+        this.ugcAggregates = new UgcAggregatesService(this.http, this.config);
+        this.batchUrl = new BatchUrlService(this.http, this.config);
+        this.geocode = new GeocodeService(this.http, this.config);
+        this.distanceMatrix = new DistanceMatrixService(this.directions, this.config);
+        this.elevation = new ElevationService(this.http, this.directions, this.config);
+        this.timezone = new TimezoneService(this.geocode, this.config);
+        this.staticMap = new StaticMapService(this.http, this.config);
+    }
+    async rpc() {
+        if (this.rpcClient) {
+            return this.rpcClient;
+        }
+        if (!this.rpcInitPromise) {
+            this.rpcInitPromise = GMapsRpcClient.fromHttpSession(this.http.getCookieJar(), this.http.getUserAgent(), this.config, (fn) => this.http.runScheduled(fn)).then((client) => {
+                this.rpcClient = client;
+                return client;
+            });
+        }
+        return this.rpcInitPromise;
+    }
+    async features() {
+        const { createFeatureRpcService } = await import('../rpc/feature-rpc.js');
+        return createFeatureRpcService(await this.rpc());
+    }
+    async runtime() {
+        if (!this.runtimePromise) {
+            const { MapsRuntime } = await import('../rpc/maps-runtime.js');
+            this.runtimePromise = MapsRuntime.bootstrap(this.config);
+        }
+        return this.runtimePromise;
+    }
+    async getPlaceFull(options) {
+        return this.places.getFull(options, this.reviews);
+    }
+    /**
+     * Fetch maximum available place data: rich preview, paginated Boq reviews,
+     * local posts, and knowledge entity (when available).
+     */
+    async getPlaceComplete(options) {
+        const includeKnowledge = options.includeKnowledge !== false;
+        const maxReviewPages = options.maxReviewPages ?? 3;
+        const full = await this.getPlaceFull({
+            ...options,
+            maxReviewPages,
+            richPreview: options.richPreview === true,
+            includeLocalPosts: options.includeLocalPosts !== false,
+        });
+        let knowledge;
+        if (includeKnowledge) {
+            const start = performance.now();
+            const entity = await this.knowledge.get({
+                hexId: options.hexId,
+                ftid: options.ftid,
+                placeId: full.details.placeId,
+                fallbackDetails: full.details,
+            });
+            full.meta.timingMs = full.meta.timingMs ?? {};
+            full.meta.timingMs.knowledge = performance.now() - start;
+            full.meta.sources.knowledge = entity != null;
+            knowledge = entity ?? undefined;
+        }
+        return { ...full, knowledge };
+    }
+    async getDirections(options) {
+        return this.directions.get(options);
+    }
+    /** Request/session counters for harness scripts (no secrets). */
+    getHttpStats() {
+        return this.http.getStats();
+    }
+    async searchEnriched(options) {
+        const results = await this.search.search(options);
+        // Official Text Search Enterprise parity: one RPC, details lifted from the search row.
+        if (options.fromSearchOnly || (!options.includeDetails && !options.includeReviews)) {
+            return results.map((result) => ({
+                ...result,
+                details: searchResultToPlaceDetails(result),
+            }));
+        }
+        const concurrency = options.concurrency ?? 10;
+        const enriched = [];
+        for (let i = 0; i < results.length; i += concurrency) {
+            const chunk = results.slice(i, i + concurrency);
+            const batch = await Promise.all(chunk.map((result) => this.enrichSingle(result, options)));
+            enriched.push(...batch);
+        }
+        return enriched;
+    }
+    async enrichSingle(result, options) {
+        const enriched = {
+            ...result,
+            // Always keep search-row details as a non-lossy base; place preview may truncate.
+            details: searchResultToPlaceDetails(result),
+        };
+        if (!result.hexId || !result.name) {
+            return enriched;
+        }
+        const lat = result.latitude ?? options.location.lat;
+        const lng = result.longitude ?? options.location.lng;
+        if (options.includeDetails && options.includeReviews) {
+            const full = await this.getPlaceFull({
+                hexId: result.hexId,
+                name: result.name,
+                lat,
+                lng,
+                ftid: result.ftid,
+                maxReviewPages: options.maxReviewPages ?? 1,
+            });
+            enriched.details = {
+                ...enriched.details,
+                ...full.details,
+                // Prefer preview photos when present; fall back to search thumbnail.
+                photos: full.details.photos && full.details.photos.length > 0
+                    ? full.details.photos
+                    : enriched.details?.photos,
+                reviewCount: full.details.reviewCount ?? enriched.details?.reviewCount,
+                phone: full.details.phone ?? enriched.details?.phone,
+                openStatus: full.details.openStatus ?? enriched.details?.openStatus,
+                openingSchedule: full.details.openingSchedule ?? enriched.details?.openingSchedule,
+            };
+            enriched.reviews = full.reviews;
+            enriched.localPosts = full.localPosts;
+            return enriched;
+        }
+        if (options.includeDetails) {
+            const preview = await this.places.get({
+                hexId: result.hexId,
+                name: result.name,
+                lat,
+                lng,
+                ftid: result.ftid,
+                mode: 'live',
+            });
+            enriched.details = {
+                ...enriched.details,
+                ...preview,
+                photos: preview.photos && preview.photos.length > 0
+                    ? preview.photos
+                    : enriched.details?.photos,
+                reviewCount: preview.reviewCount ?? enriched.details?.reviewCount,
+                phone: preview.phone ?? enriched.details?.phone,
+                openStatus: preview.openStatus ?? enriched.details?.openStatus,
+                openingSchedule: preview.openingSchedule ?? enriched.details?.openingSchedule,
+            };
+        }
+        if (options.includeReviews) {
+            enriched.reviews = await this.reviews.list({
+                hexId: result.hexId,
+                name: result.name,
+                lat,
+                lng,
+                ftid: result.ftid,
+                limit: 10,
+            });
+        }
+        return enriched;
+    }
+}
+export function createGMapsClient(config) {
+    return new GMapsClient(config);
+}
+//# sourceMappingURL=gmaps-client.js.map

package/dist/client/gmaps-client.js.map

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

package/dist/client/http-client.d.ts

@@ -0,0 +1,91 @@
+import { type GMapsConfig } from '../types/common.js';
+export interface HttpGetOptions {
+    referer?: string;
+    extraHeaders?: Record<string, string>;
+    includeOrigin?: boolean;
+    /** Attach SAPISIDHASH auth headers (for listugcposts). */
+    authenticated?: boolean;
+    /** Skip JSON parse — return raw text. */
+    raw?: boolean;
+    /** Relax body length check (for small review stubs). */
+    allowShortBody?: boolean;
+    /** Minimum byte length for {@link HttpClient.getBytes} (default 8). */
+    minBytes?: number;
+    /** Disable automatic retries (use for endpoints that fail fast with 4xx). */
+    noRetry?: boolean;
+    /**
+     * Reject a successfully parsed response so it is retried with a refreshed session.
+     *
+     * Google intermittently serves a truncated place payload (~26 KB instead of ~130 KB)
+     * that parses fine but omits hours, amenities and review counts. Returning false lets
+     * the caller demand a complete one.
+     */
+    acceptResponse?: (data: unknown) => boolean;
+    /**
+     * When set, HTTP 200 payloads classified as empty/auth-stub raise
+     * {@link GMapsEmptyPayloadError} instead of returning silently.
+     */
+    rejectEmptyPayload?: boolean;
+}
+export interface HttpClientOptions {
+    config: GMapsConfig;
+}
+export interface HttpClientStats {
+    /** Completed data requests (get / getBytes). */
+    requestCount: number;
+    /** Session bootstrap calls (anonymous warming only). */
+    sessionWarmCount: number;
+    /** In-flight + completed scheduler slots. */
+    scheduledCount: number;
+}
+export declare class HttpClient {
+    private config;
+    private cookieJar;
+    private readonly suppliedCookies;
+    private sessionUserAgent?;
+    private sessionFetchedAt;
+    private requestCount;
+    private sessionWarmCount;
+    private scheduler;
+    constructor(options: HttpClientOptions);
+    get<T = unknown>(url: string, options?: HttpGetOptions): Promise<T>;
+    private getInternal;
+    getBytes(url: string, options?: HttpGetOptions): Promise<{
+        bytes: Uint8Array;
+        contentType: string;
+    }>;
+    private getBytesInternal;
+    /**
+     * Session cookie jar for outbound Google requests.
+     *
+     * **Security:** values are secrets (SID/SAPISID). Do not log, serialize to clients,
+     * or include in error reports. Prefer {@link listCookieNames} / `auth.getStatus()`.
+     */
+    getCookieJar(): Record<string, string>;
+    /**
+     * Cookie **names** only — safe for logs / auth status. Never returns values.
+     */
+    listCookieNames(): string[];
+    /**
+     * Run an externally-issued request under this client's pacing and request counter.
+     *
+     * The batchexecute RPC client owns its own `fetch` (it needs a bespoke body and token
+     * handling), so without this it would escape `requestDelayMs`/`concurrency` and go
+     * unrecorded in `getStats()` — measured as 0 requests for five live surfaces.
+     */
+    runScheduled<T>(fn: () => Promise<T>): Promise<T>;
+    getConfiguredAuthToken(): string | undefined;
+    getStats(): HttpClientStats;
+    /** @deprecated Use getStats().requestCount */
+    getRequestCount(): number;
+    warmSession(): Promise<void>;
+    getUserAgent(): string;
+    hasAuthCookies(): boolean;
+    hasSuppliedCookies(): boolean;
+    private ensureSession;
+    private mergeResponseCookies;
+    private parseCookieString;
+    private emptyPayloadError;
+    private sleep;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/client/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/client/http-client.ts"],"names":[],"mappings":"AAQA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,oBAAoB,CAAC;AAqB5B,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC;IAC5C;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,SAAS,CAAmB;gBAExB,OAAO,EAAE,iBAAiB;IAchC,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAI3D,WAAW;IA8InB,QAAQ,CACZ,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;YAIxC,gBAAgB;IAsH9B;;;;;OAKG;IACH,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAItC;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;;;;;OAMG;IACG,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOvD,sBAAsB,IAAI,MAAM,GAAG,SAAS;IAI5C,QAAQ,IAAI,eAAe;IAQ3B,8CAA8C;IAC9C,eAAe,IAAI,MAAM;IAInB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,YAAY,IAAI,MAAM;IAItB,cAAc,IAAI,OAAO;IAQzB,kBAAkB,IAAI,OAAO;YAIf,aAAa;IA2B3B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,iBAAiB;IAYzB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,KAAK;CAGd"}