googlemaps-kit 0.1.0

package/dist/known-surfaces.js

@@ -0,0 +1,276 @@
+/**
+ * Status of reverse-engineered Google Maps HTTP surfaces.
+ */
+export const KNOWN_SURFACES = {
+    search: {
+        status: 'working',
+        method: 'GET',
+        path: '/search?tbm=map',
+        notes: 'Text search with pagination via !8i{offset}. Enterprise field mask exposes rating, phone, hours, attributes, and timezone in one call.',
+    },
+    searchFilters: {
+        status: 'fallback',
+        method: 'GET',
+        path: '/search?tbm=map',
+        notes: 'Maps applies open-now, price, and rating filters client-side. The SDK filters parsed rows via SearchOptions.filters.',
+    },
+    geocode: {
+        status: 'working',
+        method: 'GET',
+        path: '/search?tbm=map',
+        notes: 'Forward geocode uses q={address}; reverse uses q={lat},{lng}. Same RPC as search; no dedicated geocode endpoint.',
+    },
+    placePreview: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/place',
+        notes: 'Hours, phone, amenities, and embedded review snippets. Rich/live pb modes return full attribute groups; truncated stubs are retried.',
+    },
+    reviewsBoq: {
+        status: 'working',
+        method: 'GET',
+        path: '/httpservice/.../GetLocalBoqProxy',
+        notes: 'Primary reviews source with pagination. Pages are cumulative; listAll dedupes by reviewId.',
+    },
+    reviewsEmbedded: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/place (embedded)',
+        notes: 'Review snippets in place preview. No author name or date; use reviewsBoq for full rows.',
+    },
+    reviewsRpc: {
+        status: 'auth-required',
+        method: 'GET',
+        path: '/maps/rpc/listugcposts',
+        notes: 'Requires SAPISID session cookies (GMAPS_COOKIES).',
+    },
+    localPosts: {
+        status: 'unverified',
+        method: 'GET',
+        path: '/maps/preview/localposts',
+        notes: 'Returns HTTP 200 with an empty array for every business sampled. Parser layout is inferred, not validated on real data.',
+    },
+    knowledgeRpc: {
+        status: 'not-used-by-web',
+        method: 'GET',
+        path: '/maps/rpc/getknowledgeentity',
+        notes: 'HTTP 400 for all pb variants. The web client never calls this path; entity panels come from place preview.',
+    },
+    knowledgeFallback: {
+        status: 'fallback',
+        method: 'parse',
+        path: 'place preview fields',
+        notes: 'Categories, amenities, and description from place preview. Facts are amenity strings, not knowledge-graph facts.',
+    },
+    directions: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/directions',
+        notes: 'Driving, walking, and transit verified. Bicycling coverage is sparse in many cities.',
+    },
+    transitStationDepartures: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/place (placeData[62])',
+        notes: 'Live departure boards ship inside the place preview for transit stations.',
+    },
+    batchListTransitLines: {
+        status: 'not-used-by-web',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsTransitService.ListTransitLines)',
+        notes: 'Registered in Maps JS but never fired in browser capture. Schedules come from place preview instead.',
+    },
+    passiveAssist: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/passiveassist',
+        notes: 'Viewport chips (neighborhood labels, weather). Requires an in-page viewport psi from the caller.',
+    },
+    reveal: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/reveal',
+        notes: 'Resolves a hidden POI from a map click. Requires a bare ftid token.',
+    },
+    suggest: {
+        status: 'working',
+        method: 'GET',
+        path: '/s?tbm=map&gs_ri=maps&suggest=p',
+        notes: 'Omnibox autocomplete. Camera pb is required; bare q returns HTTP 500.',
+    },
+    panoramaNearby: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/photometa/ac/v1',
+        notes: 'Coverage tiles at z17. listentityphotos nearby mode is abuse-throttled on many IPs.',
+    },
+    panoramaMetadata: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/photometa/v1',
+        notes: 'Full panorama metadata. Unknown pano id returns a short stub; treat as not-found.',
+    },
+    mapTilesProto: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/vt/proto',
+        notes: '256px roadmap tiles wrapped in protobuf. Satellite and 512px variants return HTTP 400.',
+    },
+    mapTilesStream: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/vt/stream',
+        notes: 'Same pb contract as mapTilesProto with a different content-type.',
+    },
+    mapIcons: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/vt/icon/name=assets/icons/poi/…',
+        notes: 'POI pin sprites. Optional ?scale=2 for retina.',
+    },
+    panoramaImagery: {
+        status: 'working',
+        method: 'GET',
+        path: 'streetviewpixels-pa.googleapis.com/v1/{thumbnail,tile}',
+        notes: 'No auth. Invalid pano ids return a small placeholder JPEG.',
+    },
+    placeLists: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/entitylist/getlist',
+        notes: 'Public shared place lists. Personal lists require sign-in.',
+    },
+    placePhotos: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/place',
+        notes: 'place_preview yields many URLs without metadata. batchexecute ListEntityPhotos has full metadata and pagination.',
+    },
+    shortLinks: {
+        status: 'working',
+        method: 'GET',
+        path: 'maps.app.goo.gl/{id}, goo.gl/maps/{id}',
+        notes: 'Short links expand via HTTP redirects. Creation uses batchexecute CreateShortUrl.',
+    },
+    pegman: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/preview/pegman',
+        notes: 'Street View coverage boxes. Not wrapped in a service; photometa coverage tiles are preferred.',
+    },
+    distanceMatrix: {
+        status: 'fallback',
+        method: 'GET',
+        path: '/maps/preview/directions',
+        notes: 'No batch matrix RPC. Fans out N×M directions requests with dedupe and bounded concurrency.',
+    },
+    elevation: {
+        status: 'fallback',
+        method: 'GET',
+        path: '/maps/preview/directions',
+        notes: 'No dedicated elevation RPC. Parsed from bicycling/walking route elevation blocks where present.',
+    },
+    timezone: {
+        status: 'working',
+        method: 'GET',
+        path: '/search?tbm=map',
+        notes: 'IANA timezone id from geocode rows. UTC/DST offsets are derived locally via Intl.',
+    },
+    staticMap: {
+        status: 'working',
+        method: 'GET',
+        path: '/maps/vt/proto (local tile stitch)',
+        notes: 'Keyless static map via local tile stitching. /maps/api/staticmap requires a billed API key.',
+    },
+    mapsUrlBuilders: {
+        status: 'working',
+        method: 'N/A',
+        path: 'google.com/maps/* (canonical share links)',
+        notes: 'Pure builders for place, search, directions, viewport, and Street View share links.',
+    },
+    batchTraffic: {
+        status: 'working',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsTrafficService.GetAreaTraffic)',
+        notes: 'Viewport traffic summary and severity icons.',
+    },
+    batchCategories: {
+        status: 'working',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/LocalRapService.*)',
+        notes: 'Category taxonomy, suggestions, place info, duplicates, and signed URLs.',
+    },
+    batchUgcAggregates: {
+        status: 'working',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsUgcPostService.GetPlaceUgcPostAggregates)',
+        notes: 'Rating histogram. Requires a Maps session psi in the request args.',
+    },
+    batchDecodeUrl: {
+        status: 'working',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsUrlService.DecodeUrl)',
+        notes: 'Server-side Maps URL decode. Complements the offline parseMapsUrl parser.',
+    },
+    batchUgcPosts: {
+        status: 'auth-required',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsUgcPostService.ListUgcPosts)',
+        notes: 'Anonymous calls return an auth stub with zero rows. Boq proxy is the working anonymous reviews source.',
+    },
+    batchEntityPhotos: {
+        status: 'working',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsPhotoService.ListEntityPhotos)',
+        notes: 'Photo gallery with pagination and metadata. Requires a warmed cookie jar before batchexecute.',
+    },
+    askMapsAgent: {
+        status: 'auth-required',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsAiAgentService.CallAskMapsAgent)',
+        notes: 'Consumer Ask Maps agent. Requires GMAPS_COOKIES.',
+    },
+    platformAiSummaries: {
+        status: 'blocked',
+        method: 'GET/POST',
+        path: 'places.googleapis.com (generativeSummary / reviewSummary / …)',
+        notes: 'Places API field masks only. Not available from consumer Maps surfaces.',
+    },
+    batchKnowledgeEntity: {
+        status: 'blocked',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute (/MapsCrisisService.GetKnowledgeEntity)',
+        notes: 'Returns [3] for every probed arg shape. Place preview fallback is the working path.',
+    },
+    entityDetails: {
+        status: 'not-used-by-web',
+        method: 'GET',
+        path: '/maps/preview/entity',
+        notes: 'HTTP 404 for all pb variants. Use place preview instead.',
+    },
+    batchexecuteDirections: {
+        status: 'not-used-by-web',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute',
+        notes: 'Route geometry comes from GET /maps/preview/directions, not batchexecute.',
+    },
+    batchexecuteXsrf: {
+        status: 'auth-required',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute',
+        notes: 'Legacy short rpcids require WIZ SNlM0e as at. Service-path format works anonymously.',
+    },
+    batchexecuteServices: {
+        status: 'working',
+        method: 'POST',
+        path: '/maps/_/MapsWizUi/data/batchexecute',
+        notes: '2026 service-path format: f.req with /MapsService.Method and no at field. Works anonymously.',
+    },
+};
+export function getSurfaceInfo(name) {
+    return KNOWN_SURFACES[name];
+}
+export function listSurfacesByStatus(status) {
+    return Object.keys(KNOWN_SURFACES).filter((name) => KNOWN_SURFACES[name].status === status);
+}
+//# sourceMappingURL=known-surfaces.js.map

