googlemaps-kit 0.4.0 → 0.5.0

package/dist/utils/{chunked-decoder.js → payload.js}

@@ -1,6 +1,84 @@
 /**
- * Chunked response decoder for Google batchexecute format.
+ * Payload plumbing: deep array access, the )]}'-prefixed JSON decoder, and
+ * chunked-transfer reassembly.
  */
+export function safeGet(obj, ...indices) {
+    try {
+        let current = obj;
+        for (const idx of indices) {
+            if (current == null)
+                return undefined;
+            if (Array.isArray(current) && typeof idx === 'number') {
+                if (idx < 0 || idx >= current.length)
+                    return undefined;
+                current = current[idx];
+            }
+            else if (typeof current === 'object' && typeof idx === 'string') {
+                current = current[idx];
+            }
+            else {
+                return undefined;
+            }
+        }
+        return current;
+    }
+    catch {
+        return undefined;
+    }
+}
+import { GMapsParseError } from '../types/common.js';
+const XSSI_PREFIX = ")]}'";
+/**
+ * Strip Google's XSSI prefix and parse the first complete JSON array.
+ * Maps endpoints return `)]}'` followed by nested JSON arrays (protobuf-over-JSON).
+ *
+ * The parsed value is always an array at runtime; an empty body yields `[]`.
+ * Callers should therefore instantiate `T` with an array-compatible wire type
+ * (e.g. `PbNode`) rather than an object type.
+ */
+export function parseGoogleResponse(responseText) {
+    if (!responseText) {
+        return [];
+    }
+    let text = responseText.trim();
+    if (text.startsWith(XSSI_PREFIX)) {
+        text = text.slice(XSSI_PREFIX.length).trim();
+    }
+    if (!text) {
+        return [];
+    }
+    let depth = 0;
+    let start = null;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (char === '[') {
+            if (depth === 0)
+                start = i;
+            depth++;
+        }
+        else if (char === ']') {
+            depth--;
+            if (depth === 0 && start !== null) {
+                try {
+                    return JSON.parse(text.slice(start, i + 1));
+                }
+                catch {
+                    // continue scanning
+                }
+            }
+        }
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new GMapsParseError('Failed to parse Google Maps response', error);
+    }
+}
+export function isValidResponseBody(body) {
+    const stripped = body.startsWith(XSSI_PREFIX) ? body.slice(4).trim() : body.trim();
+    return stripped.length >= 100;
+}
 /**
  * Parse chunked batchexecute response: `\n<size>\n<payload>\n...`
  */
@@ -172,4 +250,4 @@ function extractWrbResponse(chunk) {
     }
     return { index: 0, id: chunk.substring(idStart, idEnd), data: null };
 }
-//# sourceMappingURL=chunked-decoder.js.map
+//# sourceMappingURL=payload.js.map

package/dist/utils/payload.js.map

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

package/dist/utils/place-ref.d.ts

