googlemaps-kit 0.1.0

package/dist/services/places.js

@@ -0,0 +1,240 @@
+import { extractLocalPosts } from '../parsers/local-posts.js';
+import { extractEmbeddedReviews, extractPhotosDeep, extractPlaceDetails, } from '../parsers/place.js';
+import { buildLocalPostsUrl, buildPlaceUrl } from '../rpc/pb-builders.js';
+import { dedupePhotos } from '../utils/photo-url.js';
+/**
+ * Detect the truncated place payload Google intermittently serves.
+ *
+ * Measured over repeated identical requests, responses come in two sizes: ~26 KB with
+ * one day of hours, 5 amenities and no review count, or ~130 KB with 7 days, 40
+ * amenities, the real review count and review snippets. A place that has a rating must
+ * also have a review count, so their disagreement identifies the short variant without
+ * penalising genuinely sparse listings.
+ */
+function isCompletePlacePayload(data) {
+    const details = extractPlaceDetails(data);
+    if (details.rating == null)
+        return true;
+    return details.reviewCount != null;
+}
+export class PlacesService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /** Fetch raw place preview JSON (single HTTP round-trip). */
+    async fetchPreview(options) {
+        const requested = options.mode ?? 'live';
+        // buildPlaceUrl already falls back to live when coords/name are missing for detail/rich.
+        const mode = requested;
+        const url = buildPlaceUrl({
+            hexId: options.hexId,
+            name: options.name,
+            lat: options.lat,
+            lng: options.lng,
+            ftid: options.ftid,
+            hl: this.hl,
+            gl: this.gl,
+            mode,
+            psi: options.psi,
+        });
+        const start = performance.now();
+        const referer = options.name
+            ? `https://www.google.com/maps/place/${options.name.replace(/ /g, '+')}/`
+            : 'https://www.google.com/maps/';
+        const data = await this.http.get(url, {
+            referer,
+            includeOrigin: true,
+            acceptResponse: options.skipIncompleteRetry ? undefined : isCompletePlacePayload,
+        });
+        return {
+            data,
+            mode,
+            timingMs: performance.now() - start,
+        };
+    }
+    /** Parse place details from an already-fetched preview response. */
+    parsePreview(data, overrides) {
+        const details = extractPlaceDetails(data);
+        if (overrides?.hexId)
+            details.hexId = details.hexId ?? overrides.hexId;
+        if (overrides?.ftid)
+            details.ftid = details.ftid ?? overrides.ftid;
+        details.photos = dedupePhotos(extractPhotosDeep(data, 50));
+        return details;
+    }
+    async get(options) {
+        const preview = await this.fetchPreview(options);
+        return this.parsePreview(preview.data, options);
+    }
+    async getMany(places, concurrency = 10) {
+        const results = [];
+        for (let i = 0; i < places.length; i += concurrency) {
+            const chunk = places.slice(i, i + concurrency);
+            const batch = await Promise.all(chunk.map((p) => this.get(p)));
+            results.push(...batch);
+        }
+        return results;
+    }
+    /**
+     * End-to-end place profile: one preview fetch + Boq reviews + optional local posts.
+     * Defaults to `live` preview (~350 ms p50) — pass `richPreview: true` only when you
+     * need the richer pb template. Pass `reviewsService` to avoid circular imports.
+     */
+    async getFull(options, reviewsService) {
+        const totalStart = performance.now();
+        const richPreview = options.richPreview === true;
+        const includeLocalPosts = options.includeLocalPosts !== false;
+        const meta = {
+            fetchedAt: new Date().toISOString(),
+            previewMode: richPreview ? 'rich' : 'live',
+            sources: {
+                preview: false,
+                reviewsBoq: false,
+                reviewsEmbedded: false,
+                reviewsRpc: false,
+                localPosts: false,
+            },
+            timingMs: {},
+        };
+        const placeOpts = {
+            hexId: options.hexId,
+            name: options.name,
+            lat: options.lat,
+            lng: options.lng,
+            ftid: options.ftid,
+            mode: richPreview ? 'rich' : 'live',
+            skipIncompleteRetry: options.skipIncompleteRetry,
+        };
+        const localPostsPromise = includeLocalPosts
+            ? this.fetchLocalPosts(options).then((result) => {
+                meta.timingMs.localPosts = result.timingMs;
+                meta.sources.localPosts = result.posts.length > 0;
+                return result.posts;
+            })
+            : Promise.resolve(undefined);
+        // Boq reviews only need hexId — run in parallel with preview (saves ~180–400 ms).
+        const reviewsStart = performance.now();
+        const reviewsPromise = this.fetchReviewsBoqOnly(options, reviewsService).then((reviews) => {
+            meta.timingMs.reviews = performance.now() - reviewsStart;
+            return reviews;
+        });
+        const [preview, reviewsBoq] = await Promise.all([
+            this.fetchPreview(placeOpts),
+            reviewsPromise,
+        ]);
+        meta.sources.preview = true;
+        meta.previewMode = preview.mode;
+        meta.timingMs.preview = preview.timingMs;
+        const details = this.parsePreview(preview.data, placeOpts);
+        const embedded = extractEmbeddedReviews(Array.isArray(preview.data[6])
+            ? preview.data[6]
+            : []);
+        if (embedded.length > 0) {
+            meta.sources.reviewsEmbedded = true;
+            if (!details.reviewSnippets?.length) {
+                details.reviewSnippets = embedded;
+            }
+        }
+        let reviews = reviewsBoq;
+        if (reviews.reviews.length === 0) {
+            const embeddedStart = performance.now();
+            reviews = await reviewsService.listEmbeddedFromPreview(preview.data, {
+                hexId: options.hexId,
+                name: options.name,
+                lat: options.lat,
+                lng: options.lng,
+                ftid: options.ftid,
+                limit: options.reviewLimit ?? 10,
+                sort: options.reviewSort,
+            });
+            meta.timingMs.reviews = (meta.timingMs.reviews ?? 0) + (performance.now() - embeddedStart);
+        }
+        meta.sources.reviewsBoq = reviews.reviews.some((r) => r.source === 'boq');
+        meta.sources.reviewsRpc = reviews.reviews.some((r) => r.source === 'rpc');
+        details.photos = this.mergePhotoSources(details.photos ?? [], reviews.reviews, preview.data);
+        if (!details.reviewCount) {
+            details.reviewCount = reviews.totalReviews ?? details.reviewSnippets?.length;
+        }
+        if (reviews.totalReviews == null && details.reviewCount) {
+            reviews.totalReviews = details.reviewCount;
+        }
+        const localPosts = await localPostsPromise;
+        meta.timingMs.total = performance.now() - totalStart;
+        return {
+            details,
+            reviews,
+            localPosts,
+            meta,
+        };
+    }
+    async fetchReviewsBoqOnly(options, reviewsService) {
+        const maxPages = options.maxReviewPages ?? 1;
+        const reviewOpts = {
+            hexId: options.hexId,
+            name: options.name,
+            lat: options.lat,
+            lng: options.lng,
+            ftid: options.ftid,
+            limit: options.reviewLimit ?? 10,
+            sort: options.reviewSort,
+        };
+        if (maxPages <= 1) {
+            return reviewsService.listBoq(reviewOpts);
+        }
+        return reviewsService.listAll({
+            ...reviewOpts,
+            maxPages,
+        });
+    }
+    async fetchReviewsForPlace(options, reviewsService, previewData) {
+        const boq = await this.fetchReviewsBoqOnly(options, reviewsService);
+        if (boq.reviews.length > 0)
+            return boq;
+        return reviewsService.listEmbeddedFromPreview(previewData, {
+            hexId: options.hexId,
+            name: options.name,
+            lat: options.lat,
+            lng: options.lng,
+            ftid: options.ftid,
+            limit: options.reviewLimit ?? 10,
+            sort: options.reviewSort,
+        });
+    }
+    mergePhotoSources(placePhotos, reviews, previewData) {
+        const fromReviews = reviews.flatMap((r) => [
+            ...(r.photos ?? []),
+            ...(r.authorPhoto ? [r.authorPhoto] : []),
+        ]).filter((url) => typeof url === 'string' && !url.includes('/a-/'));
+        const deep = extractPhotosDeep(previewData, 50);
+        return dedupePhotos([...placePhotos, ...deep, ...fromReviews], 50);
+    }
+    async fetchLocalPosts(options) {
+        const url = buildLocalPostsUrl({
+            hexId: options.hexId,
+            ftid: options.ftid,
+            hl: this.hl,
+            gl: this.gl,
+        });
+        const start = performance.now();
+        try {
+            const data = await this.http.get(url, {
+                referer: 'https://www.google.com/maps/',
+                includeOrigin: true,
+                allowShortBody: true,
+            });
+            return {
+                posts: extractLocalPosts(data),
+                timingMs: performance.now() - start,
+            };
+        }
+        catch {
+            return { posts: [], timingMs: performance.now() - start };
+        }
+    }
+}
+//# sourceMappingURL=places.js.map

