googlemaps-kit 0.1.0

package/dist/rpc/pb-builders.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Protobuf URL parameter builders for Google Maps internal endpoints.
+ *
+ * Format: `!{field}{type}{value}` — field order is critical.
+ * Pagination: `!7i` = page size, `!8i` = offset (SerpAPI / Maps web client).
+ */
+import type { TravelMode } from '../types/common.js';
+import type { DirectionsWaypoint } from '../types/directions.js';
+export declare function buildSearchPb(params: {
+    query: string;
+    lat: number;
+    lng: number;
+    resultsCount: number;
+    maxRadius: number;
+    viewportDist: number;
+    offset: number;
+    /** Session token (kEI / response psi) — sent by the browser as !22m5 for page 2+. */
+    psi?: string;
+}): string;
+export declare function buildSearchUrl(params: {
+    query: string;
+    lat: number;
+    lng: number;
+    resultsCount: number;
+    maxRadius: number;
+    viewportDist?: number;
+    offset: number;
+    hl: string;
+    gl: string;
+    psi?: string;
+    ech?: number;
+    zoom?: number;
+}): string;
+/**
+ * Place preview pb — requests photos, hours, phone, categories, embedded review snippets.
+ */
+export declare function buildPlaceDetailPb(params: {
+    hexId: string;
+    lat: number;
+    lng: number;
+}): string;
+/** Extended place pb with amenities and accessibility fields. */
+export declare function buildPlaceRichPb(params: {
+    hexId: string;
+    name: string;
+    lat: number;
+    lng: number;
+    ftid?: string;
+}): string;
+/**
+ * Place preview pb captured verbatim from a live browser session.
+ *
+ * Only the hex id is required — the browser sends no name or coordinates.
+ * Captured via `npm run capture:browser-rpc` (see tests/fixtures/live-pb-capture.json).
+ */
+export declare function buildPlaceLivePb(params: {
+    hexId: string;
+    psi?: string;
+}): string;
+/** @deprecated Use buildPlaceDetailPb */
+export declare const buildPlacePb: typeof buildPlaceRichPb;
+export type PlacePbMode = 'detail' | 'rich' | 'live';
+export declare function buildPlaceUrl(params: {
+    hexId: string;
+    name?: string;
+    lat?: number;
+    lng?: number;
+    ftid?: string;
+    hl: string;
+    gl: string;
+    mode?: PlacePbMode;
+    psi?: string;
+}): string;
+export declare function buildReviewsPb(params: {
+    hexId: string;
+    limit?: number;
+    paginationToken?: string;
+}): string;
+export declare function buildReviewsUrl(params: {
+    hexId: string;
+    limit?: number;
+    paginationToken?: string;
+    hl: string;
+    gl: string;
+}): string;
+export declare function buildLocalPostsPb(params: {
+    hexId: string;
+    ftid?: string;
+}): string;
+export declare function buildLocalPostsUrl(params: {
+    hexId: string;
+    ftid?: string;
+    hl: string;
+    gl: string;
+}): string;
+/** `data=!3e{n}` suffix for /maps/dir/ page URLs — same code space as `!1e{n}`. */
+export declare function directionsDataSuffix(mode: TravelMode): string;
+export declare function buildDirectionsPb(params: {
+    origin: string | {
+        lat: number;
+        lng: number;
+    };
+    destination: string | {
+        lat: number;
+        lng: number;
+    };
+    waypoints?: DirectionsWaypoint[];
+    mode?: TravelMode;
+}): string;
+export declare function buildDirectionsUrls(params: {
+    origin: string | {
+        lat: number;
+        lng: number;
+    };
+    destination: string | {
+        lat: number;
+        lng: number;
+    };
+    waypoints?: DirectionsWaypoint[];
+    mode?: TravelMode;
+    hl: string;
+    gl: string;
+}): string[];
+export declare function buildKnowledgePbVariants(params: {
+    hexId: string;
+    ftid?: string;
+    placeId?: string;
+}): string[];
+export declare function buildKnowledgeUrl(params: {
+    hexId: string;
+    ftid?: string;
+    placeId?: string;
+    hl: string;
+    gl: string;
+}): string[];
+//# sourceMappingURL=pb-builders.d.ts.map

package/dist/rpc/pb-builders.d.ts.map

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

package/dist/rpc/pb-builders.js

