googlemaps-kit 0.1.0

package/dist/services/timezone.js

@@ -0,0 +1,91 @@
+import { find as findTimezones } from 'geo-tz';
+import { buildTimezoneResult, extractTimezoneFromGeocodeResults, localityQueriesFromReverseHit, } from '../parsers/timezone-geocode.js';
+export class TimezoneService {
+    geocode;
+    hl;
+    gl;
+    constructor(geocode, config) {
+        this.geocode = geocode;
+        this.hl = config.hl ?? 'en';
+        this.gl = config.gl ?? 'us';
+    }
+    /**
+     * Resolve IANA timezone for coordinates.
+     *
+     * Default path is offline `geo-tz` polygon lookup (~1 ms) — matches Time Zone API
+     * latency without a network hop. Pass `source: 'geocode'` to force Google's
+     * `[14][30]` field via reverse (+ optional forward) geocode (~240–860 ms).
+     */
+    async get(options, at = new Date()) {
+        const source = options.source ?? 'offline';
+        if (source === 'offline') {
+            try {
+                const ids = findTimezones(options.lat, options.lng);
+                const timeZoneId = ids[0];
+                if (timeZoneId) {
+                    const result = buildTimezoneResult(options.lat, options.lng, timeZoneId, at);
+                    return { ...result, timezoneSource: 'geo-tz' };
+                }
+            }
+            catch (error) {
+                return {
+                    lat: options.lat,
+                    lng: options.lng,
+                    status: 'ERROR',
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+            // Fall through to geocode if polygon miss (ocean / disputed edge).
+        }
+        return this.getFromGeocode(options, at);
+    }
+    async getFromGeocode(options, at) {
+        const hl = options.hl ?? this.hl;
+        const gl = options.gl ?? this.gl;
+        try {
+            const reverse = await this.geocode.reverseGeocode(options.lat, options.lng, { hl, gl });
+            const direct = extractTimezoneFromGeocodeResults([
+                reverse.result,
+                ...reverse.alternatives,
+            ]);
+            if (direct) {
+                const result = buildTimezoneResult(options.lat, options.lng, direct, at);
+                return { ...result, timezoneSource: 'google-geocode' };
+            }
+            if (reverse.result) {
+                const queries = localityQueriesFromReverseHit(reverse.result);
+                const forwards = await Promise.all(queries.slice(0, 3).map((query) => this.geocode.geocode(query, {
+                    lat: options.lat,
+                    lng: options.lng,
+                    hl,
+                    gl,
+                })));
+                for (const forward of forwards) {
+                    const tz = extractTimezoneFromGeocodeResults([
+                        forward.result,
+                        ...forward.alternatives,
+                    ]);
+                    if (tz) {
+                        const result = buildTimezoneResult(options.lat, options.lng, tz, at);
+                        return { ...result, timezoneSource: 'google-geocode' };
+                    }
+                }
+            }
+            return {
+                lat: options.lat,
+                lng: options.lng,
+                status: 'NOT_FOUND',
+                error: 'Timezone not present in geocode search payloads for this coordinate',
+            };
+        }
+        catch (error) {
+            return {
+                lat: options.lat,
+                lng: options.lng,
+                status: 'ERROR',
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+//# sourceMappingURL=timezone.js.map

package/dist/services/timezone.js.map

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

package/dist/services/traffic.d.ts

@@ -0,0 +1,12 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { AreaTrafficReport, GetAreaTrafficOptions } from '../types/traffic.js';
+export declare class TrafficService {
+    private http;
+    private config;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    /** Fetch area traffic conditions for a viewport bounding box (batchexecute GetAreaTraffic). */
+    getAreaTraffic(options: GetAreaTrafficOptions): Promise<AreaTrafficReport>;
+    private resolvePsi;
+}
+//# sourceMappingURL=traffic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traffic.d.ts","sourceRoot":"","sources":["../../src/services/traffic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAIpF,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKtD,+FAA+F;IACzF,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAkBlE,UAAU;CAYzB"}

package/dist/services/traffic.js

@@ -0,0 +1,40 @@
+import { extractAreaTraffic } from '../parsers/traffic.js';
+import { buildAreaTrafficArgs } from '../rpc/batch-request-builders.js';
+import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { createRpcClient } from '../rpc/batch-rpc.js';
+import { parseMapsPageTokens } from '../rpc/app-options.js';
+import { cookiesToHeader } from '../auth/session.js';
+export class TrafficService {
+    http;
+    config;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.config = config;
+    }
+    /** Fetch area traffic conditions for a viewport bounding box (batchexecute GetAreaTraffic). */
+    async getAreaTraffic(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const psi = options.psi ?? (await this.resolvePsi());
+        const data = await rpc.call(BATCH_SERVICES.AREA_TRAFFIC, buildAreaTrafficArgs({
+            psi,
+            swLat: options.swLat,
+            swLng: options.swLng,
+            neLat: options.neLat,
+            neLng: options.neLng,
+        }));
+        return extractAreaTraffic(data);
+    }
+    async resolvePsi() {
+        const html = await fetch('https://www.google.com/maps/place/@12.9168,77.6450,14z', {
+            headers: {
+                'User-Agent': this.http.getUserAgent(),
+                Cookie: cookiesToHeader(this.http.getCookieJar()),
+                Accept: 'text/html',
+            },
+            redirect: 'follow',
+        }).then((r) => r.text());
+        const tokens = parseMapsPageTokens(html);
+        return tokens.psi ?? tokens.kEI ?? 'anonymous';
+    }
+}
+//# sourceMappingURL=traffic.js.map

package/dist/services/traffic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traffic.js","sourceRoot":"","sources":["../../src/services/traffic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IACjB,MAAM,CAAc;IAE5B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,+FAA+F;IAC/F,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,YAAY,EAC3B,oBAAoB,CAAC;YACnB,GAAG;YACH,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CACH,CAAC;QAEF,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,wDAAwD,EAAE;YACjF,OAAO,EAAE;gBACP,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;gBACtC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACjD,MAAM,EAAE,WAAW;aACpB;YACD,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC;IACjD,CAAC;CACF"}

package/dist/services/transit.d.ts

@@ -0,0 +1,22 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { GetStationDeparturesOptions, ListTransitLinesOptions, TransitStationBoard } from '../types/transit.js';
+import type { MapsPreviewPlaceResponse } from '../types/protobuf.js';
+export declare class TransitService {
+    private http;
+    private config;
+    private places;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    /**
+     * Live departure board for a transit station (place preview placeData[62]).
+     * Requires a rich/detail preview with coordinates for full schedule rows.
+     */
+    getStationDepartures(options: GetStationDeparturesOptions): Promise<TransitStationBoard>;
+    /**
+     * Probe ListTransitLines batchexecute (currently returns error [3] for anonymous callers).
+     * Exposed for research scripts; prefer getStationDepartures for live schedules.
+     */
+    probeListTransitLines(options: ListTransitLinesOptions): Promise<unknown>;
+}
+export declare function extractTransitBoardFromPreview(data: MapsPreviewPlaceResponse): TransitStationBoard | undefined;
+//# sourceMappingURL=transit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transit.d.ts","sourceRoot":"","sources":["../../src/services/transit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAKtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EACV,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,wBAAwB,EAAiB,MAAM,sBAAsB,CAAC;AAGpF,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAgB;gBAElB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAMtD;;;OAGG;IACG,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsB9F;;;OAGG;IACG,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC;CAiBhF;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,wBAAwB,GAAG,mBAAmB,GAAG,SAAS,CAI9G"}

package/dist/services/transit.js

@@ -0,0 +1,62 @@
+import { extractTransitStationBoard } from '../parsers/transit.js';
+import { buildListTransitLinesArgs } from '../rpc/batch-request-builders.js';
+import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { createRpcClient, isBatchErrorCode, parseBatchPayload } from '../rpc/batch-rpc.js';
+import { PlacesService } from './places.js';
+export class TransitService {
+    http;
+    config;
+    places;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.config = config;
+        this.places = new PlacesService(http, config);
+    }
+    /**
+     * Live departure board for a transit station (place preview placeData[62]).
+     * Requires a rich/detail preview with coordinates for full schedule rows.
+     */
+    async getStationDepartures(options) {
+        const preview = await this.places.fetchPreview({
+            hexId: options.hexId,
+            name: options.name,
+            lat: options.lat,
+            lng: options.lng,
+            mode: options.mode ?? 'rich',
+        });
+        const placeData = preview.data[6];
+        if (!placeData) {
+            throw new Error('Place preview returned no placeData node');
+        }
+        const board = extractTransitStationBoard(placeData);
+        if (!board) {
+            throw new Error('No transit departure board in place preview (placeData[62] absent or empty)');
+        }
+        return board;
+    }
+    /**
+     * Probe ListTransitLines batchexecute (currently returns error [3] for anonymous callers).
+     * Exposed for research scripts; prefer getStationDepartures for live schedules.
+     */
+    async probeListTransitLines(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const data = await rpc.call(BATCH_SERVICES.LIST_TRANSIT_LINES, buildListTransitLinesArgs({
+            lineHexId: options.lineHexId,
+            lat: options.lat,
+            lng: options.lng,
+        }));
+        const parsed = parseBatchPayload(data);
+        if (isBatchErrorCode(parsed)) {
+            const code = Array.isArray(parsed) ? parsed[0] : undefined;
+            throw new Error(`ListTransitLines returned batchexecute error [${String(code)}]`);
+        }
+        return parsed;
+    }
+}
+export function extractTransitBoardFromPreview(data) {
+    const placeData = data[6];
+    if (!placeData)
+        return undefined;
+    return extractTransitStationBoard(placeData);
+}
+//# sourceMappingURL=transit.js.map

package/dist/services/transit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transit.js","sourceRoot":"","sources":["../../src/services/transit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQ3F,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,cAAc;IACjB,IAAI,CAAa;IACjB,MAAM,CAAc;IACpB,MAAM,CAAgB;IAE9B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB,CAAC,OAAoC;QAC7D,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC;YAC7C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,MAAM;SAC7B,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAA8B,CAAC;QAC/D,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,MAAM,KAAK,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,qBAAqB,CAAC,OAAgC;QAC1D,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,kBAAkB,EACjC,yBAAyB,CAAC;YACxB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CACH,CAAC;QACF,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,iDAAiD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpF,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAAC,IAA8B;IAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAA8B,CAAC;IACvD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,0BAA0B,CAAC,SAAS,CAAC,CAAC;AAC/C,CAAC"}

package/dist/services/ugc-aggregates.d.ts

@@ -0,0 +1,17 @@
+import { HttpClient } from '../client/http-client.js';
+import type { GMapsConfig } from '../types/common.js';
+import type { GetPlaceUgcAggregatesOptions, PlaceUgcAggregates } from '../types/ugc-aggregates.js';
+export declare class UgcAggregatesService {
+    private http;
+    private config;
+    constructor(http: HttpClient, config?: GMapsConfig);
+    /**
+     * Place review/Q&A aggregate stats (rating, star distribution, total count).
+     * Requires a valid Maps session psi token in the request context array.
+     */
+    getPlaceAggregates(options: GetPlaceUgcAggregatesOptions & {
+        raw?: boolean;
+    }): Promise<PlaceUgcAggregates>;
+    private resolvePsi;
+}
+//# sourceMappingURL=ugc-aggregates.d.ts.map

package/dist/services/ugc-aggregates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ugc-aggregates.d.ts","sourceRoot":"","sources":["../../src/services/ugc-aggregates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAQtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEnG,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAc;gBAEhB,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,WAAgB;IAKtD;;;OAGG;IACG,kBAAkB,CACtB,OAAO,EAAE,4BAA4B,GAAG;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,GACxD,OAAO,CAAC,kBAAkB,CAAC;YAgBhB,UAAU;CAiBzB"}

package/dist/services/ugc-aggregates.js

@@ -0,0 +1,46 @@
+import { cookiesToHeader } from '../auth/session.js';
+import { extractPlaceUgcAggregates } from '../parsers/ugc-aggregates.js';
+import { parseMapsPageTokens } from '../rpc/app-options.js';
+import { buildPlaceUgcAggregatesArgs } from '../rpc/batch-request-builders.js';
+import { BATCH_SERVICES } from '../rpc/batch-services.js';
+import { createRpcClient, isBatchErrorCode } from '../rpc/batch-rpc.js';
+import { GMapsAuthError } from '../types/common.js';
+export class UgcAggregatesService {
+    http;
+    config;
+    constructor(http, config = {}) {
+        this.http = http;
+        this.config = config;
+    }
+    /**
+     * Place review/Q&A aggregate stats (rating, star distribution, total count).
+     * Requires a valid Maps session psi token in the request context array.
+     */
+    async getPlaceAggregates(options) {
+        const rpc = await createRpcClient(this.http, this.config);
+        const psi = options.psi ?? (await this.resolvePsi());
+        const data = await rpc.call(BATCH_SERVICES.PLACE_UGC_AGGREGATES, buildPlaceUgcAggregatesArgs(options.hexId, psi));
+        if (isBatchErrorCode(data)) {
+            throw new GMapsAuthError('GetPlaceUgcPostAggregates requires a valid Maps session token');
+        }
+        return extractPlaceUgcAggregates(data, options);
+    }
+    async resolvePsi() {
+        const placePath = `/maps/place/@12.9121263,77.6499775,14z`;
+        const html = await fetch(`https://www.google.com${placePath}`, {
+            headers: {
+                'User-Agent': this.http.getUserAgent(),
+                Cookie: cookiesToHeader(this.http.getCookieJar()),
+                Accept: 'text/html',
+            },
+            redirect: 'follow',
+        }).then((r) => r.text());
+        const tokens = parseMapsPageTokens(html);
+        const psi = tokens.psi ?? tokens.kEI;
+        if (!psi) {
+            throw new GMapsAuthError('Could not obtain Maps session psi token for UGC aggregates');
+        }
+        return psi;
+    }
+}
+//# sourceMappingURL=ugc-aggregates.js.map

package/dist/services/ugc-aggregates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ugc-aggregates.js","sourceRoot":"","sources":["../../src/services/ugc-aggregates.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIpD,MAAM,OAAO,oBAAoB;IACvB,IAAI,CAAa;IACjB,MAAM,CAAc;IAE5B,YAAY,IAAgB,EAAE,SAAsB,EAAE;QACpD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,kBAAkB,CACtB,OAAyD;QAEzD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAErD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CACzB,cAAc,CAAC,oBAAoB,EACnC,2BAA2B,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAChD,CAAC;QAEF,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,cAAc,CAAC,+DAA+D,CAAC,CAAC;QAC5F,CAAC;QAED,OAAO,yBAAyB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,SAAS,GAAG,wCAAwC,CAAC;QAC3D,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,yBAAyB,SAAS,EAAE,EAAE;YAC7D,OAAO,EAAE;gBACP,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE;gBACtC,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACjD,MAAM,EAAE,WAAW;aACpB;YACD,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACzB,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC;QACrC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,cAAc,CAAC,4DAA4D,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+/** Decoded Maps URL from DecodeUrl batchexecute RPC. */
+export interface DecodedMapsUrl {
+    name?: string;
+    lat?: number;
+    lng?: number;
+    zoom?: number;
+    raw?: unknown;
+}
+export interface DecodeUrlOptions {
+    url: string;
+}
+export interface CreateShortUrlOptions {
+    url: string;
+    /** Maps session psi — required for anonymous CreateShortUrl (from place page HTML). */
+    psi?: string;
+}
+export interface CreateShortUrlResult {
+    shortUrl?: string;
+    raw?: unknown;
+}
+//# sourceMappingURL=batch-url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch-url.d.ts","sourceRoot":"","sources":["../../src/types/batch-url.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf"}

package/dist/types/batch-url.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=batch-url.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"batch-url.js","sourceRoot":"","sources":["../../src/types/batch-url.ts"],"names":[],"mappings":""}

package/dist/types/categories.d.ts

@@ -0,0 +1,43 @@
+/** Google Maps category taxonomy node from LocalRapService.GetCategoryHierarchy. */
+export interface CategoryNode {
+    name: string;
+    gcid?: string;
+    id?: number;
+    children?: CategoryNode[];
+}
+export interface CategorySuggestion {
+    gcid: string;
+    label: string;
+}
+export interface PlaceInfoResult {
+    hexId?: string;
+    entries: Array<{
+        hexId?: string;
+        label?: string;
+    }>;
+}
+export interface PotentialDuplicate {
+    hexId: string;
+    name: string;
+    category?: string;
+    address?: string;
+    rating?: number;
+    reviewCount?: number;
+}
+export interface SignedPlaceUrl {
+    hexId: string;
+    signedPath: string;
+}
+export interface GetCategorySuggestionsOptions {
+    query: string;
+}
+export interface GetPlaceInfoOptions {
+    hexId: string;
+}
+export interface GetPotentialDuplicatesOptions {
+    hexId: string;
+}
+export interface GetSignedUrlOptions {
+    hexId: string;
+}
+//# sourceMappingURL=categories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"categories.d.ts","sourceRoot":"","sources":["../../src/types/categories.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,6BAA6B;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/types/categories.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=categories.js.map

package/dist/types/categories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/types/categories.ts"],"names":[],"mappings":""}