googlemaps-kit 0.1.0

package/dist/rpc/photos-pb.js

@@ -0,0 +1,73 @@
+/**
+ * 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.
+ */
+const ENTITY_VE_TYPE = 16698;
+const DEFAULT_FILTERS = '!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' +
+    '!8m2!1m1!1e2!9b0!11m1!4b1';
+/** Toggle one filter triplet inside the !7m33 block (2b1 = enabled, 2b0 = disabled). */
+function buildCategoryFilters(category) {
+    if (!category || category === 'all') {
+        return DEFAULT_FILTERS;
+    }
+    const enabled = '!2b1';
+    const disabled = '!2b0';
+    const flags = {
+        all: [],
+        latest: [],
+        interior: [[2, true], [3, false], [8, false], [10, false], [9, false]],
+        exterior: [[2, false], [3, true], [8, false], [10, false], [9, false]],
+        menu: [[2, false], [3, false], [8, true], [10, false], [9, false]],
+        food: [[2, false], [3, false], [8, true], [10, false], [9, false]],
+        videos: [[2, false], [3, false], [8, false], [10, true], [9, false]],
+        street_view: [[2, true], [3, false], [8, false], [10, false], [9, false]],
+        by_owner: [[2, false], [3, false], [8, false], [10, true], [9, false]],
+        by_visitor: [[2, false], [3, false], [8, false], [10, false], [9, true]],
+    };
+    const triplets = {
+        1: '!1m3!1e1!2b0!3e3',
+        2: '!1m3!1e2!2b1!3e2',
+        3: '!1m3!1e2!2b0!3e3',
+        8: '!1m3!1e8!2b0!3e3',
+        10: '!1m3!1e10!2b0!3e3',
+        9: '!1m3!1e9!2b1!3e2',
+    };
+    const ownerTriplet = '!1m3!1e10!2b1!3e2';
+    const visitorTriplet = '!1m3!1e10!2b0!3e4';
+    let block = '!7m33!1m3!1e1!2b0!3e3';
+    for (const [key, on] of flags[category]) {
+        const triplet = triplets[key];
+        block += triplet.replace(on ? disabled : enabled, on ? enabled : disabled);
+    }
+    block += ownerTriplet + visitorTriplet + '!8m2!1m1!1e2!9b0!11m1!4b1';
+    return block;
+}
+function buildPageSizeCluster(pageSize, pageToken) {
+    if (pageToken) {
+        return `!3m3!2i${pageSize}!3s${pageToken}`;
+    }
+    return `!3m2!2i${pageSize}`;
+}
+/** Pb body for place entity photo listing. */
+export function buildPlacePhotosPb(params) {
+    const pageSize = params.pageSize ?? 40;
+    const thumbW = params.thumbnailWidth ?? 203;
+    const thumbH = params.thumbnailHeight ?? 100;
+    const filters = buildCategoryFilters(params.category);
+    const pageCluster = buildPageSizeCluster(pageSize, params.pageToken);
+    return (`!1e2!5m46!2m2!1i${thumbW}!2i${thumbH}${pageCluster}!5b1` +
+        filters +
+        `!6m3!1s${params.hexId}!7e81!15i${ENTITY_VE_TYPE}`);
+}
+/** Full listentityphotos URL for a place hex id. */
+export function buildPlacePhotosUrl(params) {
+    const pb = buildPlacePhotosPb(params);
+    return (`https://www.google.com/maps/rpc/photo/listentityphotos` +
+        `?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+//# sourceMappingURL=photos-pb.js.map

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

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

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

@@ -0,0 +1,26 @@
+export interface BuildRevealPbParams {
+    camLat: number;
+    camLng: number;
+    camZoom?: number;
+    hitLat: number;
+    hitLng: number;
+    ftid: string;
+    width?: number;
+    height?: number;
+    tileX?: number;
+    tileY?: number;
+    tileScale?: number;
+    tileLayer?: number;
+}
+/** Strip leading `/g/` or `/m/` — reveal pb uses bare ftid tokens. */
+export declare function normalizeRevealFtid(ftid: string): string;
+/**
+ * Build pb for GET /maps/preview/reveal.
+ * Wire format from live browser capture (live-flows.json, poi-pin-click flow).
+ */
+export declare function buildRevealPb(params: BuildRevealPbParams): string;
+export declare function buildRevealUrl(params: BuildRevealPbParams & {
+    hl: string;
+    gl: string;
+}): string;
+//# sourceMappingURL=reveal-pb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reveal-pb.d.ts","sourceRoot":"","sources":["../../src/rpc/reveal-pb.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAkBjE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,mBAAmB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM/F"}

package/dist/rpc/reveal-pb.js

@@ -0,0 +1,32 @@
+import { PREVIEW } from './rpc-methods.js';
+import { altitudeFromZoom } from '../utils/geo.js';
+/** Strip leading `/g/` or `/m/` — reveal pb uses bare ftid tokens. */
+export function normalizeRevealFtid(ftid) {
+    return ftid.replace(/^\/g\//, '').replace(/^\/m\//, '').replace(/^\//, '');
+}
+/**
+ * Build pb for GET /maps/preview/reveal.
+ * Wire format from live browser capture (live-flows.json, poi-pin-click flow).
+ */
+export function buildRevealPb(params) {
+    const zoom = params.camZoom ?? 14;
+    const alt = altitudeFromZoom(zoom, params.camLat);
+    const w = params.width ?? 1440;
+    const h = params.height ?? 900;
+    const tx = params.tileX ?? 96;
+    const ty = params.tileY ?? 64;
+    const ts = params.tileScale ?? 1;
+    const tl = params.tileLayer ?? 8;
+    const ftid = normalizeRevealFtid(params.ftid);
+    return (`!2m9!1m3!1d${alt}!2d${params.camLng}!3d${params.camLat}` +
+        `!2m0!3m2!1i${w}!2i${h}!4f13.1` +
+        `!3m2!2d${params.hitLng}!3d${params.hitLat}` +
+        `!4m2!1s${ftid}!7e81` +
+        `!5m5!2m4!1i${tx}!2i${ty}!3i${ts}!4i${tl}`);
+}
+export function buildRevealUrl(params) {
+    const pb = buildRevealPb(params);
+    return (`https://www.google.com${PREVIEW.REVEAL}?authuser=0&hl=${params.hl}&gl=${params.gl}` +
+        `&pb=${encodeURIComponent(pb)}`);
+}
+//# sourceMappingURL=reveal-pb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reveal-pb.js","sourceRoot":"","sources":["../../src/rpc/reveal-pb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAiBnD,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;IAC/B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACjC,MAAM,EAAE,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAE9C,OAAO,CACL,cAAc,GAAG,MAAM,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,MAAM,EAAE;QACzD,cAAc,CAAC,MAAM,CAAC,SAAS;QAC/B,UAAU,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,MAAM,EAAE;QAC5C,UAAU,IAAI,OAAO;QACrB,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAwD;IACrF,MAAM,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CACL,yBAAyB,OAAO,CAAC,MAAM,kBAAkB,MAAM,CAAC,EAAE,OAAO,MAAM,CAAC,EAAE,EAAE;QACpF,OAAO,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAChC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,50 @@
+/**
+ * Maps batchexecute RPC client (notebooklm-kit pattern).
+ */
+import { BatchExecuteClient } from './batch-execute.js';
+import type { GMapsConfig } from '../types/common.js';
+export interface GMapsRpcClientConfig {
+    cookies: string;
+    authToken?: string;
+    buildLabel?: string;
+    sessionId?: string;
+    hl?: string;
+    gl?: string;
+    authUser?: string;
+    debug?: boolean;
+    maxRetries?: number;
+    retryDelay?: number;
+    /** Shares the owning HttpClient's pacing and request counter — see BatchExecuteConfig. */
+    schedule?: <T>(fn: () => Promise<T>) => Promise<T>;
+}
+export declare class GMapsRpcClient {
+    private batchClient;
+    private config;
+    private readonly batchExecutePath;
+    constructor(config: GMapsRpcClientConfig & {
+        batchExecutePath?: string;
+    });
+    /**
+     * Bootstrap RPC client from an HTTP session (scrapes Maps page for SNlM0e / bl / f.sid).
+     */
+    static fromHttpSession(cookieJar: Record<string, string>, userAgent: string, config?: GMapsConfig, schedule?: <T>(fn: () => Promise<T>) => Promise<T>): Promise<GMapsRpcClient>;
+    updateCookies(cookies: string): void;
+    updateAuthToken(authToken: string): void;
+    getAuthToken(): string;
+    /**
+     * Attempt xsrf bootstrap to obtain a batchexecute auth token when SNlM0e is empty.
+     * Returns true when a non-empty token was obtained.
+     */
+    bootstrapAuth(): Promise<boolean>;
+    /**
+     * Execute a batchexecute RPC by service path (e.g. `/MapsViewportService.GetViewportMetadata`)
+     * or legacy short rpcid (e.g. `AvYl1c`).
+     *
+     * Service-path calls work anonymously with browser cookies and omit the `at` field.
+     * Legacy short rpcids still require WIZ `SNlM0e` (signed-in session only).
+     */
+    call(rpcId: string, args: unknown[], urlParams?: Record<string, string>): Promise<unknown>;
+    getBatchExecutePath(): string;
+    getBatchClient(): BatchExecuteClient;
+}
+//# sourceMappingURL=rpc-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../src/rpc/rpc-client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAKxD,OAAO,KAAK,EAAsB,WAAW,EAAW,MAAM,oBAAoB,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;gBAE9B,MAAM,EAAE,oBAAoB,GAAG;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE;IA+BxE;;OAEG;WACU,eAAe,CAC1B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,WAAgB,EACxB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACjD,OAAO,CAAC,cAAc,CAAC;IAiB1B,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKpC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKxC,YAAY,IAAI,MAAM;IAItB;;;OAGG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAUvC;;;;;;OAMG;IACG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBhG,mBAAmB,IAAI,MAAM;IAI7B,cAAc,IAAI,kBAAkB;CAGrC"}