@@ -0,0 +1,290 @@
+/**
+ * Protobuf URL parameter builders for Google Maps internal endpoints.
+ *
+ * Format: `!{field}{type}{value}` — field order is critical.
+ * Pagination: `!7i` = page size, `!8i` = offset (SerpAPI / Maps web client).
+ */
+import { defaultViewportDist } from '../utils/geo.js';
+export function buildSearchPb(params) {
+    const queryEncoded = encodeURIComponent(params.query);
+    const offsetPart = params.offset > 0 ? `!8i${params.offset}` : '';
+    // Live browser capture: !22m5!1s{psi}!7e81!14m1!3s{psi}!15i9937
+    const psiPart = params.psi ? `!22m5!1s${params.psi}!7e81!14m1!3s${params.psi}!15i9937` : '';
+    return (`!1s${queryEncoded}` +
+        `!4m8!1m3!1d${params.viewportDist}!2d${params.lng}!3d${params.lat}` +
+        `!3m2!1i1024!2i768!4f13.1` +
+        `!7i${params.resultsCount}${offsetPart}` +
+        `!10b1` +
+        `!12m57!1m5!18b1!30b1!31m1!1b1!34e1` +
+        `!2m4!5m1!6e2!20e3!39b1` +
+        `!6m29!32i1!49b1!63m0!66b1!74i${params.maxRadius}` +
+        `!85b1!114b1!149b1!206b1!209b1!212b1!215b1!216b1!222b1!223b1!232b1!234b1!235b1!246b1!253b1!260b1!266b1!270b1!273b1!280b1!281b1!286b1!291m0!302i300!303i100` +
+        `!10b1!12b1!13b1!14b1!16b1!17m1!3e1!20m4!5e2!6b1!8b1!14b1!46m1!1b0!96b1!99b1` +
+        `!19m4!2m3!1i360!2i120!4i8` +
+        psiPart);
+}
+export function buildSearchUrl(params) {
+    const queryUrl = encodeURIComponent(params.query).replace(/%20/g, '+');
+    const viewportDist = params.viewportDist ?? defaultViewportDist(params.lat, params.zoom ?? 15);
+    const pb = buildSearchPb({
+        query: params.query,
+        lat: params.lat,
+        lng: params.lng,
+        resultsCount: params.resultsCount,
+        maxRadius: params.maxRadius,
+        viewportDist,
+        offset: params.offset,
+        psi: params.psi,
+    });
+    return (`https://www.google.com/search` +
+        `?tbm=map&authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&q=${queryUrl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+/**
+ * Place preview pb — requests photos, hours, phone, categories, embedded review snippets.
+ */
+export function buildPlaceDetailPb(params) {
+    return (`!1m14!1s${params.hexId}` +
+        `!3m9!1m3!1d5000!2d${params.lng}!3d${params.lat}!2m0!3m2!1i1024!2i768!4f13.1` +
+        `!4m2!3d${params.lat}!4d${params.lng}` +
+        `!13m1!2m0` +
+        `!15m47!1m8!4e2!18m5!3b0!6b0!14b1!17b1!20b1!20e2!4b1` +
+        `!10m1!8e3!11m1!3e1!17b1!20m2!1e3!1e6!24b1!25b1!26b1!29b1` +
+        `!30m1!2b1!36b1!43b1!52b1!55b1!56m1!1b1` +
+        `!65m5!3m4!1m3!1m2!1i224!2i298` +
+        `!22m1!1e81!29m0!30m6!3b1!6m1!2b1!7m1!2b1!9b1!32b1!37i771`);
+}
+/** Extended place pb with amenities and accessibility fields. */
+export function buildPlaceRichPb(params) {
+    const namePlus = params.name.replace(/ /g, '+');
+    const ftidPart = params.ftid ? `!15m2!1m1!4s${params.ftid}` : '';
+    // `!1mN` declares how many following groups belong to field 1: 14 for
+    // hex+name+viewport+coords, plus 3 more (!15m2!1m1!4s) when an ftid is present.
+    // Getting N wrong makes the endpoint reject the request with HTTP 400.
+    const groupCount = params.ftid ? 17 : 14;
+    return (`!1m${groupCount}` +
+        `!1s${params.hexId}` +
+        `!2s${namePlus}` +
+        `!3m8!1m3!1d3022.7!2d${params.lng}!3d${params.lat}!3m2!1i1024!2i768!4f13.1` +
+        `!4m2!3d${params.lat}!4d${params.lng}` +
+        ftidPart +
+        '!12m4!2m3!1i360!2i120!4i8' +
+        '!13m57!2m2!1i203!2i100!3m2!2i4!5b1' +
+        '!6m6!1m2!1i86!2i86!1m2!1i408!2i240' +
+        '!7m33!1m3!1e1!2b0!3e3!1m3!1e2!2b1!3e2!1m3!1e2!2b0!3e3!1m3!1e8!2b0!3e3!1m3!1e10!2b0!3e3!1m3!1e10!2b1!3e2!1m3!1e10!2b0!3e4!1m3!1e9!2b1!3e2!2b1!9b0' +
+        '!15m8!1m7!1m2!1m1!1e2!2m2!1i195!2i195!3i20' +
+        '!15m108!1m29!13m9!2b1!3b1!4b1!6i1!8b1!9b1!14b1!20b1!25b1' +
+        '!18m18!3b1!4b1!5b1!6b1!13b1!14b1!17b1!21b1!22b1!27m1!1b0!28b0!30b1!32b1!33m1!1b1!34b1!36e2' +
+        '!10m1!8e3!11m1!3e1!14m1!3b0!17b1!20m2!1e3!1e6!24b1!25b1!26b1!27b1!29b1!30m1!2b1!36b1!37b1' +
+        '!39m3!2m2!2i1!3i1!43b1!52b1!54m1!1b1!55b1!56m1!1b1!61m2!1m1!1e1!65m5!3m4!1m3!1m2!1i224!2i298' +
+        '!72m22!1m8!2b1!5b1!7b1!12m4!1b1!2b1!4m1!1e1!4b1!8m10!1m6!4m1!1e1!4m1!1e3!4m1!1e4!3sother_user_google_review_posts__and__hotel_and_vr_partner_review_posts!6m1!1e1!9b1' +
+        '!89b1!98m3!1b1!2b1!3b1!103b1!113b1!114m3!1b1!2m1!1b1!117b1!122m1!1b1!126b1!127b1' +
+        '!21m0!22m1!1e81' +
+        '!30m8!3b1!6m2!1b1!2b1!7m2!1e3!2b1!9b1' +
+        '!34m5!7b1!10b1!14b1!15m1!1b0' +
+        '!37i763');
+}
+/**
+ * Place preview pb captured verbatim from a live browser session.
+ *
+ * Only the hex id is required — the browser sends no name or coordinates.
+ * Captured via `npm run capture:browser-rpc` (see tests/fixtures/live-pb-capture.json).
+ */
+export function buildPlaceLivePb(params) {
+    const psiPart = params.psi ? `!14m2!1s${params.psi}!7e81` : '';
+    return (`!1m1!1s${params.hexId}` +
+        '!12m4!2m3!1i360!2i120!4i8' +
+        '!13m57!2m2!1i203!2i100!3m2!2i4!5b1' +
+        '!6m6!1m2!1i86!2i86!1m2!1i408!2i240' +
+        '!7m33!1m3!1e1!2b0!3e3!1m3!1e2!2b1!3e2!1m3!1e2!2b0!3e3!1m3!1e8!2b0!3e3!1m3!1e10!2b0!3e3!1m3!1e10!2b1!3e2!1m3!1e10!2b0!3e4!1m3!1e9!2b1!3e2!2b1!9b0' +
+        '!15m8!1m7!1m2!1m1!1e2!2m2!1i195!2i195!3i20' +
+        psiPart +
+        '!15m110!1m28!13m9!2b1!3b1!4b1!6i1!8b1!9b1!14b1!20b1!25b1' +
+        '!18m17!3b1!4b1!5b1!6b1!9b1!13b1!14b1!17b1!20b1!21b1!22b1!30b1!32b1!33m1!1b1!34b1!36e2' +
+        '!10m1!8e3!11m1!3e1!17b1!20m2!1e3!1e6!24b1!25b1!26b1!27b1!29b1!30m1!2b1!36b1!37b1' +
+        '!39m3!2m2!2i1!3i1!43b1!52b1!54m1!1b1!55b1!56m1!1b1!61m2!1m1!1e1!65m5!3m4!1m3!1m2!1i224!2i298' +
+        '!72m22!1m8!2b1!5b1!7b1!12m4!1b1!2b1!4m1!1e1!4b1!8m10!1m6!4m1!1e1!4m1!1e3!4m1!1e4!3sother_user_google_review_posts__and__hotel_and_vr_partner_review_posts!6m1!1e1!9b1' +
+        '!89b1!90m2!1m1!1e2!98m3!1b1!2b1!3b1!103b1!113b1!114m3!1b1!2m1!1b1!117b1!122m1!1b1!126b1!127b1!128m1!1b1' +
+        '!22m1!1e81' +
+        '!29m0' +
+        '!30m6!3b1!6m1!2b1!7m1!2b1!9b1' +
+        '!34m5!7b1!10b1!14b1!15m1!1b0' +
+        '!37i788');
+}
+/** @deprecated Use buildPlaceDetailPb */
+export const buildPlacePb = buildPlaceRichPb;
+export function buildPlaceUrl(params) {
+    const requested = params.mode ?? 'live';
+    const hasCoords = params.lat != null && params.lng != null;
+    // `detail`/`rich` templates embed coordinates (and `rich` a name); fall back to
+    // the live hex-only template when the caller has just an id.
+    const mode = requested !== 'live' && (!hasCoords || (requested === 'rich' && !params.name))
+        ? 'live'
+        : requested;
+    let pb;
+    switch (mode) {
+        case 'live':
+            pb = buildPlaceLivePb({ hexId: params.hexId, psi: params.psi });
+            break;
+        case 'rich':
+            pb = buildPlaceRichPb({
+                hexId: params.hexId,
+                name: params.name,
+                lat: params.lat,
+                lng: params.lng,
+                ftid: params.ftid,
+            });
+            break;
+        case 'detail':
+            pb = buildPlaceDetailPb({ hexId: params.hexId, lat: params.lat, lng: params.lng });
+            break;
+        default: {
+            const exhaustive = mode;
+            throw new Error(`Unhandled place pb mode: ${String(exhaustive)}`);
+        }
+    }
+    const queryPart = params.name ? `&q=${params.name.replace(/ /g, '+')}` : '';
+    return (`https://www.google.com/maps/preview/place` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        queryPart +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+export function buildReviewsPb(params) {
+    const limit = params.limit ?? 10;
+    const token = params.paginationToken ?? '';
+    return (`!1m6!1s${params.hexId}` +
+        `!6m4!4m1!1e1!4m1!1e3` +
+        `!2m2!1i${limit}!2s${token}` +
+        `!5m2!1s!7e81` +
+        `!8m9!2b1!3b1!5b1!7b1!12m4!1b1!2b1!4m1!1e1` +
+        `!11m4!1e3!2e1!6m1!1i2` +
+        `!13m1!1e1`);
+}
+export function buildReviewsUrl(params) {
+    const pb = buildReviewsPb(params);
+    return (`https://www.google.com/maps/rpc/listugcposts` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+export function buildLocalPostsPb(params) {
+    if (params.ftid) {
+        return `!1m2!1s${params.hexId}!2s${params.ftid}`;
+    }
+    return `!1m1!1s${params.hexId}`;
+}
+export function buildLocalPostsUrl(params) {
+    const pb = buildLocalPostsPb(params);
+    return (`https://www.google.com/maps/preview/localposts` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+/**
+ * Travel-mode codes for the `!20m6!1e{n}` block, verified against Google's own pb by
+ * scraping /maps/dir/ with data=!3e{n} for each mode (npm run probe:directions-modes):
+ *
+ *   1e0 driving   14 min / 4.5 km / 23 steps
+ *   1e1 bicycling  (Google itself returns no route for many city pairs)
+ *   1e2 walking   58 min / 4.0 km / 17 steps
+ *   1e3 transit   34 min / 5.4 km / 15 steps
+ *
+ * `!2e3` matches what Google emits for every mode; the previous `!2e1` combined with a
+ * bogus `1e6` walking code made walking return an empty response.
+ */
+const DIRECTIONS_MODE_CODE = {
+    driving: 0,
+    bicycling: 1,
+    walking: 2,
+    transit: 3,
+};
+function directionsModeBlock(mode) {
+    return `!20m6!1e${DIRECTIONS_MODE_CODE[mode]}!2e3!5e2!6b1!8b1!14b1!46m1!1b0!96b1!99b1`;
+}
+/** `data=!3e{n}` suffix for /maps/dir/ page URLs — same code space as `!1e{n}`. */
+export function directionsDataSuffix(mode) {
+    return `data=!4m2!4m1!3e${DIRECTIONS_MODE_CODE[mode]}`;
+}
+const DIRECTIONS_COMMON_SUFFIX = '!6m60!1m5!18b1!30b1!31m1!1b1!34e1!2m4!5m1!6e2!20e3!39b1' +
+    '!6m30!32i1!49b1!63m0!66b1!85b1!114b1!149b1!206b1!209b1!212b1!216b1!222b1!223b1!232b1!234b1!235b1!239b1!246b1!253b1!260b1!266b1!270b1!273b1!277b1!280b1!281b1!286b1!291m0!302i300!303i100' +
+    '!10b1!12b1!13b1!14b1!16b1!17m1!3e1';
+const DIRECTIONS_PANEL_SUFFIX = '!20m28!1m6!1m2!1i0!2i0!2m2!1i530!2i768!1m6!1m2!1i974!2i0!2m2!1i1024!2i768!1m6!1m2!1i0!2i0!2m2!1i1024!2i20!1m6!1m2!1i0!2i748!2m2!1i1024!2i768!27b1!40i788!47m2!8b1!10e2';
+function directionsEndpointPart(value) {
+    if (typeof value === 'string') {
+        const pipe = value.indexOf('|');
+        if (pipe > 0) {
+            const hexId = value.slice(0, pipe);
+            const ftid = value.slice(pipe + 1);
+            return `!1m2!1s${hexId}!2s${encodeURIComponent(ftid)}`;
+        }
+        if (value.includes(':')) {
+            return `!1m2!1s${value}!2s${encodeURIComponent(value)}`;
+        }
+        if (value.startsWith('/g/')) {
+            const encoded = encodeURIComponent(value);
+            return `!1m2!1s${encoded}!2s${encoded}`;
+        }
+        return `!1s${encodeURIComponent(value.replace(/ /g, '+'))}`;
+    }
+    return `!1m4!3m2!3d${value.lat}!4d${value.lng}!6e2`;
+}
+function directionsViewportBlock(endpoints, mode) {
+    const coords = endpoints.filter((e) => typeof e === 'object');
+    if (coords.length >= 2) {
+        const lats = coords.map((c) => c.lat);
+        const lngs = coords.map((c) => c.lng);
+        const midLat = (Math.min(...lats) + Math.max(...lats)) / 2;
+        const midLng = (Math.min(...lngs) + Math.max(...lngs)) / 2;
+        const span = Math.max(Math.max(...lats) - Math.min(...lats), Math.max(...lngs) - Math.min(...lngs));
+        const dist = Math.max(defaultViewportDist(midLat, 13) * 4, span * 111_000 * 2);
+        if (mode === 'walking') {
+            return (`!3m12!1m3!1d${dist}!2d${midLng}!3d${midLat}` +
+                `!2m3!1f0!2f0!3f0!3m2!1i1024!2i768!4f13.1`);
+        }
+        return `!3m8!1m3!1d${dist}!2d${midLng}!3d${midLat}!3m2!1i1024!2i768!4f13.1`;
+    }
+    return `!3m8!1m3!1d5000!2d0!3d0!3m2!1i1024!2i768!4f13.1`;
+}
+function directionsEndpointChain(origin, destination, waypoints) {
+    const parts = [directionsEndpointPart(origin)];
+    for (const waypoint of waypoints ?? []) {
+        parts.push(directionsEndpointPart(waypoint.location));
+    }
+    parts.push(directionsEndpointPart(destination));
+    return parts.join('');
+}
+export function buildDirectionsPb(params) {
+    const mode = params.mode ?? 'driving';
+    const modeBlock = directionsModeBlock(mode);
+    const chain = directionsEndpointChain(params.origin, params.destination, params.waypoints);
+    const endpoints = [
+        params.origin,
+        ...(params.waypoints ?? []).map((w) => w.location),
+        params.destination,
+    ];
+    const viewport = directionsViewportBlock(endpoints, mode);
+    return chain + viewport + DIRECTIONS_COMMON_SUFFIX + modeBlock + DIRECTIONS_PANEL_SUFFIX;
+}
+export function buildDirectionsUrls(params) {
+    return [
+        `https://www.google.com/maps/preview/directions` +
+            `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+            `&pb=${encodeURIComponent(buildDirectionsPb(params))}`,
+    ];
+}
+export function buildKnowledgePbVariants(params) {
+    const variants = [`!1m1!1s${params.hexId}`];
+    if (params.ftid) {
+        variants.push(`!1m2!1s${params.hexId}!2s${params.ftid}`);
+        variants.push(`!1m2!1s${params.ftid}!2s${params.hexId}`);
+    }
+    if (params.placeId) {
+        variants.push(`!1m1!1s${params.placeId}`);
+    }
+    return variants;
+}
+export function buildKnowledgeUrl(params) {
+    return buildKnowledgePbVariants(params).map((pb) => `https://www.google.com/maps/rpc/getknowledgeentity` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+//# sourceMappingURL=pb-builders.js.map

package/dist/rpc/pb-builders.js.map

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

package/dist/rpc/photo-category-tokens.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Gallery tab metadata for MapsPhotoService.ListEntityPhotos (hspqX).
+ *
+ * Server-side tab selection does NOT work outside the browser. A token belongs at
+ * batchexecute arg[4][25][0][0] as a base64 protobuf (outer field 1 -> inner field 3 =
+ * enum value), and `CgIYIA==` (field 3 = 32, "Food & drink") was captured verbatim from a
+ * headless tab click — yet replaying that exact token from Node returns batchexecute `[3]`
+ * while the identical request without it succeeds. A sweep of field-3 values
+ * 8/16/24/32/40/48/56/64 returned `[3]` for every one (2026-07-31), so this is not a
+ * matter of finding the right number: something session-bound in the browser request is
+ * missing. Categories are therefore filtered client-side from row fields instead — the
+ * same conclusion the search filters and review filters reached.
+ */
+import type { PhotoCategory, PlacePhoto } from '../types/photos.js';
+/** Gallery tab id -> human label (from response slot [8] when labels are absent). */
+export declare const PHOTO_TAB_ID_LABELS: Record<number, string>;
+/** The one token observed in a real browser request. Kept as evidence; rejected by the server from Node. */
+export declare const CAPTURED_FOOD_CATEGORY_TOKEN = "CgIYIA==";
+/** Encode `{ field, value }` as a category token (matches the captured CgIYIA== layout). */
+export declare function encodePhotoCategoryToken(field: number, value: number): string;
+/**
+ * Categories that can be honoured client-side, because the row itself carries the
+ * discriminator. Everything else depends on a server-side tab we cannot select.
+ */
+export declare const CLIENT_FILTERABLE_CATEGORIES: readonly PhotoCategory[];
+export declare function isClientFilterableCategory(category: PhotoCategory): boolean;
+/** Filter fetched rows down to a category using only fields present on the row. */
+export declare function filterPhotosByCategory(photos: PlacePhoto[], category: PhotoCategory): PlacePhoto[];
+//# sourceMappingURL=photo-category-tokens.d.ts.map

package/dist/rpc/photo-category-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo-category-tokens.d.ts","sourceRoot":"","sources":["../../src/rpc/photo-category-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEpE,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAYtD,CAAC;AAEF,4GAA4G;AAC5G,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAEvD,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7E;AAED;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,SAAS,aAAa,EAIhE,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAE3E;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,aAAa,GAAG,UAAU,EAAE,CAuBlG"}

package/dist/rpc/photo-category-tokens.js

@@ -0,0 +1,97 @@
+/**
+ * Gallery tab metadata for MapsPhotoService.ListEntityPhotos (hspqX).
+ *
+ * Server-side tab selection does NOT work outside the browser. A token belongs at
+ * batchexecute arg[4][25][0][0] as a base64 protobuf (outer field 1 -> inner field 3 =
+ * enum value), and `CgIYIA==` (field 3 = 32, "Food & drink") was captured verbatim from a
+ * headless tab click — yet replaying that exact token from Node returns batchexecute `[3]`
+ * while the identical request without it succeeds. A sweep of field-3 values
+ * 8/16/24/32/40/48/56/64 returned `[3]` for every one (2026-07-31), so this is not a
+ * matter of finding the right number: something session-bound in the browser request is
+ * missing. Categories are therefore filtered client-side from row fields instead — the
+ * same conclusion the search filters and review filters reached.
+ */
+/** Gallery tab id -> human label (from response slot [8] when labels are absent). */
+export const PHOTO_TAB_ID_LABELS = {
+    1: 'All',
+    2: 'Latest',
+    3: 'Videos',
+    4: 'Menu',
+    5: 'Food & drink',
+    6: 'Interior',
+    7: 'Exterior',
+    8: 'Vibe',
+    9: 'By owner',
+    10: 'By visitor',
+    11: 'Street View & 360°',
+};
+/** The one token observed in a real browser request. Kept as evidence; rejected by the server from Node. */
+export const CAPTURED_FOOD_CATEGORY_TOKEN = 'CgIYIA==';
+/** Encode `{ field, value }` as a category token (matches the captured CgIYIA== layout). */
+export function encodePhotoCategoryToken(field, value) {
+    const tag = (field << 3) | 0;
+    const inner = Buffer.from([tag, value]);
+    return Buffer.concat([Buffer.from([0x0a, inner.length]), inner]).toString('base64');
+}
+/**
+ * Categories that can be honoured client-side, because the row itself carries the
+ * discriminator. Everything else depends on a server-side tab we cannot select.
+ */
+export const CLIENT_FILTERABLE_CATEGORIES = [
+    'all',
+    'videos',
+    'street_view',
+];
+export function isClientFilterableCategory(category) {
+    return CLIENT_FILTERABLE_CATEGORIES.includes(category);
+}
+/** Filter fetched rows down to a category using only fields present on the row. */
+export function filterPhotosByCategory(photos, category) {
+    switch (category) {
+        case 'all':
+            return photos;
+        case 'videos':
+            return photos.filter((photo) => photo.isVideo);
+        case 'street_view':
+            return photos.filter((photo) => photo.isStreetView || photo.panoId != null);
+        case 'latest':
+        case 'interior':
+        case 'exterior':
+        case 'menu':
+        case 'food':
+        case 'by_owner':
+        case 'by_visitor':
+            return photos.filter((photo) => photo.categoryLabel != null && matchesLabel(photo.categoryLabel, category));
+        default: {
+            const exhaustive = category;
+            throw new Error(`Unhandled photo category: ${String(exhaustive)}`);
+        }
+    }
+}
+function matchesLabel(label, category) {
+    const normalized = label.toLowerCase();
+    switch (category) {
+        case 'interior':
+            return normalized.includes('interior');
+        case 'exterior':
+            return normalized.includes('exterior');
+        case 'menu':
+            return normalized.includes('menu');
+        case 'food':
+            return normalized.includes('food') || normalized.includes('drink');
+        case 'by_owner':
+            return normalized.includes('owner');
+        case 'by_visitor':
+            return normalized.includes('visitor');
+        case 'latest':
+        case 'all':
+        case 'videos':
+        case 'street_view':
+            return true;
+        default: {
+            const exhaustive = category;
+            throw new Error(`Unhandled photo category label match: ${String(exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=photo-category-tokens.js.map

package/dist/rpc/photo-category-tokens.js.map

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

package/dist/rpc/photos-pb.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Protobuf builders for `/maps/rpc/photo/listentityphotos` — place (entity) photo sets.
+ *
+ * Entity mode uses `!1e2` with the hex feature id in `!6m3!1s{hexId}!7e81!15i16698`
+ * (veTypeId 16698 = MapsPhotoService entity type 2). Location/nearby mode remains
+ * `!1e3` with `!9m2!2d…!3d…!10d…` and is not used for place galleries.
+ */
+import type { PhotoCategory } from '../types/photos.js';
+/** Pb body for place entity photo listing. */
+export declare function buildPlacePhotosPb(params: {
+    hexId: string;
+    pageSize?: number;
+    pageToken?: string;
+    category?: PhotoCategory;
+    thumbnailWidth?: number;
+    thumbnailHeight?: number;
+}): string;
+/** Full listentityphotos URL for a place hex id. */
+export declare function buildPlacePhotosUrl(params: {
+    hexId: string;
+    hl: string;
+    gl: string;
+    pageSize?: number;
+    pageToken?: string;
+    category?: PhotoCategory;
+    thumbnailWidth?: number;
+    thumbnailHeight?: number;
+}): string;
+//# sourceMappingURL=photos-pb.d.ts.map

package/dist/rpc/photos-pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photos-pb.d.ts","sourceRoot":"","sources":["../../src/rpc/photos-pb.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AA2DxD,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAYT;AAED,oDAAoD;AACpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAOT"}