package/dist/known-surfaces.js.map

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

package/dist/parsers/batch-url.d.ts

@@ -0,0 +1,13 @@
+import type { CreateShortUrlResult, DecodedMapsUrl } from '../types/batch-url.js';
+/**
+ * Parse DecodeUrl batchexecute response.
+ * Verified: lng [0][2][1][1], lat [0][2][1][2], zoom [0][2][1][5], name [0][3][2][1].
+ */
+export declare function extractDecodedMapsUrl(data: unknown, options?: {
+    raw?: boolean;
+}): DecodedMapsUrl;
+/** Parse CreateShortUrl — short link typically at [0] or [1]. */
+export declare function extractCreateShortUrlResult(data: unknown, options?: {
+    raw?: boolean;
+}): CreateShortUrlResult;
+//# sourceMappingURL=batch-url.d.ts.map

package/dist/parsers/batch-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-url.d.ts","sourceRoot":"","sources":["../../src/parsers/batch-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKlF;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAuBhG;AAED,iEAAiE;AACjE,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,oBAAoB,CAY5G"}

package/dist/parsers/batch-url.js

@@ -0,0 +1,42 @@
+import { safeGet } from '../utils/safe-get.js';
+import { parseBatchPayload } from '../rpc/batch-rpc.js';
+/**
+ * Parse DecodeUrl batchexecute response.
+ * Verified: lng [0][2][1][1], lat [0][2][1][2], zoom [0][2][1][5], name [0][3][2][1].
+ */
+export function extractDecodedMapsUrl(data, options) {
+    const root = parseBatchPayload(data);
+    const block = safeGet(root, 0) ?? root;
+    const coords = safeGet(block, 2, 1);
+    const name = safeGet(block, 3, 2, 1);
+    let lat;
+    let lng;
+    let zoom;
+    if (Array.isArray(coords)) {
+        lng = typeof coords[1] === 'number' ? coords[1] : undefined;
+        lat = typeof coords[2] === 'number' ? coords[2] : undefined;
+        zoom = typeof coords[5] === 'number' ? coords[5] : undefined;
+    }
+    return {
+        name,
+        lat,
+        lng,
+        zoom,
+        raw: options?.raw ? root : undefined,
+    };
+}
+/** Parse CreateShortUrl — short link typically at [0] or [1]. */
+export function extractCreateShortUrlResult(data, options) {
+    const root = parseBatchPayload(data);
+    const candidates = [
+        safeGet(root, 0),
+        safeGet(root, 1),
+        safeGet(root, 0, 0),
+    ];
+    const shortUrl = candidates.find((u) => typeof u === 'string' && u.includes('goo.gl'));
+    return {
+        shortUrl,
+        raw: options?.raw ? root : undefined,
+    };
+}
+//# sourceMappingURL=batch-url.js.map

