googlemaps-kit 0.1.0

package/dist/parsers/local-posts.js

@@ -0,0 +1,112 @@
+import { safeGet } from '../utils/safe-get.js';
+/** Promoted-pin ad payloads on `/maps/preview/lp` — not owner posts. */
+const AD_URL_MARKERS = ['simgad', 'googlesyndication.com', '/aclk', 'googleads', 'doubleclick.net'];
+function containsAdMarker(value) {
+    const lower = value.toLowerCase();
+    return AD_URL_MARKERS.some((marker) => lower.includes(marker));
+}
+function entryLooksLikeAd(entry) {
+    if (!Array.isArray(entry))
+        return false;
+    const stack = [entry];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (typeof node === 'string' && containsAdMarker(node))
+            return true;
+        if (Array.isArray(node)) {
+            for (const child of node)
+                stack.push(child);
+        }
+    }
+    return false;
+}
+function parsePost(entry) {
+    if (!Array.isArray(entry))
+        return null;
+    if (entryLooksLikeAd(entry))
+        return null;
+    const postId = typeof entry[0] === 'string' ? entry[0] : undefined;
+    const textBlock = entry[1];
+    let title;
+    let text;
+    if (Array.isArray(textBlock)) {
+        title = typeof textBlock[0] === 'string' ? textBlock[0] : undefined;
+        text = typeof textBlock[1] === 'string' ? textBlock[1] : undefined;
+        if (!text && typeof textBlock[0] === 'string' && textBlock[0].length > 40) {
+            text = textBlock[0];
+            title = undefined;
+        }
+    }
+    else if (typeof textBlock === 'string') {
+        text = textBlock;
+    }
+    const date = typeof entry[2] === 'string' ? entry[2] : safeGet(entry, 2, 0);
+    const media = entry[3];
+    let imageUrl;
+    if (Array.isArray(media)) {
+        const raw = media.find((m) => typeof m === 'string' &&
+            m.includes('googleusercontent.com') &&
+            !containsAdMarker(m));
+        if (typeof raw === 'string') {
+            imageUrl = raw.startsWith('//') ? `https:${raw}` : raw;
+        }
+    }
+    const ctaBlock = entry[4];
+    let ctaUrl;
+    let ctaLabel;
+    if (Array.isArray(ctaBlock)) {
+        ctaLabel = typeof ctaBlock[0] === 'string' ? ctaBlock[0] : undefined;
+        const rawCta = typeof ctaBlock[1] === 'string' ? ctaBlock[1] : undefined;
+        if (rawCta && !containsAdMarker(rawCta))
+            ctaUrl = rawCta;
+    }
+    if (ctaUrl && containsAdMarker(ctaUrl))
+        return null;
+    if (imageUrl && containsAdMarker(imageUrl))
+        return null;
+    if (!text && !title && !imageUrl)
+        return null;
+    return { postId, title, text, date, imageUrl, ctaUrl, ctaLabel };
+}
+/** Response roots whose elements are post rows (arrays), not bare strings. */
+function postListRoots(data) {
+    const roots = [];
+    if (!Array.isArray(data) || data.length === 0)
+        return roots;
+    if (Array.isArray(data[0]))
+        roots.push(data);
+    const nested = safeGet(data, 0);
+    if (Array.isArray(nested) && Array.isArray(nested[0]) && nested !== data) {
+        roots.push(nested);
+    }
+    return roots;
+}
+/**
+ * Parse `/maps/preview/localposts` response.
+ *
+ * The field layout below is INFERRED, never validated against a real payload:
+ * the endpoint answered HTTP 200 with an empty `[]` for all 118 businesses
+ * sampled across IN/US/EU/JP/AE with a warmed session. Ad rejection, by contrast,
+ * is based on real captured `/maps/preview/lp` promoted-pin rows.
+ */
+export function extractLocalPosts(data) {
+    if (!Array.isArray(data) || data.length === 0)
+        return [];
+    const posts = [];
+    for (const root of postListRoots(data)) {
+        for (const entry of root) {
+            const post = parsePost(entry);
+            if (post)
+                posts.push(post);
+        }
+    }
+    const seen = new Set();
+    return posts.filter((p) => {
+        const key = p.postId ?? `${p.title ?? ''}:${p.text?.slice(0, 40) ?? ''}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=local-posts.js.map

package/dist/parsers/local-posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-posts.js","sourceRoot":"","sources":["../../src/parsers/local-posts.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,wEAAwE;AACxE,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,uBAAuB,EAAE,OAAO,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAEpG,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,KAAK,GAAc,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,gBAAgB,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACpE,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,KAAK,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,IAAI,gBAAgB,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACnE,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,KAAyB,CAAC;IAC9B,IAAI,IAAwB,CAAC;IAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,KAAK,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,IAAI,GAAG,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,IAAI,CAAC,IAAI,IAAI,OAAO,SAAS,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC1E,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACpB,KAAK,GAAG,SAAS,CAAC;QACpB,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QACzC,IAAI,GAAG,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAS,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,QAA4B,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,KAAK,QAAQ;YACrB,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YACnC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CACvB,CAAC;QACF,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;QACzD,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,MAA0B,CAAC;IAC/B,IAAI,QAA4B,CAAC;IACjC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,QAAQ,GAAG,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,MAAM,MAAM,GAAG,OAAO,QAAQ,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,IAAI,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC;YAAE,MAAM,GAAG,MAAM,CAAC;IAC3D,CAAC;IAED,IAAI,MAAM,IAAI,gBAAgB,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,IAAI,QAAQ,IAAI,gBAAgB,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAExD,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE9C,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AACnE,CAAC;AAED,8EAA8E;AAC9E,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAW,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACzE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzD,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QACzE,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { ParsedMapsUrl } from '../types/links.js';
+/**
+ * Parse any Google Maps URL into structured identifiers for downstream SDK calls.
+ *
+ * Pure and synchronous — short links return `kind: 'shortLink'`; use
+ * {@link LinksService.resolve} to expand them first.
+ */
+export declare function parseMapsUrl(input: string): ParsedMapsUrl;
+/** Whether the URL is a short link host that requires network expansion. */
+export declare function isShortMapsLink(input: string): boolean;
+/** Validate that a string is a well-formed hex feature id (for tests and callers). */
+export declare function isValidHexFeatureId(value: string): boolean;
+/** Derive ChIJ place id from hex when possible. */
+export declare function hexToPlaceId(hexId: string): string | undefined;
+//# sourceMappingURL=maps-url.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"maps-url.d.ts","sourceRoot":"","sources":["../../src/parsers/maps-url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAIV,aAAa,EAMd,MAAM,mBAAmB,CAAC;AAsB3B;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAwCzD;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOtD;AAmRD,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAO1D;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM9D"}

package/dist/parsers/maps-url.js

@@ -0,0 +1,326 @@
+import { featureIdToLudocid, featureIdToPlaceId, parseFeatureId, placeIdToFeatureId, } from '../utils/ids.js';
+const HEX_ID_RE = /0x[0-9a-f]+:0x[0-9a-f]+/i;
+const PLACE_ID_RE = /^(ChIJ|GhIJ|EhIJ)[\w-]+$/;
+const VIEWPORT_RE = /@(-?\d+(?:\.\d+)?),(-?\d+(?:\.\d+)?),(\d+(?:\.\d+)?)(?:z|m)/;
+const FTID_RE = /!16s([^!]+)/;
+const PLACE_COORDS_RE = /!3d(-?\d+(?:\.\d+)?)!4d(-?\d+(?:\.\d+)?)/;
+const DIRECTIONS_MODE_RE = /!3e(\d)/;
+const TRAVEL_MODE_BY_CODE = {
+    0: 'driving',
+    1: 'bicycling',
+    2: 'walking',
+    3: 'transit',
+};
+/**
+ * Parse any Google Maps URL into structured identifiers for downstream SDK calls.
+ *
+ * Pure and synchronous — short links return `kind: 'shortLink'`; use
+ * {@link LinksService.resolve} to expand them first.
+ */
+export function parseMapsUrl(input) {
+    const url = normalizeInputUrl(input);
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return unknownResult(url);
+    }
+    const host = parsed.hostname.replace(/^www\./, '');
+    const shortLink = parseShortLink(parsed, url);
+    if (shortLink)
+        return shortLink;
+    const cid = parseCid(parsed, url);
+    if (cid)
+        return cid;
+    if (!isGoogleMapsHost(host)) {
+        return unknownResult(url);
+    }
+    const pathname = decodeURIComponent(parsed.pathname);
+    const list = parseListPath(pathname, url);
+    if (list)
+        return list;
+    const directions = parseDirectionsPath(pathname, parsed, url);
+    if (directions)
+        return directions;
+    const search = parseSearchPath(pathname, url);
+    if (search)
+        return search;
+    const place = parsePlacePath(pathname, parsed, url);
+    if (place)
+        return place;
+    const viewport = parseViewportOnly(pathname, url);
+    if (viewport)
+        return viewport;
+    return unknownResult(url);
+}
+/** Whether the URL is a short link host that requires network expansion. */
+export function isShortMapsLink(input) {
+    try {
+        const parsed = new URL(normalizeInputUrl(input));
+        return parseShortLink(parsed, input) != null;
+    }
+    catch {
+        return false;
+    }
+}
+function normalizeInputUrl(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return trimmed;
+    if (/^https?:\/\//i.test(trimmed))
+        return trimmed;
+    if (trimmed.startsWith('maps.app.goo.gl/') || trimmed.startsWith('goo.gl/')) {
+        return `https://${trimmed}`;
+    }
+    if (trimmed.startsWith('google.com/') || trimmed.startsWith('maps.google.com/')) {
+        return `https://${trimmed}`;
+    }
+    return trimmed;
+}
+function unknownResult(url) {
+    return { kind: 'unknown', url };
+}
+function isGoogleMapsHost(host) {
+    return (host === 'google.com' ||
+        host.endsWith('.google.com') &&
+            (host.startsWith('maps.') || host.startsWith('www.') || host === 'google.com'));
+}
+function parseShortLink(parsed, url) {
+    const host = parsed.hostname.replace(/^www\./, '');
+    if (host === 'maps.app.goo.gl') {
+        const code = parsed.pathname.replace(/^\//, '').split('/')[0];
+        if (!code)
+            return null;
+        return { kind: 'shortLink', url, code, host: 'maps.app.goo.gl' };
+    }
+    if (host === 'goo.gl' && parsed.pathname.startsWith('/maps/')) {
+        const code = parsed.pathname.slice('/maps/'.length).split('/')[0];
+        if (!code)
+            return null;
+        return { kind: 'shortLink', url, code, host: 'goo.gl' };
+    }
+    return null;
+}
+function parseCid(parsed, url) {
+    const cid = parsed.searchParams.get('cid');
+    if (!cid || !/^\d+$/.test(cid))
+        return null;
+    const host = parsed.hostname.replace(/^www\./, '');
+    if (host === 'maps.google.com') {
+        return { kind: 'cid', url, cid };
+    }
+    if (host === 'google.com' && parsed.pathname.startsWith('/maps')) {
+        return { kind: 'cid', url, cid };
+    }
+    return null;
+}
+function parseListPath(pathname, url) {
+    const match = pathname.match(/\/maps\/placelists\/list\/([a-zA-Z0-9_-]+)/);
+    if (!match)
+        return null;
+    return { kind: 'list', url, listId: match[1] };
+}
+function parseDirectionsPath(pathname, parsed, url) {
+    const match = pathname.match(/^\/maps\/dir\/([^/]+)\/([^/]+)/);
+    if (!match)
+        return null;
+    const origin = decodePathSegment(match[1]);
+    const destination = decodePathSegment(match[2]);
+    const viewport = extractViewport(url);
+    const dataBlob = extractDataBlob(parsed.hash, url);
+    let mode;
+    const modeMatch = dataBlob.match(DIRECTIONS_MODE_RE);
+    if (modeMatch) {
+        const code = Number(modeMatch[1]);
+        mode = TRAVEL_MODE_BY_CODE[code];
+    }
+    return {
+        kind: 'directions',
+        url,
+        origin,
+        destination,
+        mode,
+        lat: viewport?.lat,
+        lng: viewport?.lng,
+        zoom: viewport?.zoom,
+    };
+}
+function parseSearchPath(pathname, url) {
+    const match = pathname.match(/^\/maps\/search\/([^/@]+)/);
+    if (!match)
+        return null;
+    const query = decodePathSegment(match[1]);
+    const viewport = extractViewport(url);
+    return {
+        kind: 'search',
+        url,
+        query,
+        lat: viewport?.lat,
+        lng: viewport?.lng,
+        zoom: viewport?.zoom,
+    };
+}
+function parsePlacePath(pathname, parsed, url) {
+    const match = pathname.match(/^\/maps\/place\/([^/@]+)/);
+    if (!match)
+        return null;
+    const name = decodePathSegment(match[1]);
+    const viewport = extractViewport(url);
+    const dataBlob = extractDataBlob(parsed.hash, url);
+    const ids = extractPlaceIds(dataBlob, url);
+    const placeCoords = extractPlaceCoords(dataBlob);
+    const ftid = extractFtid(dataBlob);
+    const result = {
+        kind: 'place',
+        url,
+        name: name.length > 0 ? name : undefined,
+        lat: placeCoords?.lat ?? viewport?.lat,
+        lng: placeCoords?.lng ?? viewport?.lng,
+        zoom: viewport?.zoom,
+        ...ids,
+        featureId: ftid ?? ids.featureId,
+    };
+    if (result.hexId) {
+        if (!result.placeId) {
+            result.placeId = hexToPlaceId(result.hexId);
+        }
+        if (!result.cid) {
+            try {
+                result.cid = featureIdToLudocid(result.hexId);
+            }
+            catch {
+                // hex id malformed — skip cid derivation
+            }
+        }
+    }
+    return result;
+}
+function parseViewportOnly(pathname, url) {
+    if (!pathname.startsWith('/maps/@') && !pathname.match(/^\/maps\/@-?\d/)) {
+        const atOnly = url.match(/\/maps\/@(-?\d+(?:\.\d+)?),(-?\d+(?:\.\d+)?),(\d+(?:\.\d+)?)(?:z|m)/);
+        if (!atOnly)
+            return null;
+        return {
+            kind: 'viewport',
+            url,
+            lat: Number(atOnly[1]),
+            lng: Number(atOnly[2]),
+            zoom: Number(atOnly[3]),
+        };
+    }
+    const viewport = extractViewport(url);
+    if (!viewport)
+        return null;
+    const beforeAt = pathname.split('/@')[0] ?? '';
+    if (beforeAt !== '/maps' && beforeAt !== '/maps/') {
+        return null;
+    }
+    return {
+        kind: 'viewport',
+        url,
+        lat: viewport.lat,
+        lng: viewport.lng,
+        zoom: viewport.zoom,
+    };
+}
+function decodePathSegment(segment) {
+    return decodeURIComponent(segment.replace(/\+/g, ' '));
+}
+function extractViewport(url) {
+    const match = url.match(VIEWPORT_RE);
+    if (!match)
+        return null;
+    return {
+        lat: Number(match[1]),
+        lng: Number(match[2]),
+        zoom: Number(match[3]),
+    };
+}
+function extractDataBlob(hash, url) {
+    const fromHash = hash.replace(/^#/, '');
+    if (fromHash.includes('data=')) {
+        const dataIdx = fromHash.indexOf('data=');
+        return fromHash.slice(dataIdx);
+    }
+    const dataMatch = url.match(/data=([^&?#]+)/);
+    return dataMatch ? `data=${dataMatch[1]}` : url;
+}
+function extractPlaceIds(dataBlob, url) {
+    const result = {};
+    const hexMatches = [
+        ...dataBlob.matchAll(/!1s(0x[0-9a-f]+:0x[0-9a-f]+)/gi),
+        ...url.matchAll(/!1s(0x[0-9a-f]+:0x[0-9a-f]+)/gi),
+    ];
+    for (const m of hexMatches) {
+        result.hexId = m[1];
+        break;
+    }
+    if (!result.hexId) {
+        const looseHex = dataBlob.match(HEX_ID_RE) ?? url.match(HEX_ID_RE);
+        if (looseHex)
+            result.hexId = looseHex[0];
+    }
+    const placeIdMatches = [
+        ...dataBlob.matchAll(/!1s((?:ChIJ|GhIJ|EhIJ)[^!&]+)/g),
+        ...url.matchAll(/!1s((?:ChIJ|GhIJ|EhIJ)[^!&]+)/g),
+    ];
+    for (const m of placeIdMatches) {
+        const candidate = decodeURIComponent(m[1]);
+        if (PLACE_ID_RE.test(candidate)) {
+            result.placeId = candidate;
+            if (!result.hexId) {
+                try {
+                    const hexFromPlace = placeIdToFeatureId(candidate);
+                    if (hexFromPlace !== '0x0:0x0') {
+                        result.hexId = hexFromPlace;
+                    }
+                }
+                catch {
+                    // not a decodable place id for our protobuf subset
+                }
+            }
+            break;
+        }
+    }
+    return result;
+}
+function extractPlaceCoords(dataBlob) {
+    const match = dataBlob.match(PLACE_COORDS_RE);
+    if (!match)
+        return null;
+    return { lat: Number(match[1]), lng: Number(match[2]) };
+}
+function extractFtid(dataBlob) {
+    const match = dataBlob.match(FTID_RE);
+    if (!match)
+        return undefined;
+    const decoded = decodeURIComponent(match[1]);
+    if (decoded.startsWith('/g/') || decoded.startsWith('/m/')) {
+        return decoded;
+    }
+    if (decoded.includes('%2Fg%2F') || decoded.includes('%2Fm%2F')) {
+        return decodeURIComponent(decoded);
+    }
+    return decoded.startsWith('/') ? decoded : `/${decoded}`;
+}
+/** Validate that a string is a well-formed hex feature id (for tests and callers). */
+export function isValidHexFeatureId(value) {
+    try {
+        parseFeatureId(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Derive ChIJ place id from hex when possible. */
+export function hexToPlaceId(hexId) {
+    try {
+        return featureIdToPlaceId(hexId);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=maps-url.js.map

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

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

package/dist/parsers/panorama.d.ts

@@ -0,0 +1,24 @@
+import type { PanoramaMetadata, PanoramaRef } from '../types/panorama.js';
+/**
+ * Detect the ~74-byte photometa stub Google returns for invalid/expired pano ids.
+ *
+ * The stub echoes the id at `$[1][0][1][1]` but leaves indices 2–6 null — unlike a
+ * rich response which populates tile, address, attribution and navigation blocks.
+ */
+export declare function isPanoramaMetadataStub(data: unknown): boolean;
+/**
+ * Parse panoramas out of a `/maps/photometa/ac/v1` coverage tile.
+ *
+ * Coverage tiles are the more dependable lat/lng entry point: listentityphotos is abuse
+ * throttled and mixes user photos into its results, whereas a tile returns only official
+ * Street View panoramas with coordinates. Entries live at `$[1][1][i]`, with the id under
+ * `[0][0][1]` and the position under `[0][2][0]`.
+ */
+export declare function extractCoveragePanoramas(data: unknown): PanoramaRef[];
+/** Parse `$[0][i]` entries from listentityphotos. */
+export declare function extractNearbyPanoramas(data: unknown): PanoramaRef[];
+/** Parse full photometa payload; returns null for stub / not-found responses. */
+export declare function extractPanoramaMetadata(data: unknown, options?: {
+    raw?: boolean;
+}): PanoramaMetadata | null;
+//# sourceMappingURL=panorama.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panorama.d.ts","sourceRoot":"","sources":["../../src/parsers/panorama.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,gBAAgB,EAChB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAkB9B;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAS7D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,CAsBrE;AAED,qDAAqD;AACrD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,EAAE,CAuBnE;AA8CD,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAC1B,gBAAgB,GAAG,IAAI,CA6CzB"}

package/dist/parsers/panorama.js

@@ -0,0 +1,161 @@
+import { buildThumbnailUrl } from '../rpc/panorama-pb.js';
+import { safeGet } from '../utils/safe-get.js';
+function asNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+}
+function asString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function formatCaptureDate(year, month) {
+    if (typeof year !== 'number' || typeof month !== 'number')
+        return undefined;
+    const mm = String(month).padStart(2, '0');
+    return `${year}-${mm}`;
+}
+/**
+ * Detect the ~74-byte photometa stub Google returns for invalid/expired pano ids.
+ *
+ * The stub echoes the id at `$[1][0][1][1]` but leaves indices 2–6 null — unlike a
+ * rich response which populates tile, address, attribution and navigation blocks.
+ */
+export function isPanoramaMetadataStub(data) {
+    const block = safeGet(data, 1, 0);
+    if (!Array.isArray(block))
+        return true;
+    for (const idx of [2, 3, 4, 5, 6]) {
+        if (block[idx] != null)
+            return false;
+    }
+    return asString(safeGet(block, 1, 1)) != null;
+}
+/**
+ * Parse panoramas out of a `/maps/photometa/ac/v1` coverage tile.
+ *
+ * Coverage tiles are the more dependable lat/lng entry point: listentityphotos is abuse
+ * throttled and mixes user photos into its results, whereas a tile returns only official
+ * Street View panoramas with coordinates. Entries live at `$[1][1][i]`, with the id under
+ * `[0][0][1]` and the position under `[0][2][0]`.
+ */
+export function extractCoveragePanoramas(data) {
+    const tiles = safeGet(data, 1, 1);
+    if (!Array.isArray(tiles))
+        return [];
+    const results = [];
+    for (const entry of tiles) {
+        if (!Array.isArray(entry))
+            continue;
+        const panoId = asString(safeGet(entry, 0, 0, 1));
+        if (!panoId)
+            continue;
+        results.push({
+            panoId,
+            lat: asNumber(safeGet(entry, 0, 2, 0, 2)),
+            lng: asNumber(safeGet(entry, 0, 2, 0, 3)),
+            heading: asNumber(safeGet(entry, 0, 2, 2, 0)),
+            thumbnailUrl: buildThumbnailUrl({ panoId }),
+        });
+    }
+    return results;
+}
+/** Parse `$[0][i]` entries from listentityphotos. */
+export function extractNearbyPanoramas(data) {
+    const list = safeGet(data, 0);
+    if (!Array.isArray(list))
+        return [];
+    const results = [];
+    for (const item of list) {
+        if (!Array.isArray(item))
+            continue;
+        const panoId = asString(safeGet(item, 0));
+        if (!panoId)
+            continue;
+        results.push({
+            panoId,
+            thumbnailUrl: asString(safeGet(item, 6, 0)),
+            lng: asNumber(safeGet(item, 8, 0, 1)),
+            lat: asNumber(safeGet(item, 8, 0, 2)),
+            heading: asNumber(safeGet(item, 8, 1, 0)),
+            pitch: asNumber(safeGet(item, 8, 1, 1)),
+        });
+    }
+    return results;
+}
+function parsePanoramaLink(linkNode) {
+    const panoId = asString(safeGet(linkNode, 0, 1));
+    if (!panoId)
+        return undefined;
+    return {
+        panoId,
+        lat: asNumber(safeGet(linkNode, 2, 0, 2)),
+        lng: asNumber(safeGet(linkNode, 2, 0, 3)),
+        heading: asNumber(safeGet(linkNode, 2, 1, 0)),
+    };
+}
+function parseHistoricalCaptures(data) {
+    const list = safeGet(data, 1, 0, 5, 0, 8);
+    if (!Array.isArray(list))
+        return [];
+    const captures = [];
+    for (const entry of list) {
+        const year = asNumber(safeGet(entry, 1, 0));
+        const month = asNumber(safeGet(entry, 1, 1));
+        if (year == null || month == null)
+            continue;
+        captures.push({ year, month });
+    }
+    return captures;
+}
+function parseTileSizes(data) {
+    const zoomLevels = safeGet(data, 1, 0, 2, 3, 0);
+    if (!Array.isArray(zoomLevels))
+        return undefined;
+    const sizes = [];
+    for (const level of zoomLevels) {
+        const width = asNumber(safeGet(level, 0, 0));
+        const height = asNumber(safeGet(level, 0, 1));
+        if (width == null || height == null)
+            continue;
+        sizes.push([width, height]);
+    }
+    return sizes.length > 0 ? sizes : undefined;
+}
+/** Parse full photometa payload; returns null for stub / not-found responses. */
+export function extractPanoramaMetadata(data, options) {
+    if (isPanoramaMetadataStub(data))
+        return null;
+    const panoId = asString(safeGet(data, 1, 0, 1, 1));
+    if (!panoId)
+        return null;
+    const maxWidth = asNumber(safeGet(data, 1, 0, 2, 2, 0));
+    const maxHeight = asNumber(safeGet(data, 1, 0, 2, 2, 1));
+    const faceWidth = asNumber(safeGet(data, 1, 0, 2, 3, 1, 0));
+    const faceHeight = asNumber(safeGet(data, 1, 0, 2, 3, 1, 1));
+    const linksList = safeGet(data, 1, 0, 5, 0, 3, 0);
+    const links = [];
+    if (Array.isArray(linksList)) {
+        for (let i = 1; i < linksList.length; i++) {
+            const link = parsePanoramaLink(linksList[i]);
+            if (link)
+                links.push(link);
+        }
+    }
+    const metadata = {
+        panoId,
+        lat: asNumber(safeGet(data, 1, 0, 5, 0, 1, 0, 2)),
+        lng: asNumber(safeGet(data, 1, 0, 5, 0, 1, 0, 3)),
+        captureDate: formatCaptureDate(safeGet(data, 1, 0, 6, 7, 0), safeGet(data, 1, 0, 6, 7, 1)),
+        copyright: asString(safeGet(data, 1, 0, 4, 0, 0, 0, 0)),
+        attribution: asString(safeGet(data, 1, 0, 4, 1, 0, 0, 0)),
+        address: asString(safeGet(data, 1, 0, 3, 2, 0, 0)),
+        tileSizes: parseTileSizes(data),
+        maxTileDimensions: maxWidth != null && maxHeight != null ? [maxWidth, maxHeight] : undefined,
+        tileFaceSize: faceWidth != null && faceHeight != null ? [faceWidth, faceHeight] : undefined,
+        links,
+        historicalCaptures: parseHistoricalCaptures(data),
+    };
+    if (options?.raw) {
+        metadata.raw = data;
+    }
+    return metadata;
+}
+//# sourceMappingURL=panorama.js.map