package/dist/services/places.js.map

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

package/dist/services/reveal.d.ts

@@ -0,0 +1,15 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { RevealPlaceOptions, RevealPlaceResult } from '../types/reveal.js';
+export declare class RevealService {
+    private http;
+    private hl;
+    private gl;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Reveal a hidden POI at a map click location.
+     * Requires a feature id (`ftid`) from search/suggest or place preview.
+     */
+    revealAtClick(options: RevealPlaceOptions): Promise<RevealPlaceResult>;
+}
+//# sourceMappingURL=reveal.d.ts.map

package/dist/services/reveal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.d.ts","sourceRoot":"","sources":["../../src/services/reveal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;gBAEP,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAMjD;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA2B7E"}

package/dist/services/reveal.js

@@ -0,0 +1,41 @@
+import { extractRevealPlace } from '../parsers/reveal.js';
+import { buildRevealUrl, normalizeRevealFtid } from '../rpc/reveal-pb.js';
+export class RevealService {
+    http;
+    hl;
+    gl;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Reveal a hidden POI at a map click location.
+     * Requires a feature id (`ftid`) from search/suggest or place preview.
+     */
+    async revealAtClick(options) {
+        if (!options.ftid) {
+            return {};
+        }
+        const url = buildRevealUrl({
+            camLat: options.camLat,
+            camLng: options.camLng,
+            camZoom: options.camZoom,
+            hitLat: options.hitLat,
+            hitLng: options.hitLng,
+            ftid: normalizeRevealFtid(options.ftid),
+            width: options.width,
+            height: options.height,
+            tileX: options.tileX,
+            tileY: options.tileY,
+            hl: this.hl,
+            gl: this.gl,
+        });
+        const data = await this.http.get(url, {
+            referer: 'https://www.google.com/maps/',
+            includeOrigin: true,
+        });
+        return extractRevealPlace(data);
+    }
+}
+//# sourceMappingURL=reveal.js.map