package/dist/parsers/batch-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-url.js","sourceRoot":"","sources":["../../src/parsers/batch-url.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAa,EAAE,OAA2B;IAC9E,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,OAAO,CAAW,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAY,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,OAAO,CAAS,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7C,IAAI,GAAuB,CAAC;IAC5B,IAAI,GAAuB,CAAC;IAC5B,IAAI,IAAwB,CAAC;IAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,GAAG,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,GAAG,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,IAAI,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/D,CAAC;IAED,OAAO;QACL,IAAI;QACJ,GAAG;QACH,GAAG;QACH,IAAI;QACJ,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,2BAA2B,CAAC,IAAa,EAAE,OAA2B;IACpF,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,UAAU,GAAG;QACjB,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO,CAAS,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO,CAAS,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;KAC5B,CAAC;IACF,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvF,OAAO;QACL,QAAQ;QACR,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;KACrC,CAAC;AACJ,CAAC"}

package/dist/parsers/boq-reviews.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parser for GetLocalBoqProxy review responses.
+ */
+import type { ReviewsResult } from '../types/common.js';
+import type { PbNode } from '../types/protobuf.js';
+/** Parse GetLocalBoqProxy JSON response into reviews. */
+export declare function extractBoqReviews(data: PbNode): ReviewsResult;
+//# sourceMappingURL=boq-reviews.d.ts.map