package/dist/rpc/rpc-client.js

@@ -0,0 +1,136 @@
+/**
+ * Maps batchexecute RPC client (notebooklm-kit pattern).
+ */
+import { extractMapsPageTokens } from '../auth/maps-tokens.js';
+import { cookiesToHeader } from '../auth/session.js';
+import { BatchExecuteClient } from './batch-execute.js';
+import { isServicePath } from './batch-services.js';
+import { MAPS_WIZ_UI_APP, RPC_INFRA } from './rpc-methods.js';
+import { defaultBatchexecuteUrlParams } from './xsrf-bootstrap.js';
+import { GMapsAuthError } from '../types/common.js';
+export class GMapsRpcClient {
+    batchClient;
+    config;
+    batchExecutePath;
+    constructor(config) {
+        this.config = config;
+        this.batchExecutePath = config.batchExecutePath ?? '/maps/_/MapsWizUi/';
+        const batchConfig = {
+            host: 'www.google.com',
+            basePath: this.batchExecutePath,
+            app: MAPS_WIZ_UI_APP,
+            authToken: config.authToken ?? '',
+            cookies: config.cookies,
+            headers: {
+                Origin: 'https://www.google.com',
+                Referer: 'https://www.google.com/maps/',
+                'x-same-domain': '1',
+                Accept: '*/*',
+            },
+            urlParams: defaultBatchexecuteUrlParams({
+                hl: config.hl,
+                gl: config.gl,
+                buildLabel: config.buildLabel,
+                sessionId: config.sessionId,
+            }),
+            debug: config.debug,
+            maxRetries: config.maxRetries,
+            retryDelay: config.retryDelay,
+            schedule: config.schedule,
+        };
+        this.batchClient = new BatchExecuteClient(batchConfig);
+    }
+    /**
+     * Bootstrap RPC client from an HTTP session (scrapes Maps page for SNlM0e / bl / f.sid).
+     */
+    static async fromHttpSession(cookieJar, userAgent, config = {}, schedule) {
+        const tokens = await extractMapsPageTokens(cookieJar, userAgent);
+        return new GMapsRpcClient({
+            cookies: cookiesToHeader(cookieJar),
+            authToken: config.authToken ?? tokens.authToken,
+            buildLabel: config.buildLabel ?? tokens.buildLabel,
+            sessionId: config.sessionId ?? tokens.sessionId,
+            batchExecutePath: tokens.batchExecutePath,
+            hl: config.hl,
+            gl: config.gl,
+            debug: config.debug,
+            maxRetries: config.maxRetries,
+            retryDelay: config.retryDelay,
+            schedule,
+        });
+    }
+    updateCookies(cookies) {
+        this.config.cookies = cookies;
+        this.batchClient.updateCookies(cookies);
+    }
+    updateAuthToken(authToken) {
+        this.config.authToken = authToken;
+        this.batchClient.updateAuthToken(authToken);
+    }
+    getAuthToken() {
+        return this.config.authToken ?? '';
+    }
+    /**
+     * Attempt xsrf bootstrap to obtain a batchexecute auth token when SNlM0e is empty.
+     * Returns true when a non-empty token was obtained.
+     */
+    async bootstrapAuth() {
+        try {
+            await this.call(RPC_INFRA.XSRF, []);
+            const token = this.getAuthToken();
+            return token.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Execute a batchexecute RPC by service path (e.g. `/MapsViewportService.GetViewportMetadata`)
+     * or legacy short rpcid (e.g. `AvYl1c`).
+     *
+     * Service-path calls work anonymously with browser cookies and omit the `at` field.
+     * Legacy short rpcids still require WIZ `SNlM0e` (signed-in session only).
+     */
+    async call(rpcId, args, urlParams) {
+        const usesServicePath = isServicePath(rpcId);
+        if (!usesServicePath && !this.config.authToken) {
+            throw new GMapsAuthError('Legacy batchexecute rpcids require an XSRF token (WIZ_global_data.SNlM0e), which ' +
+                'signed-out Google sessions never issue. Use service-path RPCs (see ' +
+                'src/rpc/batch-services.ts) for anonymous access, or pass signed-in cookies ' +
+                'via GMAPS_COOKIES / config.cookies.');
+        }
+        const rpcCall = { id: rpcId, args, urlParams };
+        const response = await this.batchClient.do(rpcCall);
+        if (rpcId === RPC_INFRA.XSRF && response.data) {
+            const token = extractXsrfToken(response.data);
+            if (token) {
+                this.updateAuthToken(token);
+            }
+        }
+        return response.data;
+    }
+    getBatchExecutePath() {
+        return this.batchExecutePath;
+    }
+    getBatchClient() {
+        return this.batchClient;
+    }
+}
+function extractXsrfToken(data) {
+    if (typeof data === 'string') {
+        try {
+            const parsed = JSON.parse(data);
+            if (typeof parsed === 'string' && parsed.length > 8)
+                return parsed;
+            if (Array.isArray(parsed) && typeof parsed[0] === 'string' && parsed[0].length > 8) {
+                return parsed[0];
+            }
+        }
+        catch {
+            if (data.length > 8)
+                return data;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=rpc-client.js.map

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

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