package/dist/services/reveal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reveal.js","sourceRoot":"","sources":["../../src/services/reveal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1E,MAAM,OAAO,aAAa;IAChB,IAAI,CAAa;IACjB,EAAE,CAAS;IACX,EAAE,CAAS;IAEnB,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;QAC5B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,IAAI,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,OAA2B;QAC7C,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,GAAG,GAAG,cAAc,CAAC;YACzB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC;YACvC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;SACZ,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE;YACpC,OAAO,EAAE,8BAA8B;YACvC,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC,IAA6C,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/services/reviews.d.ts

@@ -0,0 +1,70 @@
+import { HttpClient } from '../client/http-client.js';
+import { sumRatingDistribution } from '../parsers/review-aggregates.js';
+import type { GMapsConfig, ReviewSortOrder, ReviewsResult } from '../types/common.js';
+import type { ReviewClientFilters } from '../types/reviews.js';
+import type { PbNode } from '../types/protobuf.js';
+export interface GetReviewsOptions {
+    hexId: string;
+    name?: string;
+    lat?: number;
+    lng?: number;
+    ftid?: string;
+    limit?: number;
+    paginationToken?: string;
+    /**
+     * Server-side sort via Boq reqpld slot [1]: 1=relevant, 2=newest, 3=highest, 4=lowest.
+     */
+    sort?: ReviewSortOrder;
+    /**
+     * Filter parsed rows client-side. Anonymous Boq ignores server-side search/filter pb —
+     * See docs/internal/FINDINGS-endpoints.md for the reviews wire format.
+     */
+    filters?: ReviewClientFilters;
+    /**
+     * Attach place-wide rating histogram from GetPlaceUgcPostAggregates (batchexecute).
+     * Sets `ratingDistribution`, `aggregateRating`, and `totalReviews` when available.
+     */
+    includeAggregates?: boolean;
+    /** Override session psi for aggregates (scraped from Maps bootstrap when omitted). */
+    psi?: string;
+}
+export declare class ReviewsService {
+    private http;
+    private hl;
+    private gl;
+    private ugcAggregates;
+    constructor(http: HttpClient, config: GMapsConfig);
+    /**
+     * Fetch reviews from Google Maps internal surfaces:
+     * 1. GetLocalBoqProxy httpservice RPC (default)
+     * 2. Embedded snippets in place preview
+     */
+    list(options: GetReviewsOptions): Promise<ReviewsResult>;
+    listAll(options: GetReviewsOptions & {
+        maxPages?: number;
+    }): Promise<ReviewsResult>;
+    /**
+     * Full paginated reviews via GetLocalBoqProxy httpservice RPC.
+     *
+     * Responses are cumulative: passing page 1's `nextPageToken` returns page 1's reviews
+     * plus the next batch. Callers paging manually should dedupe by `reviewId`, or use
+     * `listAll`, which does it for them.
+     */
+    listBoq(options: GetReviewsOptions): Promise<ReviewsResult>;
+    /**
+     * Reviews embedded in place preview at place[31][1].
+     *
+     * A hex id alone is enough — buildPlaceUrl falls back to the hex-only template — so this
+     * no longer bails out when the caller has no name or coordinates. That also makes
+     * `totalReviews` reachable for hex-only lookups.
+     */
+    listEmbedded(options: GetReviewsOptions): Promise<ReviewsResult>;
+    /** Parse embedded reviews from an existing place preview response (no extra HTTP). */
+    listEmbeddedFromPreview(data: PbNode, options: GetReviewsOptions): Promise<ReviewsResult>;
+    /** Full paginated reviews via /maps/rpc/listugcposts (requires SAPISID cookies). */
+    listRpc(options: GetReviewsOptions): Promise<ReviewsResult>;
+    private fetchAggregates;
+    private attachAggregates;
+}
+export { sumRatingDistribution };
+//# sourceMappingURL=reviews.d.ts.map