package/dist/parsers/boq-reviews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boq-reviews.d.ts","sourceRoot":"","sources":["../../src/parsers/boq-reviews.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAoC,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAQ1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAqQnD,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAoB7D"}

package/dist/parsers/boq-reviews.js

@@ -0,0 +1,254 @@
+/**
+ * Parser for GetLocalBoqProxy review responses.
+ */
+import { asBoqRoot } from '../types/protobuf.js';
+import { normalizePhotoUrl } from '../utils/photo-url.js';
+import { safeGet } from '../utils/safe-get.js';
+import { htmlToPlainText } from './shared.js';
+function isGoogleUserContentUrl(value) {
+    return typeof value === 'string' && value.includes('googleusercontent.com');
+}
+function parseLocalGuideLevel(authorPhoto, levelBlock) {
+    if (typeof authorPhoto === 'string') {
+        const match = authorPhoto.match(/-ba(\d+)-/i);
+        if (match)
+            return Number.parseInt(match[1], 10);
+    }
+    if (Array.isArray(levelBlock) && typeof levelBlock[1] === 'number' && levelBlock[1] > 0) {
+        return levelBlock[1];
+    }
+    return undefined;
+}
+function parseReviewerCredibility(authorInfo) {
+    if (!Array.isArray(authorInfo))
+        return undefined;
+    const reviewCount = typeof authorInfo[3] === 'number' ? authorInfo[3] : undefined;
+    const photoCount = typeof authorInfo[4] === 'number' ? authorInfo[4] : undefined;
+    const authorPhoto = typeof authorInfo[1] === 'string' ? authorInfo[1] : undefined;
+    const localGuideLevel = parseLocalGuideLevel(authorPhoto, authorInfo[5]);
+    const isLocalGuide = localGuideLevel != null ||
+        (typeof authorPhoto === 'string' && /-ba\d+-/i.test(authorPhoto));
+    if (reviewCount == null &&
+        photoCount == null &&
+        localGuideLevel == null &&
+        !isLocalGuide) {
+        return undefined;
+    }
+    return { reviewCount, photoCount, localGuideLevel, isLocalGuide: isLocalGuide || undefined };
+}
+function parseOwnerReply(block) {
+    if (!Array.isArray(block))
+        return undefined;
+    const date = typeof block[1] === 'string' ? block[1] : undefined;
+    const rawText = typeof block[2] === 'string' ? block[2] : undefined;
+    const text = rawText ? htmlToPlainText(rawText) : undefined;
+    if (!date && !text)
+        return undefined;
+    return { date, text };
+}
+function parseReviewPhotos(review) {
+    const photosNode = review[14];
+    if (!Array.isArray(photosNode))
+        return [];
+    const photos = [];
+    for (const entry of photosNode) {
+        if (!Array.isArray(entry) || typeof entry[0] !== 'string')
+            continue;
+        const url = entry[0].startsWith('//') ? `https:${entry[0]}` : entry[0];
+        if (!url.includes('googleusercontent.com'))
+            continue;
+        photos.push({
+            photoId: typeof entry[3] === 'string' ? entry[3] : undefined,
+            url,
+            normalizedUrl: normalizePhotoUrl(url),
+            caption: typeof entry[1] === 'string' && entry[1].length > 0 ? entry[1] : undefined,
+            aspectRatio: typeof entry[4] === 'number' ? entry[4] : undefined,
+            videoUrl: typeof entry[5] === 'string' ? entry[5] : undefined,
+            uploadDate: typeof entry[6] === 'string' ? entry[6] : undefined,
+        });
+    }
+    return photos;
+}
+function parseAttributeValue(entry) {
+    const choiceBlock = entry[2];
+    if (Array.isArray(choiceBlock)) {
+        const row = choiceBlock[0];
+        if (Array.isArray(row)) {
+            const selected = row[0];
+            if (Array.isArray(selected) && typeof selected[1] === 'string') {
+                return selected[1];
+            }
+        }
+    }
+    const altBlock = entry[3];
+    if (Array.isArray(altBlock)) {
+        const row = altBlock[0];
+        if (Array.isArray(row)) {
+            const selected = row[0];
+            if (Array.isArray(selected) && typeof selected[1] === 'string') {
+                return selected[1];
+            }
+        }
+    }
+    return undefined;
+}
+function parseReviewAttributes(review) {
+    const attrsNode = review[30];
+    if (!Array.isArray(attrsNode))
+        return [];
+    const attributes = [];
+    for (const entry of attrsNode) {
+        if (!Array.isArray(entry) || !Array.isArray(entry[0]))
+            continue;
+        const keyNode = entry[0];
+        let key;
+        if (Array.isArray(keyNode)) {
+            const first = keyNode[0];
+            if (typeof first === 'string') {
+                key = first;
+            }
+            else if (Array.isArray(first) && typeof first[0] === 'string') {
+                key = first[0];
+            }
+        }
+        if (!key)
+            continue;
+        const label = typeof entry[5] === 'string'
+            ? entry[5]
+            : typeof entry[1] === 'string'
+                ? entry[1]
+                : key;
+        const aspectRatings = entry[11];
+        const rating = Array.isArray(aspectRatings) && typeof aspectRatings[0] === 'number'
+            ? aspectRatings[0]
+            : undefined;
+        const value = parseAttributeValue(entry);
+        attributes.push({
+            key,
+            label,
+            value,
+            rating: rating != null && rating >= 1 && rating <= 5 ? rating : undefined,
+        });
+    }
+    return attributes;
+}
+function parseTranslation(review) {
+    const language = typeof review[26] === 'string' ? review[26] : undefined;
+    const fullTextRaw = typeof review[27] === 'string' ? review[27] : undefined;
+    const previewRaw = typeof review[28] === 'string' ? review[28] : undefined;
+    const originalRaw = typeof review[32] === 'string' && review[32].length > 0 ? review[32] : undefined;
+    const translationBlock = review[44];
+    const isTranslated = Array.isArray(translationBlock) && translationBlock[4] === 1 ? true : undefined;
+    const text = fullTextRaw ? htmlToPlainText(fullTextRaw) : undefined;
+    const textPreview = previewRaw ? htmlToPlainText(previewRaw) : undefined;
+    const originalText = originalRaw ? htmlToPlainText(originalRaw) : undefined;
+    if (!language && !text && !textPreview && !originalText && isTranslated == null) {
+        return undefined;
+    }
+    return { language, isTranslated, text, textPreview, originalText };
+}
+function parseSingleReview(review) {
+    if (!Array.isArray(review) || review.length < 6) {
+        return null;
+    }
+    const rating = review[1];
+    const timeInfo = review[2];
+    const authorInfo = review[3];
+    const reviewId = review[5];
+    const translation = parseTranslation(review);
+    const structuredPhotos = parseReviewPhotos(review);
+    const attributes = parseReviewAttributes(review);
+    const ownerReply = parseOwnerReply(review[4] ?? null);
+    const credibility = parseReviewerCredibility(Array.isArray(authorInfo) ? authorInfo : undefined);
+    const helpfulCount = typeof review[29] === 'number' ? review[29] : undefined;
+    const permalink = typeof review[12] === 'string' ? review[12] : undefined;
+    const timestampMs = Array.isArray(timeInfo) && typeof timeInfo[2] === 'string' ? timeInfo[2] : undefined;
+    const parsed = {
+        reviewId: typeof reviewId === 'string' ? reviewId : undefined,
+        rating: typeof rating === 'number' && rating >= 1 && rating <= 5 ? rating : undefined,
+        date: Array.isArray(timeInfo) && typeof timeInfo[0] === 'string' ? timeInfo[0] : undefined,
+        timestampMs,
+        author: Array.isArray(authorInfo) && typeof authorInfo[0] === 'string' ? authorInfo[0] : undefined,
+        authorPhoto: Array.isArray(authorInfo) && authorInfo[1] != null && isGoogleUserContentUrl(authorInfo[1])
+            ? authorInfo[1]
+            : undefined,
+        profileUrl: Array.isArray(authorInfo) && typeof authorInfo[2] === 'string' ? authorInfo[2] : undefined,
+        credibility,
+        text: translation?.text,
+        textPreview: translation?.textPreview,
+        language: translation?.language,
+        translation,
+        originalText: translation?.originalText,
+        isTranslated: translation?.isTranslated,
+        ownerReply,
+        helpfulCount,
+        permalink,
+        attributes: attributes.length > 0 ? attributes : undefined,
+        photoItems: structuredPhotos.length > 0 ? structuredPhotos : undefined,
+        photos: structuredPhotos.length > 0 ? structuredPhotos.map((p) => p.normalizedUrl) : undefined,
+        source: 'boq',
+    };
+    if (!parsed.author && !parsed.text) {
+        return null;
+    }
+    return parsed;
+}
+/** Star counts for the supplied reviews only — not the place aggregate histogram. */
+function buildRatingDistribution(reviews) {
+    const dist = {
+        oneStar: 0,
+        twoStar: 0,
+        threeStar: 0,
+        fourStar: 0,
+        fiveStar: 0,
+    };
+    let counted = 0;
+    for (const review of reviews) {
+        switch (review.rating) {
+            case 1:
+                dist.oneStar++;
+                counted++;
+                break;
+            case 2:
+                dist.twoStar++;
+                counted++;
+                break;
+            case 3:
+                dist.threeStar++;
+                counted++;
+                break;
+            case 4:
+                dist.fourStar++;
+                counted++;
+                break;
+            case 5:
+                dist.fiveStar++;
+                counted++;
+                break;
+            default:
+                break;
+        }
+    }
+    return counted > 0 ? dist : undefined;
+}
+/** Parse GetLocalBoqProxy JSON response into reviews. */
+export function extractBoqReviews(data) {
+    const root = asBoqRoot(data);
+    const reviewsNode = root ? safeGet(root, 1, 10) : undefined;
+    const reviewsArray = Array.isArray(reviewsNode?.[2]) ? reviewsNode[2] : [];
+    const nextPageToken = typeof reviewsNode?.[6] === 'string' ? reviewsNode[6] : undefined;
+    const reviews = [];
+    for (const entry of reviewsArray) {
+        const review = parseSingleReview(entry);
+        if (review) {
+            reviews.push(review);
+        }
+    }
+    return {
+        reviewCount: reviews.length,
+        reviews,
+        nextPageToken,
+        pageRatingDistribution: buildRatingDistribution(reviews),
+    };
+}
+//# sourceMappingURL=boq-reviews.js.map