@@ -35,5 +35,32 @@ export declare function resolveDirectionsEndpoints(options: {
     origin: string | Coordinates;
     destination: string | Coordinates;
 };
+/**
+ * Build a `google.com/maps/place/…` referer for a place name.
+ *
+ * Percent-encodes the name so non-ASCII titles (accents, CJK, Indic scripts)
+ * cannot produce a header value `fetch` refuses to serialise as a ByteString.
+ */
+export declare function buildPlaceReferer(name?: string): string;
+export interface CoordFields {
+    latitude?: number;
+    longitude?: number;
+    lat?: number;
+    lng?: number;
+}
+export interface CoordinatesLike {
+    lat: number;
+    lng: number;
+}
+/** Copy latitude↔lat and longitude↔lng so both spellings are populated. */
+export declare function applyCoordAliases<T extends CoordFields>(obj: T): T;
+/**
+ * Normalize any coords-shaped object to `{ lat, lng }`.
+ * Accepts `lat`/`lng` or `latitude`/`longitude`.
+ */
+export declare function toCoordinates(value: CoordFields | {
+    lat: number;
+    lng: number;
+} | null | undefined): CoordinatesLike | undefined;
 export {};
 //# sourceMappingURL=place-ref.d.ts.map

package/dist/utils/place-ref.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"place-ref.d.ts","sourceRoot":"","sources":["../../src/utils/place-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAenE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,kBAAkB,CAiDnE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAClD,MAAM,GAAG,WAAW,CAgCtB;AAED,KAAK,UAAU,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAChC,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;CACrC,GAAG,WAAW,CAQd;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvC,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC/C,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAYtE"}
+{"version":3,"file":"place-ref.d.ts","sourceRoot":"","sources":["../../src/utils/place-ref.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAcnE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,kBAAkB,CAiDnE;AAED,+EAA+E;AAC/E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,GAClD,MAAM,GAAG,WAAW,CAgCtB;AAED,KAAK,UAAU,GAAG;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IAChC,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;CACrC,GAAG,WAAW,CAQd;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACvC,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;CAC/C,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAYtE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAYlE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GACnE,eAAe,GAAG,SAAS,CAa7B"}

package/dist/utils/place-ref.js

@@ -3,7 +3,6 @@
  */
 import { GMapsError } from '../types/common.js';
 import { placeIdToFeatureId } from './ids.js';
-import { toCoordinates } from './coords.js';
 const HEX_ID_RE = /^0x[0-9a-f]+:0x[0-9a-f]+$/i;
 const PLACE_ID_RE = /^ChIJ[\w-]+$/;
 function tryPlaceIdToHex(placeId) {
@@ -106,4 +105,49 @@ export function resolveDirectionsEndpoints(options) {
         destination: resolveRouteEndpoint(destRaw),
     };
 }
+/**
+ * Build a `google.com/maps/place/…` referer for a place name.
+ *
+ * Percent-encodes the name so non-ASCII titles (accents, CJK, Indic scripts)
+ * cannot produce a header value `fetch` refuses to serialise as a ByteString.
+ */
+export function buildPlaceReferer(name) {
+    if (!name)
+        return 'https://www.google.com/maps/';
+    const slug = encodeURIComponent(name.trim()).replace(/%20/g, '+');
+    return `https://www.google.com/maps/place/${slug}/`;
+}
+/** Copy latitude↔lat and longitude↔lng so both spellings are populated. */
+export function applyCoordAliases(obj) {
+    const lat = obj.lat ?? obj.latitude;
+    const lng = obj.lng ?? obj.longitude;
+    if (lat != null) {
+        obj.lat = lat;
+        obj.latitude = lat;
+    }
+    if (lng != null) {
+        obj.lng = lng;
+        obj.longitude = lng;
+    }
+    return obj;
+}
+/**
+ * Normalize any coords-shaped object to `{ lat, lng }`.
+ * Accepts `lat`/`lng` or `latitude`/`longitude`.
+ */
+export function toCoordinates(value) {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const lat = 'lat' in value && typeof value.lat === 'number'
+        ? value.lat
+        : value.latitude;
+    const lng = 'lng' in value && typeof value.lng === 'number'
+        ? value.lng
+        : value.longitude;
+    if (typeof lat !== 'number' || typeof lng !== 'number')
+        return undefined;
+    if (!Number.isFinite(lat) || !Number.isFinite(lng))
+        return undefined;
+    return { lat, lng };
+}
 //# sourceMappingURL=place-ref.js.map

package/dist/utils/place-ref.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "googlemaps-kit",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "TypeScript SDK + Bubble Tea TUI for Google Maps consumer surfaces",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,7 +26,7 @@
     "dist",
     "LICENSE",
     "README.md",
-    "assets/banner.png"
+    ".github/assets/banner.png"
   ],
   "sideEffects": false,
   "engines": {
@@ -38,8 +38,9 @@
     "clean": "rm -rf dist",
     "type-check": "tsc -p tsconfig.check.json --noEmit",
     "prepublishOnly": "npm run clean && npm run build && npm run type-check && npm test",
-    "test": "vitest run",
+    "test": "vitest run tests/unit",
     "test:watch": "vitest",
+    "test:live": "GMAPS_LIVE=1 vitest run tests/live",
     "preexample": "npm run build",
     "example:quick-start": "tsx examples/quick-start.ts",
     "example:search": "tsx examples/search-text.ts",
@@ -51,9 +52,12 @@
     "example:geocode": "tsx examples/geocode.ts",
     "example:suggest": "tsx examples/suggest.ts",
     "example:maps-url": "tsx examples/maps-url.ts",
+    "example:grid-search": "tsx examples/grid-search.ts",
     "examples:all": "npm run build && tsx examples/run-all.ts",
     "verify:all": "tsx scripts/verify-all.ts",
-    "smoke:daily": "tsx scripts/smoke-daily.ts"
+    "smoke:daily": "tsx scripts/smoke-daily.ts",
+    "api:serve": "tsx src/server/api-server.ts",
+    "api:build": "tsc -p tsconfig.server.json"
   },
   "keywords": [
     "google-maps",
@@ -64,7 +68,6 @@
     "google-maps-without-api-key",
     "unofficial-google-maps-api",
     "free-google-maps-api",
-    "reverse-engineering-google-maps",
     "google-maps-reviews-api",
     "google-maps-directions",
     "local-business-scraper",

package/dist/client/product-namespaces.d.ts

@@ -1,30 +0,0 @@
-/**
- * Auth + surface catalog namespaces — product-facing wrappers over kit internals.
- */
-import { type AuthStatusOptions } from '../auth/auth-status.js';
-import type { HttpClient } from './http-client.js';
-import type { AuthStatus, GMapsConfig } from '../types/common.js';
-import { KNOWN_SURFACES, type KnownSurfaceName, type SurfaceInfo, type SurfaceStatus } from '../known-surfaces.js';
-/** Session / cookie status for apps (no secret values returned). */
-export declare class AuthNamespace {
-    private readonly auth;
-    constructor(http: HttpClient, config: GMapsConfig);
-    /** Live or cached auth probe — cookie names/lengths only, never values. */
-    status(options?: AuthStatusOptions): Promise<AuthStatus>;
-    /** One-line summary for logs (`signed-in, cookies=12, …`). */
-    summarize(options?: AuthStatusOptions): Promise<string>;
-}
-/** Catalog of Maps surfaces this kit knows about (working / auth / blocked / …). */
-export declare class SurfacesNamespace {
-    /** All surface names. */
-    list(): KnownSurfaceName[];
-    /** Surfaces filtered by status (`working`, `auth-required`, …). */
-    listByStatus(status: SurfaceStatus): KnownSurfaceName[];
-    /** Metadata for one surface. */
-    get(name: KnownSurfaceName): SurfaceInfo;
-    /** Full catalog object (read-only snapshot). */
-    catalog(): typeof KNOWN_SURFACES;
-    /** Names marked working (anonymous or with documented path). */
-    working(): KnownSurfaceName[];
-}
-//# sourceMappingURL=product-namespaces.d.ts.map

package/dist/client/product-namespaces.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"product-namespaces.d.ts","sourceRoot":"","sources":["../../src/client/product-namespaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EACL,cAAc,EAGd,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,oEAAoE;AACpE,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;gBAEvB,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW;IAOjD,2EAA2E;IAC3E,MAAM,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC;IAIxD,8DAA8D;IACxD,SAAS,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC;CAG9D;AAED,oFAAoF;AACpF,qBAAa,iBAAiB;IAC5B,yBAAyB;IACzB,IAAI,IAAI,gBAAgB,EAAE;IAI1B,mEAAmE;IACnE,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,EAAE;IAIvD,gCAAgC;IAChC,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,WAAW;IAIxC,gDAAgD;IAChD,OAAO,IAAI,OAAO,cAAc;IAIhC,gEAAgE;IAChE,OAAO,IAAI,gBAAgB,EAAE;CAG9B"}

package/dist/client/product-namespaces.js

@@ -1,47 +0,0 @@
-/**
- * Auth + surface catalog namespaces — product-facing wrappers over kit internals.
- */
-import { AuthService, summarizeAuthStatus } from '../auth/auth-status.js';
-import { KNOWN_SURFACES, getSurfaceInfo, listSurfacesByStatus, } from '../known-surfaces.js';
-/** Session / cookie status for apps (no secret values returned). */
-export class AuthNamespace {
-    auth;
-    constructor(http, config) {
-        this.auth = new AuthService(http, {
-            cookies: config.cookies,
-            authToken: config.authToken,
-        });
-    }
-    /** Live or cached auth probe — cookie names/lengths only, never values. */
-    status(options) {
-        return this.auth.getStatus(options);
-    }
-    /** One-line summary for logs (`signed-in, cookies=12, …`). */
-    async summarize(options) {
-        return summarizeAuthStatus(await this.status(options));
-    }
-}
-/** Catalog of Maps surfaces this kit knows about (working / auth / blocked / …). */
-export class SurfacesNamespace {
-    /** All surface names. */
-    list() {
-        return Object.keys(KNOWN_SURFACES);
-    }
-    /** Surfaces filtered by status (`working`, `auth-required`, …). */
-    listByStatus(status) {
-        return listSurfacesByStatus(status);
-    }
-    /** Metadata for one surface. */
-    get(name) {
-        return getSurfaceInfo(name);
-    }
-    /** Full catalog object (read-only snapshot). */
-    catalog() {
-        return KNOWN_SURFACES;
-    }
-    /** Names marked working (anonymous or with documented path). */
-    working() {
-        return listSurfacesByStatus('working');
-    }
-}
-//# sourceMappingURL=product-namespaces.js.map

package/dist/client/product-namespaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"product-namespaces.js","sourceRoot":"","sources":["../../src/client/product-namespaces.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAA0B,MAAM,wBAAwB,CAAC;AAGlG,OAAO,EACL,cAAc,EACd,cAAc,EACd,oBAAoB,GAIrB,MAAM,sBAAsB,CAAC;AAE9B,oEAAoE;AACpE,MAAM,OAAO,aAAa;IACP,IAAI,CAAc;IAEnC,YAAY,IAAgB,EAAE,MAAmB;QAC/C,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,IAAI,EAAE;YAChC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,2EAA2E;IAC3E,MAAM,CAAC,OAA2B;QAChC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,SAAS,CAAC,OAA2B;QACzC,OAAO,mBAAmB,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACzD,CAAC;CACF;AAED,oFAAoF;AACpF,MAAM,OAAO,iBAAiB;IAC5B,yBAAyB;IACzB,IAAI;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAuB,CAAC;IAC3D,CAAC;IAED,mEAAmE;IACnE,YAAY,CAAC,MAAqB;QAChC,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,gCAAgC;IAChC,GAAG,CAAC,IAAsB;QACxB,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,gDAAgD;IAChD,OAAO;QACL,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,gEAAgE;IAChE,OAAO;QACL,OAAO,oBAAoB,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/parsers/elevation-directions.d.ts

@@ -1,18 +0,0 @@
-import type { PbNode } from '../types/protobuf.js';
-import type { ElevationProfileSample, ElevationStatus, ElevationSummary } from '../types/elevation.js';
-/** Delta-decode cumulative distances encoded in directions elevation slot [16][2][6]. */
-export declare function decodeCumulativeDistances(encoded: number[]): number[];
-/**
- * Extract bicycling/walking elevation data from `/maps/preview/directions` payload.
- *
- * Primary block: route alternative `[0][1][i][0][16][2]`.
- * Fallback duplicate: `[0][1][i][17]` (partial on some walking routes).
- */
-export declare function extractDirectionsElevation(data: PbNode): {
-    status: ElevationStatus;
-    summary?: ElevationSummary;
-    profile?: ElevationProfileSample[];
-    pathDistanceMeters?: number;
-    startElevationMeters?: number;
-};
-//# sourceMappingURL=elevation-directions.d.ts.map

package/dist/parsers/elevation-directions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"elevation-directions.d.ts","sourceRoot":"","sources":["../../src/parsers/elevation-directions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAgB/B,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CASrE;AAyDD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG;IACxD,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CA6BA"}

package/dist/parsers/elevation-directions.js

@@ -1,102 +0,0 @@
-import { safeGet } from '../utils/safe-get.js';
-function parseTriplet(node) {
-    if (!Array.isArray(node) || typeof node[0] !== 'number' || !Number.isFinite(node[0])) {
-        return undefined;
-    }
-    const text = typeof node[1] === 'string' ? node[1] : undefined;
-    return { meters: node[0], text };
-}
-/** Delta-decode cumulative distances encoded in directions elevation slot [16][2][6]. */
-export function decodeCumulativeDistances(encoded) {
-    if (encoded.length === 0)
-        return [];
-    let current = encoded[0];
-    const out = [current];
-    for (let i = 1; i < encoded.length; i++) {
-        current += encoded[i];
-        out.push(current);
-    }
-    return out;
-}
-function buildSummary(block) {
-    const min = parseTriplet(block[0]);
-    const max = parseTriplet(block[1]);
-    const start = parseTriplet(block[2]);
-    const end = parseTriplet(block[3]);
-    const gain = parseTriplet(block[4]);
-    const loss = parseTriplet(block[5]);
-    if (!min || !max || !start || !end || !gain || !loss)
-        return undefined;
-    return {
-        minElevationMeters: min.meters,
-        maxElevationMeters: max.meters,
-        startElevationMeters: start.meters,
-        endElevationMeters: end.meters,
-        gainMeters: gain.meters,
-        lossMeters: loss.meters,
-        minElevationText: min.text,
-        maxElevationText: max.text,
-    };
-}
-function buildProfile(block) {
-    const encoded = safeGet(block, 6);
-    const grades = safeGet(block, 7);
-    if (!encoded || encoded.length === 0)
-        return undefined;
-    const distances = decodeCumulativeDistances(encoded);
-    const samples = distances.map((distanceMeters, index) => ({
-        distanceMeters,
-        gradePercent: grades?.[index],
-    }));
-    return samples.length > 0 ? samples : undefined;
-}
-function isElevationBlock(block) {
-    if (!Array.isArray(block))
-        return false;
-    const hasStats = parseTriplet(block[0]) != null && parseTriplet(block[2]) != null;
-    const hasProfile = Array.isArray(block[6]) && block[6].length > 0;
-    return hasStats || hasProfile;
-}
-function collectElevationBlocks(routeInner) {
-    const blocks = [];
-    const nested = safeGet(routeInner, 16, 2);
-    if (isElevationBlock(nested))
-        blocks.push(nested);
-    const flat = safeGet(routeInner, 17);
-    if (isElevationBlock(flat))
-        blocks.push(flat);
-    return blocks;
-}
-/**
- * Extract bicycling/walking elevation data from `/maps/preview/directions` payload.
- *
- * Primary block: route alternative `[0][1][i][0][16][2]`.
- * Fallback duplicate: `[0][1][i][17]` (partial on some walking routes).
- */
-export function extractDirectionsElevation(data) {
-    const alternatives = safeGet(data, 0, 1);
-    if (!Array.isArray(alternatives)) {
-        return { status: 'UNAVAILABLE' };
-    }
-    for (const alt of alternatives) {
-        const routeInner = safeGet(alt, 0);
-        if (!routeInner)
-            continue;
-        for (const block of collectElevationBlocks(routeInner)) {
-            const summary = buildSummary(block);
-            const profile = buildProfile(block);
-            if (!summary && !profile)
-                continue;
-            const pathDistanceMeters = profile && profile.length > 0 ? profile[profile.length - 1].distanceMeters : undefined;
-            return {
-                status: 'OK',
-                summary,
-                profile,
-                pathDistanceMeters,
-                startElevationMeters: summary?.startElevationMeters,
-            };
-        }
-    }
-    return { status: 'UNAVAILABLE' };
-}
-//# sourceMappingURL=elevation-directions.js.map

package/dist/parsers/elevation-directions.js.map

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

package/dist/parsers/passiveassist.d.ts

@@ -1,10 +0,0 @@
-import type { PassiveAssistResult } from '../types/passiveassist.js';
-import type { PbNode } from '../types/protobuf.js';
-/**
- * Parse `/maps/preview/passiveassist` JSON payload.
- *
- * POI chips live at root[7] as a single chip tuple or an array of tuples.
- * Stub responses omit index 7 and only carry cache metadata at root[1].62.
- */
-export declare function extractPassiveAssistChips(data: PbNode): PassiveAssistResult;
-//# sourceMappingURL=passiveassist.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"passiveassist.d.ts","sourceRoot":"","sources":["../../src/parsers/passiveassist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAoCnD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAiB3E"}

package/dist/parsers/passiveassist.js

@@ -1,61 +0,0 @@
-import { safeGet } from '../utils/safe-get.js';
-/** The chipless ~212 B response carries only a personalization cache key at root[1]["62"]. */
-function hasCacheMetadataMarker(root) {
-    const cacheBlock = safeGet(root, 1, '62');
-    if (!cacheBlock)
-        return false;
-    return JSON.stringify(cacheBlock).includes('PERSONALIZED_HISTORY_CACHE_KEY');
-}
-function parseChipEntry(entry) {
-    if (!Array.isArray(entry) || entry.length < 2)
-        return undefined;
-    const name = entry[1];
-    if (typeof name !== 'string' || name.length === 0)
-        return undefined;
-    const chip = { name };
-    const cacheKey = safeGet(entry, 0, 2);
-    if (typeof cacheKey === 'string')
-        chip.cacheKey = cacheKey;
-    const token = entry[4];
-    if (typeof token === 'string')
-        chip.token = token;
-    const weather = entry[5];
-    if (Array.isArray(weather)) {
-        const icon = weather[0];
-        const temp = weather[1];
-        const label = weather[3];
-        if (typeof icon === 'string')
-            chip.weatherIconUrl = icon;
-        if (typeof temp === 'string')
-            chip.weatherTemp = temp;
-        if (typeof label === 'string')
-            chip.weatherLabel = label;
-    }
-    return chip;
-}
-/**
- * Parse `/maps/preview/passiveassist` JSON payload.
- *
- * POI chips live at root[7] as a single chip tuple or an array of tuples.
- * Stub responses omit index 7 and only carry cache metadata at root[1].62.
- */
-export function extractPassiveAssistChips(data) {
-    const chipBlock = safeGet(data, 7);
-    const chips = [];
-    if (Array.isArray(chipBlock)) {
-        if (typeof chipBlock[1] === 'string') {
-            const chip = parseChipEntry(chipBlock);
-            if (chip)
-                chips.push(chip);
-        }
-        else {
-            for (const entry of chipBlock) {
-                const chip = parseChipEntry(entry);
-                if (chip)
-                    chips.push(chip);
-            }
-        }
-    }
-    return { chips, isStub: chips.length === 0 && hasCacheMetadataMarker(data) };
-}
-//# sourceMappingURL=passiveassist.js.map

package/dist/parsers/passiveassist.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"passiveassist.js","sourceRoot":"","sources":["../../src/parsers/passiveassist.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,8FAA8F;AAC9F,SAAS,sBAAsB,CAAC,IAAY;IAC1C,MAAM,UAAU,GAAG,OAAO,CAAS,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpE,MAAM,IAAI,GAAsB,EAAE,IAAI,EAAE,CAAC;IAEzC,MAAM,QAAQ,GAAG,OAAO,CAAS,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9C,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAE3D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IAElD,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QACzD,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACtD,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC3D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,MAAM,SAAS,GAAG,OAAO,CAAU,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;YACvC,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;gBAC9B,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;gBACnC,IAAI,IAAI;oBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/parsers/review-aggregates.d.ts

@@ -1,7 +0,0 @@
-import type { PlaceUgcAggregates } from '../types/ugc-aggregates.js';
-import type { PlaceReviewRatingDistribution } from '../types/reviews.js';
-/** Convert batchexecute histogram (index 0 = 5-star) to named buckets. */
-export declare function placeAggregatesToRatingDistribution(aggregates: PlaceUgcAggregates): PlaceReviewRatingDistribution | undefined;
-/** Sum histogram buckets — should match totalCount when Google sends a complete aggregate. */
-export declare function sumRatingDistribution(dist: PlaceReviewRatingDistribution): number;
-//# sourceMappingURL=review-aggregates.d.ts.map

package/dist/parsers/review-aggregates.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-aggregates.d.ts","sourceRoot":"","sources":["../../src/parsers/review-aggregates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,qBAAqB,CAAC;AAEzE,0EAA0E;AAC1E,wBAAgB,mCAAmC,CACjD,UAAU,EAAE,kBAAkB,GAC7B,6BAA6B,GAAG,SAAS,CAW3C;AAED,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,6BAA6B,GAAG,MAAM,CAEjF"}

package/dist/parsers/review-aggregates.js

@@ -1,18 +0,0 @@
-/** Convert batchexecute histogram (index 0 = 5-star) to named buckets. */
-export function placeAggregatesToRatingDistribution(aggregates) {
-    const buckets = aggregates.ratingDistribution;
-    if (!Array.isArray(buckets) || buckets.length < 5)
-        return undefined;
-    return {
-        fiveStar: buckets[0] ?? 0,
-        fourStar: buckets[1] ?? 0,
-        threeStar: buckets[2] ?? 0,
-        twoStar: buckets[3] ?? 0,
-        oneStar: buckets[4] ?? 0,
-    };
-}
-/** Sum histogram buckets — should match totalCount when Google sends a complete aggregate. */
-export function sumRatingDistribution(dist) {
-    return dist.oneStar + dist.twoStar + dist.threeStar + dist.fourStar + dist.fiveStar;
-}
-//# sourceMappingURL=review-aggregates.js.map

package/dist/parsers/review-aggregates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-aggregates.js","sourceRoot":"","sources":["../../src/parsers/review-aggregates.ts"],"names":[],"mappings":"AAGA,0EAA0E;AAC1E,MAAM,UAAU,mCAAmC,CACjD,UAA8B;IAE9B,MAAM,OAAO,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAC9C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAEpE,OAAO;QACL,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACzB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACzB,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CAAC,IAAmC;IACvE,OAAO,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AACtF,CAAC"}

package/dist/parsers/review-client-filters.d.ts

@@ -1,8 +0,0 @@
-/**
- * Client-side review filters — anonymous Boq GET ignores server-side search/filter pb slots.
- */
-import type { ReviewsResult } from '../types/common.js';
-import type { ReviewClientFilters } from '../types/reviews.js';
-/** Apply client-side filters to parsed review rows. */
-export declare function applyReviewClientFilters(result: ReviewsResult, filters?: ReviewClientFilters): ReviewsResult;
-//# sourceMappingURL=review-client-filters.d.ts.map

package/dist/parsers/review-client-filters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"review-client-filters.d.ts","sourceRoot":"","sources":["../../src/parsers/review-client-filters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAU,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAQ/D,uDAAuD;AACvD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,aAAa,CAmBf"}