package/dist/services/reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviews.d.ts","sourceRoot":"","sources":["../../src/services/reviews.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,EAEL,qBAAqB,EACtB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sFAAsF;IACtF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,aAAa,CAAuB;gBAEhC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAOjD;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAUxD,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IA+GzF;;;;;;OAMG;IACG,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAsBjE;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAsBtE,sFAAsF;IAChF,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAgB/F,oFAAoF;IAC9E,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;YA0BnD,eAAe;YAsBf,gBAAgB;CAe/B;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/services/reviews.js

@@ -0,0 +1,245 @@
+import { extractBoqReviews } from '../parsers/boq-reviews.js';
+import { applyReviewClientFilters } from '../parsers/review-client-filters.js';
+import { placeAggregatesToRatingDistribution, sumRatingDistribution, } from '../parsers/review-aggregates.js';
+import { extractEmbeddedReviews, extractPlaceDetails } from '../parsers/place.js';
+import { extractListUgcReviews } from '../parsers/reviews.js';
+import { buildBoqReviewsUrl } from '../rpc/boq-reviews.js';
+import { buildPlaceUrl, buildReviewsUrl } from '../rpc/pb-builders.js';
+import { UgcAggregatesService } from './ugc-aggregates.js';
+import { asPlaceDataNode } from '../types/protobuf.js';
+export class ReviewsService {
+    http;
+    hl;
+    gl;
+    ugcAggregates;
+    constructor(http, config) {
+        this.http = http;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+        this.ugcAggregates = new UgcAggregatesService(http, config);
+    }
+    /**
+     * Fetch reviews from Google Maps internal surfaces:
+     * 1. GetLocalBoqProxy httpservice RPC (default)
+     * 2. Embedded snippets in place preview
+     */
+    async list(options) {
+        const boq = await this.listBoq(options);
+        if (boq.reviews.length > 0) {
+            return boq;
+        }
+        const embedded = await this.listEmbedded(options);
+        return embedded;
+    }
+    async listAll(options) {
+        const maxPages = options.maxPages ?? 10;
+        const allReviews = [];
+        let token = options.paginationToken;
+        let pages = 0;
+        let pageRatingDistribution;
+        let lastNextPageToken;
+        let ratingDistribution;
+        let aggregateRating;
+        let totalReviews;
+        if (options.includeAggregates) {
+            const aggregates = await this.fetchAggregates(options);
+            ratingDistribution = aggregates.ratingDistribution;
+            aggregateRating = aggregates.aggregateRating;
+            totalReviews = aggregates.totalReviews;
+        }
+        while (pages < maxPages) {
+            const page = await this.listBoq({ ...options, paginationToken: token, includeAggregates: false });
+            if (page.reviews.length === 0) {
+                break;
+            }
+            if (page.pageRatingDistribution) {
+                pageRatingDistribution = page.pageRatingDistribution;
+            }
+            for (const review of page.reviews) {
+                if (!allReviews.some((r) => r.reviewId && r.reviewId === review.reviewId)) {
+                    allReviews.push(review);
+                }
+            }
+            if (!page.nextPageToken) {
+                lastNextPageToken = undefined;
+                break;
+            }
+            token = page.nextPageToken;
+            lastNextPageToken = page.nextPageToken;
+            pages++;
+        }
+        if (allReviews.length > 0) {
+            if (totalReviews == null) {
+                const embedded = await this.listEmbedded(options);
+                totalReviews = embedded.totalReviews;
+            }
+            const filtered = applyReviewClientFilters({
+                reviewCount: allReviews.length,
+                reviews: allReviews,
+                totalReviews,
+                pageRatingDistribution,
+                ratingDistribution,
+                aggregateRating,
+                nextPageToken: lastNextPageToken,
+            }, options.filters);
+            return filtered;
+        }
+        const embedded = await this.listEmbedded(options);
+        totalReviews = embedded.totalReviews;
+        if (!this.http.hasAuthCookies()) {
+            return applyReviewClientFilters({ ...embedded, ratingDistribution, aggregateRating, totalReviews }, options.filters);
+        }
+        token = options.paginationToken;
+        pages = 0;
+        while (pages < maxPages) {
+            const page = await this.listRpc({ ...options, includeAggregates: false });
+            if (page.reviews.length === 0)
+                break;
+            for (const review of page.reviews) {
+                if (!allReviews.some((r) => r.reviewId && r.reviewId === review.reviewId)) {
+                    allReviews.push(review);
+                }
+            }
+            if (!page.nextPageToken)
+                break;
+            token = page.nextPageToken;
+            pages++;
+        }
+        if (allReviews.length === 0) {
+            return applyReviewClientFilters({ ...embedded, ratingDistribution, aggregateRating, totalReviews }, options.filters);
+        }
+        return applyReviewClientFilters({
+            reviewCount: allReviews.length,
+            reviews: allReviews,
+            totalReviews: totalReviews ?? embedded.totalReviews,
+            ratingDistribution,
+            aggregateRating,
+        }, options.filters);
+    }
+    /**
+     * Full paginated reviews via GetLocalBoqProxy httpservice RPC.
+     *
+     * Responses are cumulative: passing page 1's `nextPageToken` returns page 1's reviews
+     * plus the next batch. Callers paging manually should dedupe by `reviewId`, or use
+     * `listAll`, which does it for them.
+     */
+    async listBoq(options) {
+        const url = buildBoqReviewsUrl({
+            hexId: options.hexId,
+            ftid: options.ftid,
+            limit: options.limit ?? 10,
+            sort: options.sort,
+            paginationToken: options.paginationToken,
+        });
+        try {
+            const data = await this.http.get(url, {
+                referer: 'https://www.google.com/maps/',
+                includeOrigin: true,
+            });
+            const parsed = extractBoqReviews(data);
+            const withAggregates = await this.attachAggregates(parsed, options);
+            return applyReviewClientFilters(withAggregates, options.filters);
+        }
+        catch {
+            return { reviewCount: 0, reviews: [] };
+        }
+    }
+    /**
+     * Reviews embedded in place preview at place[31][1].
+     *
+     * A hex id alone is enough — buildPlaceUrl falls back to the hex-only template — so this
+     * no longer bails out when the caller has no name or coordinates. That also makes
+     * `totalReviews` reachable for hex-only lookups.
+     */
+    async listEmbedded(options) {
+        const url = buildPlaceUrl({
+            hexId: options.hexId,
+            name: options.name,
+            lat: options.lat,
+            lng: options.lng,
+            ftid: options.ftid,
+            hl: this.hl,
+            gl: this.gl,
+            mode: options.lat != null && options.lng != null ? 'detail' : 'live',
+        });
+        const data = await this.http.get(url, {
+            referer: options.name
+                ? `https://www.google.com/maps/place/${options.name.replace(/ /g, '+')}/`
+                : 'https://www.google.com/maps/',
+            includeOrigin: true,
+        });
+        return this.listEmbeddedFromPreview(data, options);
+    }
+    /** Parse embedded reviews from an existing place preview response (no extra HTTP). */
+    async listEmbeddedFromPreview(data, options) {
+        const placeData = asPlaceDataNode(Array.isArray(data) ? data[6] : undefined);
+        const reviews = placeData ? extractEmbeddedReviews(placeData) : [];
+        const details = extractPlaceDetails(data);
+        const base = {
+            reviewCount: reviews.length,
+            reviews: reviews.map((r) => ({ ...r, source: 'embedded' })),
+            totalReviews: details.reviewCount,
+        };
+        const withAggregates = await this.attachAggregates(base, options);
+        return applyReviewClientFilters(withAggregates, options.filters);
+    }
+    /** Full paginated reviews via /maps/rpc/listugcposts (requires SAPISID cookies). */
+    async listRpc(options) {
+        const url = buildReviewsUrl({
+            hexId: options.hexId,
+            limit: options.limit ?? 10,
+            paginationToken: options.paginationToken,
+            hl: this.hl,
+            gl: this.gl,
+        });
+        try {
+            const data = await this.http.get(url, {
+                referer: 'https://www.google.com/',
+                authenticated: true,
+                allowShortBody: true,
+            });
+            const result = extractListUgcReviews(data);
+            if (result.unauthenticated || result.reviews.length === 0) {
+                return { reviewCount: 0, reviews: [] };
+            }
+            const withAggregates = await this.attachAggregates(result, options);
+            return applyReviewClientFilters(withAggregates, options.filters);
+        }
+        catch {
+            return { reviewCount: 0, reviews: [] };
+        }
+    }
+    async fetchAggregates(options) {
+        if (!options.includeAggregates) {
+            return {};
+        }
+        try {
+            const aggregates = await this.ugcAggregates.getPlaceAggregates({
+                hexId: options.hexId,
+                psi: options.psi,
+            });
+            return {
+                ratingDistribution: placeAggregatesToRatingDistribution(aggregates),
+                aggregateRating: aggregates.rating,
+                totalReviews: aggregates.totalCount,
+            };
+        }
+        catch {
+            return {};
+        }
+    }
+    async attachAggregates(result, options) {
+        const aggregates = await this.fetchAggregates(options);
+        if (!aggregates.ratingDistribution && aggregates.totalReviews == null) {
+            return result;
+        }
+        return {
+            ...result,
+            ratingDistribution: aggregates.ratingDistribution ?? result.ratingDistribution,
+            aggregateRating: aggregates.aggregateRating ?? result.aggregateRating,
+            totalReviews: result.totalReviews ?? aggregates.totalReviews,
+        };
+    }
+}
+export { sumRatingDistribution };
+//# sourceMappingURL=reviews.js.map

package/dist/services/reviews.js.map

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