package/dist/parsers/boq-reviews.js.map

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

package/dist/parsers/categories.d.ts

@@ -0,0 +1,14 @@
+import type { CategoryNode, CategorySuggestion, PlaceInfoResult, PotentialDuplicate, SignedPlaceUrl } from '../types/categories.js';
+/** Parse GetCategoryHierarchy — top-level categories at [0][*]. */
+export declare function extractCategoryHierarchy(data: unknown): CategoryNode[];
+/** Parse GetCategorySuggestions — pairs at [0][*] as [gcid, label]. */
+export declare function extractCategorySuggestions(data: unknown): CategorySuggestion[];
+/** Parse GetPlaceInfo — hex at [0][1] for [[null, hexId]]. */
+export declare function extractPlaceInfo(data: unknown): PlaceInfoResult;
+/** Parse GetPotentialDuplicates — candidates at [0][*]: [hex, name, category, address, …]. */
+export declare function extractPotentialDuplicates(data: unknown, options?: {
+    raw?: boolean;
+}): PotentialDuplicate[];
+/** Parse GetSignedUrl — signed path at [0]. */
+export declare function extractSignedPlaceUrl(data: unknown): SignedPlaceUrl | null;
+//# sourceMappingURL=categories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/parsers/categories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACf,MAAM,wBAAwB,CAAC;AAyChC,mEAAmE;AACnE,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE,CAYtE;AAED,uEAAuE;AACvE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,EAAE,CAe9E;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,CAoB/D;AAED,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,kBAAkB,EAAE,CAyB3G;AAED,+CAA+C;AAC/C,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAM1E"}